My Docs

Appearance

OpenClaw 配置教程（完整版） ​

文档位置：docs/openclaw/index.md
站点路径：/openclaw/

本文覆盖：

  • OpenClaw 如何安装（可复制命令）
  • openclaw.json 放置位置（默认路径 + 强制指定方式）
  • 必须使用 Responses（openai-responses）格式
  • 安装困难时：启动 Codex，让模型把 .codex 的 API 配置写入 OpenClaw（Responses 格式）

1) 安装 OpenClaw（推荐命令） ​

OpenClaw 需要 Node.js 22+。Windows 环境建议优先使用 WSL2（更省心）。

macOS / Linux / WSL2 ​

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

Windows（PowerShell） ​

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

安装完成后自检：

bash
openclaw --version
openclaw doctor
openclaw status
openclaw dashboard

2) openclaw.json 放置位置（非常重要） ​

配置文件名固定为：openclaw.json。

默认建议放在（这样升级/重装不影响配置）：

  • Linux/macOS/WSL2：~/.openclaw/openclaw.json
  • Windows（不走 WSL2 时）：建议仍按“用户主目录 + .openclaw”放置

如果你不想放默认位置，请用环境变量强制指定（最不容易踩坑）：

  • OPENCLAW_CONFIG_PATH：配置文件路径（推荐）

示例（PowerShell）：

powershell
$env:OPENCLAW_CONFIG_PATH = \"C:\\\\path\\\\to\\\\openclaw.json\"
openclaw doctor

3) 必须使用 Responses（response 格式） ​

你要接入 OpenAI 的 Responses 协议时，配置里必须是：

  • api: "openai-responses"

你可以直接复制仓库根目录的示例配置作为起点：openclaw.json（再按下面步骤改 Key）。

外部案例配置下载（示例文件）：

下面这段只是配置的核心片段（最小示例），用于说明关键字段；并不是完整配置，单独使用可能无法直接运行：

json
{
  "models": {
    "mode": "merge",
    "providers": {
      "codex-vip": {
        "baseUrl": "https://api-vip.codex-for.me/v1",
        "apiKey": "clp_your_key_start_here",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5.2",
            "name": "gpt-5.2"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "codex-vip/gpt-5.2"
      }
    }
  }
}

默认可先使用 https://api-vip.codex-for.me/v1。如果你觉得响应偏卡，建议改成 https://hello.vangularcode.asia/v1，这是 AWS CDN 优化节点，通常更快；香港线路可选 https://api-hk.codex-for.me/v1。

4) 一定要改你自己的 Key ​

请务必把 apiKey 从占位符改成你自己的真实 Key：

  • apiKey: "clp_your_key_start_here"

另外，如果你启用了网关鉴权，也请同时修改你的 gateway.auth.token，不要沿用示例值。

5) 安装困难时：启动 Codex，让模型把 .codex 的 API 配置写入 OpenClaw（Responses） ​

如果 OpenClaw 配不顺（Node/权限/路径各种问题），先启动 Codex CLI，然后告诉模型把用户目录 .codex 的 API 配置写入 openclaw.json。

步骤：

  1. 启动 Codex CLI：codex
  2. 输入这句话给模型：
txt
请把用户目录下.codex api 配置到openclaw中，注意是response格式。

保存后用 openclaw doctor 自检。