跳轉到主要內容
一個開源、自架的個人 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，因此自動路由器為 orcarouter/orcarouter/auto。
  • 預設代理名稱為 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-* 推理模型）， 它就會按上游設定進行思考。