跳到主要内容

使用 OpenClaw

OpenClaw 可通过自定义 OpenAI 兼容 Provider 接入 ClawdRouter。本页使用 CLAWDROUTER_API_KEY 作为 OpenClaw 进程读取的环境变量名。

准备工作​

  • Node.js 22.22.3 或更高版本。
  • API Key。
  • OpenClaw 已安装。

1. 安装 OpenClaw​

npm install -g openclaw@latest
openclaw --version

2. 设置 API Key​

Windows PowerShell：

$env:CLAWDROUTER_API_KEY = "YOUR_API_KEY"

Linux、macOS 或 WSL：

export CLAWDROUTER_API_KEY="YOUR_API_KEY"

将 YOUR_API_KEY 替换为真实 Key。请不要将真实 Key 写入 openclaw.json。

3. 配置自定义部署地址​

创建文件 clawdrouter.patch.json5：

{
  models: {
    providers: {
      clawdrouter: {
        baseUrl: "__DOCS_API_ORIGIN__/v1",
        api: "openai-completions",
        apiKey: {
          source: "env",
          provider: "default",
          id: "CLAWDROUTER_API_KEY",
        },
        models: [
          {
            id: "YOUR_MODEL_ID",
            name: "YOUR_MODEL_ID",
          },
        ],
      },
    },
  },
}

先验证配置：

openclaw config patch --file ./clawdrouter.patch.json5 --dry-run --json

确认无误后应用配置：

openclaw config patch --file ./clawdrouter.patch.json5

4. 选择模型​

将 YOUR_MODEL_ID 替换为当前 API Key 有权限调用的模型 ID，并设置为默认模型：

openclaw models set clawdrouter/YOUR_MODEL_ID

5. 验证连接并启动​

执行最小模型探测：

openclaw models status --probe --probe-provider clawdrouter --probe-max-tokens 8 --json

启动 Gateway：

openclaw gateway run

也可启动控制台：

openclaw dashboard

常见问题​

找不到 ClawRouter 模型​

确认 CLAWDROUTER_API_KEY 已设置，并且 YOUR_MODEL_ID 已替换为当前 API Key 有权限调用的模型 ID。

401 或 403​

请重新设置 API Key，或联系管理员确认 Key 的授权范围和状态。

模型在目录中存在但无法选择​

如果配置了模型允许列表，请将列表中返回的完整模型引用加入允许列表。

探测失败​

先检查部署地址是否正确，再检查服务端和上游模型的可用状态。

相关链接​