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

曦和
0 阅读6分钟

在日常 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. 填写完成后点击「确认添加」

image.png

image.png

image.png

image.png

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

2.3 设置默认渠道

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

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

image.png

三、第二步：安装 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 中操作，代码层面完全无感知，真正实现了接口层与业务层的解耦。

avatar
文章
阅读
粉丝