OpenClaw 安装教程（Windows）

本页介绍在 Windows 上手动安装 OpenClaw 并接入 AI通道，使用 PowerShell（建议以管理员身份运行）。

0. 前置：Node.js 22+

node --version

低于 v22.0.0 请先参考 Node.js Windows 安装指南 升级。

1. 安装 OpenClaw

执行上游官方的 PowerShell 安装脚本：

iwr -useb https://openclaw.ai/install.ps1 | iex

安装完成后验证：

openclaw --version
openclaw doctor

2. 初始化（Onboard）

首次使用需要执行初始化命令，把本地守护进程装好：

openclaw onboard --install-daemon

向导中按以下方式选择：

• On boarding mode：Manual
• Model auth provider：Skip for now（我们自己写 JSON）
• How do you want to hatch your bot：Local，端口保持默认的 18789
• 其他选项保持默认即可

3. 配置 OpenClaw（接入 AI通道）

3.1 配置文件在哪

%USERPROFILE%\.openclaw\openclaw.json

3.2 获取 AI通道 Key

在 aitongdao.com 的「令牌」菜单创建 API Key，按使用场景选择分组（Claude 用 claude/ccmax，GPT 用 codex，Gemini 用 gemini）。

3.3 一键写入配置文件

下面的 PowerShell 命令会生成一份同时配置 OpenAI 与 Anthropic 两个 provider 的 openclaw.json（请替换两处 sk-你的密钥）：

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.openclaw" | Out-Null

$config = @'
{
  "models": {
    "mode": "merge",
    "providers": {
      "openai": {
        "baseUrl": "https://ai.aitongdao.com/v1",
        "api": "openai-responses",
        "apiKey": "sk-你的密钥",
        "models": [
          { "id": "gpt-5", "name": "GPT-5" }
        ]
      },
      "anthropic": {
        "baseUrl": "https://aitongdao.com",
        "apiKey": "sk-你的密钥",
        "models": [
          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-6"
      }
    }
  }
}
'@
Set-Content -Path "$env:USERPROFILE\.openclaw\openclaw.json" -Value $config -Encoding UTF8

3.4 配置解释

可用模型表：

id	name
gpt-5	GPT-5
claude-sonnet-4-6	Claude Sonnet 4.6
gemini-2.5-pro	Gemini 2.5 Pro

关键点：OpenAI provider 的 baseUrl 带 /v1 且必须设置 api: "openai-responses"；Anthropic provider 的 baseUrl 不带 /v1，不需要 api 字段。agents.defaults.model.primary 用 provider/model-id 的形式指定默认模型。

4. 重启网关并验证

openclaw gateway restart
openclaw status
openclaw doctor
openclaw dashboard

dashboard 默认打开 http://localhost:18789，可在界面里发一条测试消息。

5. 如何切换模型

要换模型只需修改 agents.defaults.model.primary 的值，比如切换到 GPT-5：

"primary": "openai/gpt-5"

保存文件后执行 openclaw gateway restart。

常见问题

• command not found：重新打开 PowerShell 窗口；或检查 %USERPROFILE%\.openclaw\bin 是否在 PATH。
• 配置写入失败：用户目录带中文时 PowerShell 有概率报错，改用记事本手动创建 JSON 文件即可。
• 网关启动失败：openclaw doctor 查看诊断；常见原因是端口 18789 被其他进程占用，netstat -ano | findstr 18789 查看后修改配置或关闭占用进程。
• API 调用失败：401 一般是 apiKey 错误或分组不匹配；404 通常是 OpenAI provider 的 baseUrl 少写了 /v1。
• 端口冲突：如果一定要换端口，修改 onboard 时设置的守护进程端口并重启。