前置条件
安装
1
获取你的 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 块添加到 你可以只保留所需的 providers,也可以保留全部四个,以便使用
~/.openclaw/openclaw.json 中: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 密钥通过 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 提供商没有配置或认证错误

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