在Windows上安装OpenClaw

在Windows上部署OpenClaw，硬件门槛不算高，但为了流畅运行，内存部分建议留足余量。具体要求如下：

CPU：≥2核心 。核心数越多，处理多任务时表现越好。
内存：最低要求≥4GB，但强烈建议8GB或以上 。如果只是简单对话，4GB勉强够用；若要执行文件整理、浏览器自动化等任务，16GB会是更流畅的选择。
磁盘空间：需预留≥20GB的可用空间。这主要用来存放OpenClaw本身、依赖库、Docker镜像以及它操作和生成的各类文件。
操作系统：建议使用 Windows 10/11 专业版或企业版，并安装最新系统补丁。通过WSL2（Windows Subsystem for Linux 2）来运行，是目前在Windows上使用OpenClaw最主流的方式。

光有硬件还不够，运行OpenClaw还需要准备好以下软件环境：

核心运行环境：
- Node.js：版本必须 ≥ 22 。
- Python：版本需要 3.9 或更高（推荐3.10或3.11）。
- Docker：强烈建议安装 Docker Desktop。官方会用它来为高风险指令创建安全的沙箱运行环境，防止误操作损害你的系统。
- Git：用于拉取代码和管理“技能”插件。
- Visual Studio 2022 社区版：如需进行开发或调试，推荐安装此环境，并勾选“使用C++的桌面开发”工作负载。
网络配置：OpenClaw需要调用云端的大模型API（如OpenAI、阿里云百炼等），因此需要确保你的Windows系统可以稳定访问这些境外或指定的云端服务。在企业内网或使用代理时，需要提前配置好。

OpenClaw在Windows上的详细安装流程主要分为环境准备、一键安装、初始化配置和启动服务四个阶段。

在正式开始前，请确保你的电脑满足我们上次讨论的硬件要求，并完成以下基础环境的配置。请务必以管理员身份打开PowerShell来执行所有命令。

检查并安装Node.js：
OpenClaw需要Node.js 18.0.0及以上版本（推荐22+）。在PowerShell中输入 node --version 查看版本。如果未安装或版本过低，请访问 Node.js官网下载LTS版本安装。
解锁PowerShell执行权限（如首次运行脚本）：
复制并运行以下命令，为当前会话解锁权限，避免后续安装报错：
```
Set-ExecutionPolicy Bypass -Scope Process -Force
```

环境准备好后，就可以用官方脚本进行一键安装了。

运行安装命令：
在管理员PowerShell中，复制并粘贴以下命令之一后回车：
- 官方脚本（推荐）：
```
iwr -useb https://openclaw.ai/install.ps1 | iex
```
  - 如果你想安装最新的测试版，可以使用 & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta 。
- 国内镜像（如果官方脚本下载慢或失败）：
```
iwr -useb https://clawd.org.cn/install.ps1 | iex
```
等待安装完成：
脚本会自动下载并安装OpenClaw及其依赖，通常需要5-10分钟，取决于你的网络速度。安装完成后，可以运行 openclaw --version 验证是否成功。

安装成功后，安装脚本通常会自动进入配置向导。如果中途退出或想重新配置，可以随时运行 openclaw onboard。

这个向导会问你几个关键问题，请根据下表进行选择和填写：

配置步骤	你的选择与输入	说明
风险确认	选择 `Yes`	确认了解工具的强大功能与潜在风险。
安装模式	选择 `QuickStart`	快速开始模式，适合大多数用户。
AI模型提供商	按需选择 (如 `OpenAI`, `Google Gemini`)	如果你有云端API密钥，可直接选择。若想使用本地模型（如通过Ollama），请拉到列表最后选择 `Custom Provider` 。
输入API密钥	粘贴你的API Key	从你选择的模型提供商（如OpenAI、阿里云百炼）官网获取并粘贴。
选择具体模型	选择模型 (如 `gpt-4o-mini`)	根据你的API密钥权限选择一个模型。
配置通讯渠道	选择 `Skip for now`	可以稍后再配置飞书、微信等接入，以免初次配置过于复杂。
配置技能 (Skills)	选择 `No`	先完成基础运行，后续可以根据需要再添加。
安装守护进程	选择 `Yes`	这样Gateway服务就可以在后台运行，即使关掉PowerShell窗口也不会中断。

配置完成后，你需要启动核心的Gateway服务。

启动服务：
在PowerShell中运行以下命令来启动Gateway：
```
openclaw gateway start
```
检查服务状态：
运行以下命令确保服务状态为“Running”：
```
openclaw gateway status
```
访问Web控制台：
打开浏览器，访问 http://127.0.0.1:18789/。你应该能看到OpenClaw的Web管理界面。现在，你就可以在这里与你的AI助手开始对话了！

部署完成后，下面的命令能帮你更好地管理和排查问题：