跳转到主要内容
使用 CometAPI 作为 OpenClaw 的模型提供商——一个 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
在引导过程中，如果你想手动配置 CometAPI，请在 Model/Auth 步骤中选择 Skip。完成引导后，确认 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 或密钥管理工作流注入了 COMETAPI_KEY，请跳过这一步 —— 下方配置无论变量是如何设置的，都会使用 $\{COMETAPI_KEY\}。
4

配置 CometAPI provider

CometAPI 支持 四种 API 格式。向 ~/.openclaw/openclaw.json 添加一个或多个 provider 配置块：
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" }]
      }
    }
  }
}
你可以只保留所需的 provider，也可以保留全部四个，以便通过 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 会通过 $\{COMETAPI_KEY\} 环境变量从 models.providers.*.apiKey 解析。只有在你希望针对多个 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 将主 model 解析为 cometapi-claude/your-claude-model-id，并且不会出现 CometAPI provider 的 missing-auth 警告
  • openclaw models list --provider cometapi-claude 会列出你已配置的模型
  • openclaw doctor 不会报告任何与 CometAPI provider 相关的配置或认证错误
显示 CometAPI provider 已完成认证的 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 配置之前重新运行引导：
openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon
这会移除所有本地配置、会话、日志、认证状态和工作区。然后再次按照步骤 3–5 操作。