如果你正在用 OpenClaw 做日常开发助手，又不希望只绑定单一模型厂商，把它接到 CCSub 中转是最省事的做法之一。CCSub 提供 OpenAI 兼容与 Anthropic 原生两套入口，OpenClaw 只需要改一个 Base URL、填一个 API Key，就能在同一次会话里切换 gpt-5.6-sol、claude-sonnet-4-6 这类模型。
这篇教程只讲一件事：从零把 OpenClaw 接上 CCSub，并且确认第一次对话真的跑通了。全部配置项都基于 CCSub 真实文档（安装配置 / 注册与充值）。
开始之前：准备三样东西
- 一个可用的 CCSub 账号，并且已经完成充值。API Key 只有在账户有余额时才能正常发起请求。
- 一把 CCSub API 密钥，格式类似
sk-你的CCSub密钥。如果还没有，去控制台创建，见 注册与充值。 - 本地已经装好 OpenClaw 的版本。不同版本的配置项名称略有差异，下面会给出常见字段位置。
提示：API Key 请当作密码对待。不要写进会提交到 Git 的配置文件，也不要贴进公开的 issue 或截图里。
第一步：创建一个 API Key
- 登录 CCSub 控制台，进入 API 密钥页面。
- 新建一把密钥，建议命名为
openclaw，方便以后按客户端区分。 - 复制生成的密钥，形如
sk-你的CCSub密钥。页面关闭后一般不再完整显示，先存到密码管理器里。
如果你同时还在用 Cursor、Cherry Studio 或 Claude Code，可以先共用同一把 Key 跑通流程，后面再拆分。共用的注意事项见下文「多客户端共用一把 Key 的注意事项」。
第二步：填写 Base URL
这是最容易出错的一步。CCSub 暴露了多个入口，用途各不相同，填错就会出现 404 或连接失败。
OpenAI 兼容模式（推荐先试）
- Base URL：
https://ccsub.xyz/v1 - 聊天补全端点：
https://ccsub.xyz/v1/chat/completions - 模型列表端点：
https://ccsub.xyz/v1/models
在 OpenClaw 的模型供应商配置里，把 provider 设为 OpenAI 兼容类型，Base URL 填 https://ccsub.xyz/v1，API Key 填上一步生成的 sk-你的CCSub密钥。多数客户端会在 Base URL 后自动拼接 /chat/completions，所以不要再手动多写一层 /v1。
Claude 原生模式
- Base URL：
https://ccsub.xyz/api - Messages 端点：
https://ccsub.xyz/api/v1/messages
这个入口走 Anthropic Messages 协议。如果你的 OpenClaw 版本对 Claude 系列支持更好（例如更完整地透传 reasoning 相关参数），用这个入口会更稳。配置时 Base URL 填 https://ccsub.xyz/api，客户端会自动请求 /v1/messages，不需要你自己拼路径。
Codex 原生模式
- Base URL：
https://ccsub.xyz/openai - Responses 端点：
https://ccsub.xyz/openai/responses
如果你希望 OpenClaw 按 Codex 的方式工作，使用这个入口并把 wire API 设为 responses。Codex 会自动请求 /responses，而不是 /chat/completions，这一点和 OpenAI 兼容模式不同，切换入口时记得同步改 wire API。
# 概念示意，字段名以你的 OpenClaw 版本为准
provider = openai-compatible
base_url = https://ccsub.xyz/v1
api_key = sk-你的CCSub密钥
# 若使用 Codex 原生模式
base_url = https://ccsub.xyz/openai
wire_api = responses第三步：选择模型
不要凭记忆写模型 ID。CCSub 支持的模型会变动，正确做法是先查列表：
curl https://ccsub.xyz/v1/models \
-H "Authorization: Bearer sk-你的CCSub密钥"返回里出现过的 ID 才是当前可用的。常见选择：
- 通用代码与长文本：
gpt-5.6-sol。它也是 CCSub 平台上近 30 天调用量最高的模型之一，适合大多数 OpenClaw 日常任务。 - 偏 Anthropic 风格的任务：
claude-sonnet-4-6，在写作、代码解释、结构化输出上表现均衡。 - 更重的推理任务：
claude-opus-4-6或gpt-6-astra，单价更高，建议只在确实需要时切换。 - 高频轻量任务：
claude-haiku-4-5，适合格式整理、简单补全这类短请求。
在 OpenClaw 里，模型通常配置在 provider 下的 models 或默认模型字段中。把模型 ID 填成上面查到的字符串即可，不要写成展示名（例如「Claude Sonnet 4.6」）。
第四步：验证首次对话
配置完成后，不要直接跑复杂任务。先用一句话测试：
用一句话说明你当前使用的模型是什么。成功的标志是：有正常文本返回，且没有报 401、404 或超时。如果这一步就失败，先看下一节的排查顺序，不要急着改模型。
常见错误与排查顺序
- 401 / 未授权：Key 复制不完整、前后有空格，或账户余额不足。重新复制
sk-你的CCSub密钥并确认已充值。 - 404 / not found：Base URL 多写或少写了一段。OpenAI 兼容是
https://ccsub.xyz/v1，Claude 原生是https://ccsub.xyz/api，Codex 原生是https://ccsub.xyz/openai，三者别混用。 - 连接失败 / connect_error：本地网络或代理干扰。先确认能直接访问
https://ccsub.xyz/v1/models。 - 空回复：请求发出去了但没内容返回。先换一个模型 ID 重试，排除模型不可用；再检查是否把输出长度压得太低。
- 模型不可用：说明该 ID 当前不可调，用
/v1/models重新核对。
更细的症状对照可以看 CCSub 的 故障排查 页面。
多客户端共用一把 Key 的注意事项
OpenClaw 常常不是唯一在用 CCSub 的工具。共用一把 Key 时注意：
- 用量无法按客户端区分。想看清各部分消耗，就按客户端各建一把 Key，例如
openclaw、cursor、cherrystudio。 - Base URL 要分别配。同一把 Key 在不同客户端里可能走不同入口，改动只对你当前编辑的那个客户端生效。
- 并发上限是共享的。多个客户端同时跑大批量请求时，排队和超时会一起出现。
- 轮换成本高。一旦某把共用 Key 泄漏，所有客户端都要重新配置，所以从一开始就分开更省事。
成本与充值提醒
CCSub 按 input / output / 缓存读写分别计费，不同模型差价明显。以官方给出的单价为例，gpt-5.6-sol 与 claude-sonnet-4-6 属于同一档位，而 claude-opus-4-6、gpt-6-astra 明显更贵。OpenClaw 这类代理风格的工具很容易在单次任务里反复调用模型，Token 消耗会比手动对话高不少。
建议：
- 先用中档模型（
gpt-5.6-sol、claude-sonnet-4-6）跑通并观察一天的实际用量。 - 只在对结果质量有明确要求时切到高价位模型。
- 定期在控制台查看 Token 明细，具体方法见 入门使用手册。
接下来做什么
如果首次对话已经成功，说明 OpenClaw 与 CCSub 已经打通。下一步可以：
- 到 API 参数与推理能力 了解哪些参数会被透传、哪些会被忽略。
- 把不同用途拆成多把 Key，方便按项目核算成本。
- 遇到报错先查 常见问题，绝大多数配置类问题都在里面。
CCSub API 调用方法
如果你使用 OpenAI 兼容客户端，把 Base URL 设置为 https://ccsub.xyz/v1，API Key 使用控制台创建的 sk-你的CCSub密钥。
export OPENAI_BASE_URL=https://ccsub.xyz/v1
export OPENAI_API_KEY=sk-你的CCSub密钥Codex 请使用原生 Responses 专用地址。先设置密钥：
export CCSUB_API_KEY=sk-你的CCSub密钥再在 ~/.codex/config.toml 配置自定义 provider：
model = "gpt-5.6-sol"
model_provider = "ccsub"
[model_providers.ccsub]
name = "CCSub"
base_url = "https://ccsub.xyz/openai"
env_key = "CCSUB_API_KEY"
wire_api = "responses"Claude Code 使用专用 Messages Base URL：
export ANTHROPIC_BASE_URL=https://ccsub.xyz/api
export ANTHROPIC_AUTH_TOKEN=sk-你的CCSub密钥需要确认当前可用模型时，可以请求 GET https://ccsub.xyz/v1/models。正式长任务前，建议先用短请求验证 Key、余额和模型是否正常。