OpenClaw 安装教程（Linux / WSL2）

本页介绍在 Linux 或 Windows WSL2 环境下手动安装 OpenClaw 并接入 AI通道。

0. 前置：Node.js 22+

node --version

需要 Node.js 22 或更高版本。使用 nvm 安装：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
nvm use 22

1. 安装 OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw --version
openclaw doctor

2. 初始化（Onboard）

openclaw onboard --install-daemon

向导推荐选择：

• On boarding mode：Manual
• Model auth provider：Skip for now
• How do you want to hatch your bot：Local，端口 18789

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

3.1 配置文件位置

~/.openclaw/openclaw.json

3.2 获取 AI通道 Key

在 aitongdao.com 的「令牌」页面创建 API Key，按使用场景选分组。

3.3 写入配置文件

下面是一份默认使用 GPT-5（OpenAI Responses 协议）的配置，记得替换 sk-你的密钥：

mkdir -p ~/.openclaw
cat > ~/.openclaw/openclaw.json <<'EOF'
{
  "models": {
    "mode": "merge",
    "providers": {
      "openai": {
        "baseUrl": "https://ai.aitongdao.com/v1",
        "api": "openai-responses",
        "apiKey": "sk-你的密钥",
        "models": [
          { "id": "gpt-5", "name": "GPT-5" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/gpt-5"
      }
    }
  }
}
EOF

如果你想改用 Claude，把 provider 换成 anthropic，baseUrl 改为 https://aitongdao.com（不带 /v1），删除 api 字段，并把 primary 改为 anthropic/claude-sonnet-4-6。

3.4 配置解释

• models.mode: "merge"：与 OpenClaw 内置的模型配置做合并。
• OpenAI provider 的默认 api 是 openai-responses，baseUrl 必须带 /v1。
• Anthropic provider 不需要 api 字段，baseUrl 不带 /v1。
• primary 使用 provider/model-id 的格式。

4. 重启网关并验证

openclaw gateway restart
openclaw status
openclaw doctor
openclaw dashboard

dashboard 默认地址是 http://localhost:18789。

5. 如何切换模型

编辑 ~/.openclaw/openclaw.json，在 providers 下的 models 数组里追加新条目，或修改 agents.defaults.model.primary 的值，随后执行 openclaw gateway restart。

常见问题

• command not found：确保 ~/.openclaw/bin 在 $PATH，或者重新登录 shell。
• 写入失败：ls -la ~/.openclaw 检查权限，必要时 sudo chown -R $USER:$USER ~/.openclaw。
• 端口冲突：ss -lntp | grep 18789 查看占用；可以关闭占用进程或在 onboard 阶段换一个端口。
• API 调用失败：OpenAI 协议 404 多半是 baseUrl 漏了 /v1；401 是 apiKey 或令牌分组问题，回到 aitongdao.com 检查。
• WSL2 域名解析异常：检查 /etc/resolv.conf，必要时临时加入 nameserver 1.1.1.1。