CometAPI × OpenClaw

配置
OpenClaw，
透過 CometAPI

將 CometAPI 用作 OpenClaw 的自訂模型提供商：一個 API，500+ 模型，最高可享 20% 折扣。本指南與當前 OpenClaw 引導流程（2026.3.8+）保持同步，涵蓋安裝、提供商設定、驗證及模型切換。

~/.openclaw/openclaw.json

# 僅供參考——請在生產環境前根據您的 OpenClaw 版本驗證
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
      }
    }
  }
}

00 — 從這裡開始

指南範圍
與前置條件

指南概覽

透過 CometAPI 配置 OpenClaw

將 CometAPI 用作 OpenClaw 的自訂模型提供商，透過一個 API 存取 500+ 模型，支援路由最高享受 20% 折扣。本頁面遵循當前 OpenClaw 引導流程（2026.3.8+）。

OpenClaw 文件閘道設定

前置條件

需要 Node.js >= 22 和 CometAPI API 金鑰。對於常駐程式安裝，請將 COMETAPI_KEY 存放在 ~/.openclaw/.env 中，以便 openclaw.json 透過 ${COMETAPI_KEY} 引用而無需硬式編碼。

CometAPI 文件

快速指令

openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

printf 'COMETAPI_KEY=%s\n' 'your_cometapi_key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env

新增 ~/.openclaw/.env 或編輯提供商設定後，使用 openclaw gateway restart重啟一次，然後執行診斷。在所有指令和工作階段中使用完整的 provider/model 引用。版本升級後請重新檢查設定參考.

01 — 提供商設定說明

為什麼一個 CometAPI 金鑰
需要三個提供商

基於 API 格式的提供商路由

OpenClaw 按 API 相容性（而非僅供應商標籤）進行路由，因此需要為 openai-completions、anthropic-messages 和 google-generative-ai 分別設定提供商。

單一金鑰，多提供商設定

保持單一 COMETAPI_KEY，在 cometapi-openai、cometapi-claude 和 cometapi-google 區塊中複用。所有地方均使用完整的 provider/model 引用。

當前流程驗證

執行一次引導程式，在變更後重啟閘道，然後透過 models status、provider 範圍的 models list 和 doctor 診斷進行驗證。

02 — 接入 OpenClaw

安裝、引導、設定、
驗證、切換

版本感知說明

OpenClaw 使用 ~/.openclaw/openclaw.json 作為您編輯的來源設定檔。自訂提供商將被實體化為每個 agent 的 models.json 檔案，位於 ~/.openclaw/agents/<agentId>/下。升級後請使用設定參考和環境變數指南重新檢查金鑰和行為。CometAPI 的 base URL 僅以即時文件中的定義為準。

01 安裝或更新 OpenClaw

推薦：curl -fsSL https://openclaw.ai/install.sh | bash。或者如果您保持全域 npm 安裝，使用 npm install -g openclaw@latest。

02 執行一次引導程式

執行：openclaw onboard --install-daemon。在 Model/Auth 中選擇 Skip 進行基礎安裝，除非需要否則保持預設工作區，讓精靈完成常駐程式和健康檢查。

03 存放 COMETAPI_KEY

對於常駐程式安裝，將 COMETAPI_KEY 附加到 ~/.openclaw/.env 並執行 chmod 600。如果您已有 shell/服務金鑰工作流程，繼續使用即可。

04 在 openclaw.json 中新增 CometAPI 提供商

新增 cometapi-openai（openai-completions）、cometapi-claude（anthropic-messages）和 cometapi-google（google-generative-ai），然後將 primary 設為 cometapi-claude/claude-sonnet-4-6。

05 重啟並驗證

執行 openclaw gateway restart，然後執行 openclaw models status、openclaw models list --provider cometapi-claude 和 openclaw doctor。CometAPI 提供商不應出現設定架構/驗證錯誤。

06 使用 provider/model 切換模型

使用 openclaw models set cometapi-claude/claude-sonnet-4-6 設定預設模型。在對話中，透過 /model cometapi-openai/gpt-5.4 或 /model cometapi-google/gemini-3.1-pro-preview 切換。

07 選用：全新重新安裝

如果在修復舊的損壞安裝，請停止閘道，刪除 ~/.openclaw，重新執行引導程式，然後重新套用 CometAPI 設定。這將重置本地設定、工作階段、記錄和驗證狀態。

設定片段（合併到 openclaw.json）

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
      }
    }
  }
}

基礎設定無需手動建立 auth-profiles.json。在提供商中使用 ${COMETAPI_KEY} ，並透過 ~/.openclaw/.env、shell 或服務管理器注入變數。

03 — 參考定價

即時費率以
CometAPI 官網為準

下表使用的是示意性的每百萬 token 價格。模型目錄、折扣和 SLA 以 CometAPI 文件與主控台當前顯示的資料為準。

模型（範例）	輸入 / 1M tokens	輸出 / 1M tokens	備註
Claude Opus 4.6	$4.00	$20.00	來自參考資料
MiniMax-M2.7	$0.24	$0.96	來自參考資料
GLM 5 Turbo	$0.96	$3.26	來自參考資料
GPT-5.4 pro	$24.00	$144	來自參考資料
Gemini 3.1 Pro	$1.60	$9.60	來自參考資料
qwen3.5-plus	$0.32	$1.92	來自參考資料

使用成本說明

根據每百萬 token 費率估算，對比示意性「官方渠道」參考——僅供理解，不作為價格保證。請以 CometAPI 官網的即時定價為準。

費率已與文件同步

輸入定價

$4.00 / 1M

輸出定價

$20.00 / 1M

自動讀取所選模型設定

CometAPI（1M 輸入 + 1M 輸出）

$24.00

官方參考（相同用量）

$30.00

示意性節省

$6.00

約低於參考價 20%（示意）

04 — 常見問題

整合前請先
查看這些問題

此設定需要 auth-profiles.json 嗎？

基礎設定不需要。OpenClaw 可以透過 ${COMETAPI_KEY} 從 models.providers.*.apiKey 解析提供商 apiKey。僅在需要按配置文件存放金鑰或金鑰輪換時才使用 auth-profiles.json。

為什麼一個供應商需要 3 個提供商條目？

OpenClaw 按 API 格式相容性路由。如果需要全部三個 API 系列，請為 openai-completions、anthropic-messages 和 google-generative-ai 保持獨立條目。

設定實際在哪裡編輯和實體化？

編輯 ~/.openclaw/openclaw.json。自訂提供商在同步/載入後會實體化為 ~/.openclaw/agents/<agentId>/ 下每個 agent 的 models.json。

本指南使用哪些模型 ID？

gpt-5.4、claude-sonnet-4-6 和 gemini-3.1-pro-preview。您可以將 CometAPI 模型頁面上的任意模型新增到對應的提供商區塊中。

相關連結

配置OpenClaw，透過 CometAPI

指南範圍與前置條件