OpenClaw配合CC switch自定义中转站配置教程
官方入口:OpenClaw 官网下载与安装 · CC-Switch 中文官网下载
适用范围:OpenClaw 引导与 CC-Switch 提供商设置配合使用。
版本与验证:2026-09-28 核对本文配置项、步骤和资料入口,补齐验证与排错说明。未在真实账号中验证付费模型调用。
配置速查
| 配置项 | 填写内容 | 注意事项 |
|---|---|---|
| CC-Switch 提供商 | apizt | 先保存并选中该提供商。 |
| OpenAI 兼容地址 | https://api.apizt.com/v1 | 选择 OpenAI 协议时使用。 |
| API Key | apizt API Key | 确认 OpenClaw 引导读取的是目标提供商。 |
| Gateway 本地地址 | http://127.0.0.1:18789/ | 管理入口,不是模型 API。 |
还没有 API Key?注册获取免费体验额度 · 已注册:进入控制台创建 API Key
为此工具单独创建令牌,并设置合理额度和模型权限。截图中的模型仅作示例,以账号当前可用模型为准;不要公开密钥或上传含密钥的配置文件。
OpenClaw配合CC switch自定义中转站配置
第一步:安装CC switch
1. 下载CC Switch并安装
下载地址:下载CC Switch
2. 配置CC Switch
添加供应商(中转站)
第二步:安装openclaw与基础初始化
首先确保你已经安装了 Node.js 环境,然后在终端执行:
1. 全局安装:
npm install -g openclaw@latest
2. 执行引导(根据提示完成基础设置):
openclaw onboard
Chat 配置引导示例:红框标注的地方为需要选择的地方
第三步:检查并启动
1. 启动 Gateway 服务:
openclaw gateway --port 18789
2. 访问控制台: 打开浏览器访问 http://127.0.0.1:18789/
保存提供商并核对实际配置
CC-Switch 添加提供商时选择与 OpenClaw 一致的协议。OpenAI 兼容基础地址为 https://api.apizt.com/v1,填写令牌并选定可用模型。完成 onboard 后核对 OpenClaw 实际读取的 provider、baseUrl 与模型;CC-Switch 列表中出现提供商不代表 OpenClaw 已切换。
验证 Gateway 与模型调用
Gateway 启动后访问 18789 管理入口,使用引导输出的管理认证信息登录。它是本地控制台,不是 apizt 模型 API。发送短消息,分别检查 Gateway 日志和网关调用记录。
怎样确认配置已生效
- 引导选择的提供商与 CC-Switch 记录一致。
- Gateway 可启动,短消息有模型调用记录。
接入失败时逐项检查
| 现象 | 检查与处理 |
|---|---|
| OpenClaw 仍使用旧提供商 | 检查引导结果和 OpenClaw 实际配置,不以 CC-Switch 列表显示为唯一证据。 |
| Gateway 未运行 | 先查看 OpenClaw 启动日志,处理端口占用或配置解析错误。 |
| 本地管理页要求认证 | 使用引导生成的管理凭据,不能填 apizt API Key 代替。 |
资料与下一步
遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID,联系支持时先隐藏 API Key。