Documentation Index
Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
Use this file to discover all available pages before exploring further.
使用 CometAPI 作為 OpenClaw 的模型提供者——單一 API 即可存取 500+ 個模型。
先決條件
- Node.js ≥ 22 —— 建議透過 nvm 安裝
- 擁有啟用中 API key 的 CometAPI 帳戶 —— 在這裡取得
安裝或更新 OpenClaw
建議方式 —— 使用官方安裝程式：curl -fsSL https://openclaw.ai/install.sh | bash
npm install -g openclaw@latest
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard
儲存你的 CometAPI key
將你的金鑰寫入 ~/.openclaw/.env，讓 daemon 可以使用，而不需要將其硬編碼在設定檔中：printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
如果你已經透過 shell、service manager 或 secrets workflow 注入 COMETAPI_KEY，可略過此步驟——下方設定無論變數是如何設定的，都會使用 $\{COMETAPI_KEY\}。
設定 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" }]
}
}
}
}
provider/model 參照在不同格式間切換路由。將每個 your-...-model-id 佔位符替換為來自 CometAPI Models page 且對應該 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 keys 會透過 $\{COMETAPI_KEY\} 環境變數從 models.providers.*.apiKey 解析。只有當你想在多個金鑰之間進行每個 profile 的憑證輪替時，才需要 auth-profiles.json。
重新啟動並驗證
在加入 .env 或變更 provider 設定後，重新啟動 gateway：接著執行診斷：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 沒有設定或驗證錯誤
切換模型
切換模型
# 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
疑難排解
