OpenClaw

將 OpenClaw 連接到 CometAPI：透過 curl 或 npm 安裝、將金鑰儲存在 ~/.openclaw/.env、設定 OpenAI/Anthropic/Google providers，並執行 500+ 個模型。

使用 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。

   

   
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：

   Provider	API 格式	呼叫的端點	Base URL
   cometapi-openai	openai-completions	POST /v1/chat/completions	https://api.cometapi.com/v1
   cometapi-openai-responses	openai-responses	POST /v1/responses	https://api.cometapi.com/v1
   cometapi-claude	anthropic-messages	POST /messages	https://api.cometapi.com
   cometapi-google	google-generative-ai	POST /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 沒有任何設定或驗證錯誤

   
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。