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

指南范围与前置条件