OpenClaw 集成指南

• Node.js 22 或更新版本（OpenClaw 运行环境）
• 一把 KOPRouter API Key（sk- 开头）

安装 OpenClaw

在命令行执行以下命令全局安装：

npm install -g openclaw@latest

也可使用官方安装脚本：macOS / Linux 执行 curl -fsSL https://openclaw.ai/install.sh | bash，Windows 在 PowerShell 执行 iwr -useb https://openclaw.ai/install.ps1 | iex。

安装后执行 openclaw --version，能显示版本号即安装成功。

核心配置

接入 KOPRouter 需要三个参数：

• Base URL：https://koprouter.kopglobal.com/v1（KOPRouter 的 OpenAI 兼容根地址）
• API Key：你的 KOPRouter API Key（sk- 开头）
• 模型：KOPRouter 中的模型 ID，取自 /v1/models 返回的 id

方式一：写入 openclaw.json（推荐）

OpenClaw 读取用户级配置文件 ~/.openclaw/openclaw.json，把上面三个参数一次填好即可，无需其他配置。

```bash
mkdir -p ~/.openclaw
nano ~/.openclaw/openclaw.json
```

```bat
if not exist "%USERPROFILE%\.openclaw" mkdir "%USERPROFILE%\.openclaw"
notepad "%USERPROFILE%\.openclaw\openclaw.json"
```

写入以下内容（把 MODEL_ID 换成 /v1/models 返回的模型 ID）：

{
  "models": {
    "mode": "merge",
    "providers": {
      "koprouter": {
        "baseUrl": "https://koprouter.kopglobal.com/v1",
        "apiKey": "sk-...",
        "api": "openai-completions",
        "models": [
          { "id": "MODEL_ID" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "koprouter/MODEL_ID" },
      "models": { "koprouter/MODEL_ID": {} }
    }
  },
  "gateway": { "mode": "local" }
}

保存后重启 OpenClaw 生效。

方式二：openclaw onboard 交互式配置

若不想手写 JSON，可运行 OpenClaw 自带的引导命令，按提示填写即可（同样写入 openclaw.json）：

openclaw onboard

在向导中选择「Custom / OpenAI 兼容」类型的供应商，填入 https://koprouter.kopglobal.com/v1、你的 API Key 与模型 ID。

选择与切换模型

把默认模型设为 KOPRouter 中的某个模型：

openclaw models set koprouter/MODEL_ID

查看当前已配置模型的状态：

openclaw models status --plain

模型 ID 一律取自 /v1/models 返回的 id。若不指定模型，OpenClaw 会使用其内置默认模型名，若 KOPRouter 无对应模型会报「模型不存在」。

验证

openclaw config validate

能通过校验且 openclaw models status --plain 能列出模型，即说明配置正确。随后可直接发起对话测试。

常见问题

openclaw config set proxy.proxyUrl http://127.0.0.1:7890