跳转到主要内容
一个开源、自托管的个人 AI 助手。站点： https://openclaw.ai（文档： https://docs.openclaw.ai，仓库： https://github.com/openclaw/openclaw）。
协议：OpenAI 兼容
  • Base URL： https://api.orcarouter.ai/v1（必须包含 /v1）

​
安装

需要 Node 22+。安装 openclaw 命令： 
npm install -g openclaw
或在 macOS/Linux 上： 
curl -fsSL https://openclaw.ai/install.sh | bash

​
配置

编辑 ~/.openclaw/openclaw.json： 
{
  "models": {
    "mode": "merge",
    "providers": {
      "orcarouter": {
        "baseUrl": "https://api.orcarouter.ai/v1",
        "apiKey": "sk-orca-...",
        "api": "openai-completions",
        "models": [ { "id": "orcarouter/auto", "name": "OrcaRouter Auto" } ]
      }
    }
  },
  "agents": { "defaults": { "model": { "primary": "orcarouter/orcarouter/auto" } } },
  "gateway": { "mode": "local" }
}

​
运行

openclaw agent --local --agent main --session-id s1 -m "Reply with exactly: OK"
期待回复 OK。

​
注意事项

  • baseUrl 必须位于 models.providers.<name> 之下，而不是在每个模型条目内。把它放在模型上会得到 Unrecognized key: "baseUrl"。
  • base URL 保留尾部的 /v1。模型引用使用 provider/model，因此 auto 路由器是 orcarouter/orcarouter/auto。
  • 默认 agent 名称是 main（不是 default）。非交互运行请使用 --local 配合 --session-id。
  • 模型名称使用 vendor/model 格式。把 orcarouter/auto 换成具体模型，例如 anthropic/claude-opus-4.8 或 google/gemini-2.5-flash（并相应更新 primary 引用）。

​
思考 / 推理

OpenClaw 通过标准的 OpenAI 兼容 API（api: "openai-completions"）与 OrcaRouter 通信，因此推理遵循模型自身的行为——挑选一个 支持推理的模型（例如某个 anthropic/claude-* 推理模型），它就会 按上游配置进行思考。