OpenClaw配合CC switch自定义中转站配置教程

更新于

适用范围:OpenClaw 引导与 CC-Switch 提供商设置配合使用。

版本与验证:2026-09-28 核对本文配置项、步骤和资料入口,补齐验证与排错说明。未在真实账号中验证付费模型调用。

配置速查

配置项填写内容注意事项
CC-Switch 提供商apizt先保存并选中该提供商。
OpenAI 兼容地址https://api.apizt.com/v1选择 OpenAI 协议时使用。
API Keyapizt 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

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 日志和网关调用记录。

怎样确认配置已生效

  1. 引导选择的提供商与 CC-Switch 记录一致。
  2. Gateway 可启动,短消息有模型调用记录。

接入失败时逐项检查

现象检查与处理
OpenClaw 仍使用旧提供商检查引导结果和 OpenClaw 实际配置,不以 CC-Switch 列表显示为唯一证据。
Gateway 未运行先查看 OpenClaw 启动日志,处理端口占用或配置解析错误。
本地管理页要求认证使用引导生成的管理凭据,不能填 apizt API Key 代替。

资料与下一步

遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID,联系支持时先隐藏 API Key。