Skip to main content
使用 CometAPI 作为 OpenClaw 的模型提供方——一个 API 接入 500+ 模型。

前置条件

  • Node.js ≥ 22 —— 推荐通过 nvm 安装
  • 一个拥有有效 API key 的 CometAPI 账户 —— 在这里获取

安装

1

获取你的 CometAPI API key

登录 CometAPI 控制台。点击 Add API Key 并复制你的 CometAPI API key。
显示 Add API Key 按钮的 CometAPI 控制台
包含 base URL 的 CometAPI API key 详情
2

安装或更新 OpenClaw

推荐 —— 使用官方安装器:
或通过 npm 安装:
然后运行一次设置向导:
在初始化过程中,如果你想手动配置 CometAPI,请在 Model/Auth 步骤中选择 Skip。初始化完成后,确认网关正在运行:

配置

1

存储你的 CometAPI 密钥

将你的密钥写入 ~/.openclaw/.env,这样守护进程就可以使用它,而无需将其硬编码到配置文件中:
如果你已经通过 shell、服务管理器或 secrets 工作流注入了 COMETAPI_KEY,请跳过此步骤——无论变量是如何设置的,下面的配置都会使用 $\{COMETAPI_KEY\}
2

配置 CometAPI 提供商

CometAPI 支持四种 API 格式。将一个或多个 provider 块添加到 ~/.openclaw/openclaw.json 中:
你可以只保留所需的 providers,也可以保留全部四个,以便使用 provider/model 引用在不同格式之间进行路由。将每个 your-...-model-id 占位符替换为来自 CometAPI Models page 且与对应 provider 块匹配的当前 model ID。
对于需要 OpenAI Responses API 的模型,请使用 cometapi-openai-responsesapi: "openai-responses")。对于使用经典聊天补全路径的模型,请使用 cometapi-openaiapi: "openai-completions")。两者共享相同的 baseUrlhttps://api.cometapi.com/v1);唯一的区别在于 OpenClaw 调用的是哪个下游端点。
此设置不需要 auth-profiles.json 文件。Provider 密钥通过 models.providers.*.apiKey 中的 $\{COMETAPI_KEY\} 环境变量解析。只有当你想在多个密钥之间按 profile 轮换凭据时,才需要 auth-profiles.json

验证

1

重启并验证

在添加 .env 或更改提供商配置后,重启网关:
然后运行诊断:
成功的设置应如下所示:
  • openclaw models status 会将主模型解析为 cometapi-claude/your-claude-model-id,并且不会对 CometAPI 提供商显示缺少认证的警告
  • openclaw models list --provider cometapi-claude 会列出你配置的模型
  • openclaw doctor 会报告 CometAPI 提供商没有配置或认证错误
显示 CometAPI 提供商已通过认证的 OpenClaw models status

切换模型

1

切换模型

故障排查

如果你是在修复损坏的旧安装,请先停止 gateway,删除 ~/.openclaw,然后在应用 CometAPI 配置之前重新运行引导流程:
这会删除所有本地配置、会话、日志、认证状态和工作区。然后再次按照步骤 3–5 操作。