OpenClaw+CC Switch：小白也能配置好的小龙虾（2026最新）

在日常 AI 接口开发中，很多开发者都遇到过这样的困境：直连官方 API 不稳定、延迟高，多个供应商的 Key 难以统一管理，项目切换渠道时还要频繁改代码。本文将介绍一套基于OpenClaw + CC Switch的本地 AI 网关方案，帮你用最低成本搭建一个可自定义中转站的 API 代理层，彻底解决上述痛点。

一、方案背景：为什么需要本地 AI 网关？

随着 GPT、Claude、Gemini 等大模型 API 的普及，越来越多的开发者开始在项目中集成 AI 能力。但在实际工程落地中，直接调用官方接口往往面临以下问题：

• 网络不稳定：直连海外 API 节点，超时率高，影响用户体验
• 多渠道管理混乱：同时使用多个中转站或供应商，Key 分散，难以统一维护
• 切换成本高：更换供应商时需要修改代码中的 baseURL 和认证信息
• 本地调试困难：缺乏统一的请求日志和流量监控入口

OpenClaw是一个轻量级的本地 AI Gateway 工具，支持通过统一接口代理多个 AI 供应商；CC Switch则是一个专为 AI 接口设计的渠道管理工具，支持自定义中转站配置、默认渠道切换等功能。两者配合，可以构建出一套灵活、稳定的本地 AI 接口代理体系。

二、第一步：安装并配置 CC Switch

2.1 下载安装 CC Switch

前往 CC Switch 的 GitHub Release 页面下载最新版本：

<https://github.com/farion1231/cc-switch/releases>

根据你的操作系统选择对应的安装包，完成安装后启动应用。

2.2 添加自定义供应商（中转站）

CC Switch 的核心功能是供应商管理，你可以将任意兼容 OpenAI 格式的中转站配置进来。

操作步骤如下：

1. 打开 CC Switch 主界面，进入「供应商管理」模块
2. 点击「添加供应商」按钮，填写以下信息：
   • 供应商名称：自定义，便于识别，例如88API中转
   • API Base URL：填写中转站的接口地址，例如https://api.88api.shop
   • API Key：填写你在该中转站申请的密钥
3. 填写完成后点击「确认添加」

💡小技巧：如果你有多个中转站账号，可以重复以上步骤依次添加，CC Switch 支持同时管理多个供应商并按需切换。

2.3 设置默认渠道

添加完供应商后，建议将最常用的渠道设置为默认渠道，这样 OpenClaw 在转发请求时会优先走该渠道，无需每次手动指定。

在供应商列表中找到目标供应商，点击「设为默认」即可完成配置。

三、第二步：安装 OpenClaw 并完成初始化

3.1 环境准备

OpenClaw 基于 Node.js 运行，安装前请确保本地已配置好 Node.js 环境（建议版本 ≥ 18.x）。

验证 Node.js 是否安装成功：

# 检查 Node.js 版本 node -v # 检查 npm 版本 npm -v

若输出版本号，说明环境正常，可以继续下一步。

3.2 全局安装 OpenClaw

# 全局安装最新版本的 OpenClaw npm install -g openclaw@latest

安装完成后，验证是否安装成功：

# 查看 OpenClaw 版本 openclaw --version

3.3 执行初始化引导

OpenClaw 提供了一个交互式的初始化向导，帮助你快速完成基础配置：

# 启动初始化引导 openclaw onboard

执行后，终端会进入交互式配置流程，按照提示依次完成以下设置：

• 选择 Chat 模式：根据提示选择对应的配置项（注意观察红框标注的选项）
• 配置默认模型：选择你希望默认使用的 AI 模型
• 关联 CC Switch：将 CC Switch 中配置好的供应商渠道与 OpenClaw 进行绑定

⚠️注意：onboard引导过程中，部分选项有默认值，如无特殊需求可直接回车跳过；涉及渠道选择的步骤需要根据你在 CC Switch 中配置的供应商信息进行对应填写。

四、第三步：启动 Gateway 服务并验证

4.1 启动本地 Gateway

完成初始化后，执行以下命令启动 OpenClaw 的 Gateway 服务：

# 在 18789 端口启动 Gateway 服务 openclaw gateway --port 18789

启动成功后，终端会输出服务运行状态信息。此时 OpenClaw 已在本地监听18789端口，所有发往该端口的 AI 接口请求都会经过 CC Switch 配置的渠道进行转发。

4.2 访问控制台

打开浏览器，访问以下地址进入 OpenClaw 的 Web 控制台：

<http://127.0.0.1:18789/>

控制台提供了请求日志、渠道状态、模型列表等可视化管理功能，方便你实时监控接口调用情况。

4.3 接口调用验证

Gateway 启动后，你可以用以下方式验证接口是否正常工作。以 Python 为例，使用openai官方 SDK 将base_url指向本地 Gateway：

from openai import OpenAI # 初始化客户端，指向本地 OpenClaw Gateway client = OpenAI( api_key="your-api-key-here", # 填写你的 API Key base_url="<http://127.0.0.1:18789/v1>" # 指向本地 Gateway 地址 ) # 发起一次简单的对话请求 response = client.chat.completions.create( model="gpt-4o", # 填写你在 CC Switch 中配置的模型名称 messages=[ {"role": "user", "content": "你好，请介绍一下你自己。"} ] ) # 输出响应内容 print(response.choices[0].message.content)

如果终端正常输出 AI 的回复内容，说明整套链路已经打通：你的代码 → OpenClaw Gateway → CC Switch → 中转站 → AI 模型。

五、进阶使用：多渠道动态切换

CC Switch 支持在不重启 Gateway 的情况下动态切换默认渠道，这对于以下场景非常实用：

• 渠道故障切换：当某个中转站出现异常时，快速切换到备用渠道
• 按需选择模型：不同供应商支持不同的模型，按项目需求灵活选择
• 成本控制：在多个渠道之间按价格策略分配流量

操作方式：在 CC Switch 的供应商列表中，直接点击目标供应商的「设为默认」按钮，切换立即生效，无需重启任何服务。

对于需要稳定、多模型支持的开发场景，可以考虑接入像 88API 这类聚合型中转服务，它兼容 OpenAI 接口格式，配置方式与上文完全一致，能直接复用现有的 CC Switch + OpenClaw 配置体系。

六、常见问题排查

Q：执行openclaw gateway后提示端口被占用怎么办？

更换一个未被占用的端口即可，例如：

openclaw gateway --port 18790

同时记得更新代码中的base_url端口号。

Q：CC Switch 中添加供应商后，OpenClaw 无法识别怎么办？

检查 CC Switch 是否正常运行，并确认onboard初始化时已正确关联了 CC Switch 的配置文件路径。必要时重新执行openclaw onboard完成重新绑定。

Q：接口返回 401 错误怎么办？

检查 CC Switch 中对应供应商的 API Key 是否填写正确，注意避免前后多余的空格字符。

总结

通过CC Switch + OpenClaw的组合，开发者可以用极低的配置成本在本地搭建起一套完整的 AI 接口代理层。整个流程核心只有三步：配置 CC Switch 中转站 → 初始化 OpenClaw → 启动 Gateway。后续无论是切换供应商、新增渠道还是调整模型，都只需在 CC Switch 中操作，代码层面完全无感知，真正实现了接口层与业务层的解耦。