跳轉到主要內容
使用 CometAPI 作為 OpenClaw 的模型 provider——在一個 API 中使用 500+ 個模型。本指南涵蓋目前的上手流程（2026.3.8+）。

​
先決條件

  • Node.js ≥ 22 — 建議透過 nvm 安裝
  • 擁有啟用中 API key 的 CometAPI 帳戶 — 在此取得
1

取得你的 CometAPI API key

登入 CometAPI 主控台。點擊 Add API Key 並複製你的 sk-xxxxx key。
顯示 Add API Key 按鈕的 CometAPI 儀表板
包含 base URL 的 CometAPI API key 詳細資訊
2

安裝或更新 OpenClaw

建議做法 — 使用官方安裝程式：
curl -fsSL https://openclaw.ai/install.sh | bash
或透過 npm 安裝：
npm install -g openclaw@latest
接著執行一次設定精靈：
openclaw onboard --install-daemon
在 onboarding 過程中，如果你想手動設定 CometAPI，請在 Model/Auth 步驟中選擇 Skip。完成 onboarding 後，確認 gateway 正在執行：
openclaw gateway status
openclaw dashboard
3

儲存你的 CometAPI key

將你的 key 寫入 ~/.openclaw/.env，讓 daemon 可以使用它，而不需要將其硬編碼在設定檔中：
printf 'COMETAPI_KEY=%s\n' 'your-sk-xxxxx-key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
如果你已經透過 shell、service manager 或 secrets 工作流程注入 COMETAPI_KEY，請跳過此步驟 — 下方設定會使用 $\{COMETAPI_KEY\}，無論這個變數是如何設定的。
4

設定 CometAPI providers

CometAPI 支援 四種 API 格式。將一個或多個 provider 區塊加入 ~/.openclaw/openclaw.json：
ProviderAPI 格式呼叫的端點Base URL
cometapi-openaiopenai-completionsPOST /v1/chat/completionshttps://api.cometapi.com/v1
cometapi-openai-responsesopenai-responsesPOST /v1/responseshttps://api.cometapi.com/v1
cometapi-claudeanthropic-messagesPOST /messageshttps://api.cometapi.com
cometapi-googlegoogle-generative-aiPOST /v1beta/...https://api.cometapi.com/v1beta
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/your-claude-model-id"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "your-chat-model-id", "name": "OpenAI-compatible text model" }]
      },
      "cometapi-openai-responses": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-responses",
        "models": [{ "id": "your-responses-model-id", "name": "Responses API model" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "your-claude-model-id", "name": "Claude family model" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "your-gemini-model-id", "name": "Gemini family model" }]
      }
    }
  }
}
你可以只保留需要的 providers，或保留全部四個，以便透過 provider/model 參照在不同格式之間切換路由。將每個 your-...-model-id 佔位符替換為 CometAPI Models 頁面 中與該 provider 區塊相符的最新 model ID。
對於需要 OpenAI Responses API 的模型，請使用 cometapi-openai-responses（api: "openai-responses"）。對於使用經典聊天補全路徑的模型，請使用 cometapi-openai（api: "openai-completions"）。兩者共用相同的 baseUrl（https://api.cometapi.com/v1）；唯一的差異是 OpenClaw 會呼叫哪個下游端點。
此設定不需要 auth-profiles.json 檔案。Provider key 會透過 models.providers.*.apiKey 從 $\{COMETAPI_KEY\} env var 解析。只有在你想針對多組 key 進行依 profile 的憑證輪替時，才需要 auth-profiles.json。
5

重新啟動並驗證

在加入 .env 或變更 provider 設定後，重新啟動 gateway：
openclaw gateway restart
接著執行診斷：
openclaw models status
openclaw models list --provider cometapi-claude
openclaw doctor
成功的設定會顯示為：
  • openclaw models status 將主要模型解析為 cometapi-claude/your-claude-model-id，且 CometAPI providers 沒有任何缺少驗證的警告
  • openclaw models list --provider cometapi-claude 會列出你已設定的模型
  • openclaw doctor 會回報 CometAPI providers 沒有任何設定或驗證錯誤
顯示 CometAPI providers 已通過驗證的 OpenClaw models status
6

切換模型

# Set the default model in config
openclaw models set cometapi-claude/your-claude-model-id

# Switch for the current chat session
/model cometapi-openai/your-chat-model-id
/model cometapi-openai-responses/your-responses-model-id
/model cometapi-claude/your-claude-model-id
/model cometapi-google/your-gemini-model-id
如果你是在修復舊版損壞的設定，請先停止 gateway、移除 ~/.openclaw，然後在套用 CometAPI 設定前重新執行 onboarding：
openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon
這會移除所有本機設定、工作階段、日誌、驗證狀態與工作區。接著再次依序執行步驟 3–5。