OpenClaw + 88API ，5 分钟搭建本地 AI 网关配置教程（含中转站实战）

你是不是也遇到过这种情况AI 接口时好时坏、切换供应商就要改代码、多个 Key 分散在各处调试时还看不到统一日志。这不是你“配置能力不够”而是架构层缺了一层“本地网关”。一旦补上这层稳定性、可维护性和扩展性会一起提升。这篇教程会带你用OpenClaw CC Switch搭建一个可长期复用的本地 AI 中转架构。目标很明确一次配置后续换渠道不改业务代码。这套方案能解决什么问题在项目里直接连官方 API通常会出现 4 个高频痛点网络抖动明显跨境链路不稳超时和重试增多渠道管理分散多个供应商 Key 难统一维护切换成本过高换渠道就要改base_url、鉴权和环境变量排障效率低缺少统一日志入口不容易定位问题对应地CC Switch负责“渠道管理层”OpenClaw负责“本地网关层”。前者管供应商后者统一对外接口。如果你还没有稳定渠道可先准备一个兼容 OpenAI 格式的 Key例如 88API。架构先看懂请求是怎么走的业务代码并不直接连外部渠道而是统一发到本地你的应用 - OpenClaw(127.0.0.1:18789) - CC Switch 默认供应商 - 上游模型这样做的好处是业务层只认一个本地地址渠道切换在 CC Switch 完成OpenClaw 提供统一监控与转发到这里你可以记住一句话OpenClaw 稳定“入口”CC Switch 稳定“出口”。Step 0准备清单2 分钟开始前确认这 4 项已安装 Node.js建议 18.x已安装 CC Switch至少一个可用供应商 API Key本机可用端口示例用18789验证 Node 与 npmnode -v npm -v看到版本号即可继续。Step 1安装并设置 CC Switch渠道层1.1 下载与安装从 Release 页面下载安装包https://github.com/farion1231/cc-switch/releases按系统选择对应版本安装后启动 CC Switch。1.2 添加自定义供应商进入供应商管理点击“添加供应商”填写供应商名称如88API中转、备用渠道AAPI Base URL如https://api.88api.shopAPI Key对应渠道密钥保存后你会在列表里看到新供应商。1.3 设置默认渠道关键在供应商列表中选择主用渠道点击“设为默认”。这个动作决定 OpenClaw 的默认转发出口。建议现在就配置一个“备用供应商”。后面任一渠道异常时你可以秒切不影响业务请求。Step 2安装 OpenClaw 并初始化网关层2.1 全局安装 OpenClawnpm install -g openclawlatest安装完成后验证版本openclaw --version2.2 运行初始化向导openclaw onboard根据提示依次完成选择 Chat 模式选择默认模型关联 CC Switch 的供应商配置如果某些选项无特殊要求可直接回车使用默认值。但涉及渠道映射的步骤请按你在 CC Switch 中的配置准确填写。到这里网关和渠道已经“打通”。Step 3启动 Gateway 并连通性验证3.1 启动本地网关openclaw gateway --port 18789成功后OpenClaw 会监听127.0.0.1:18789。你的应用后续统一将请求发往这个地址即可。3.2 打开 Web 控制台浏览器访问http://127.0.0.1:18789/你可以看到请求日志渠道状态可用模型列表这一步建议立刻做一次真实调用确认日志可见、响应正常。Step 4在业务代码里使用统一入口把你原来的上游地址替换为本地网关地址base_url http://127.0.0.1:18789/v1之后你再切换供应商只需要在 CC Switch 中改默认渠道。应用代码和部署配置可以保持不变。这就是“接口层与业务层解耦”的实际价值。进阶不重启服务也能动态切换渠道当主渠道不稳定、模型不可用或成本波动时打开 CC Switch选择另一个供应商点击“设为默认”切换会立即生效OpenClaw 无需重启。如果你希望减少多账号维护成本可以把聚合渠道作为主入口例如 88API再保留 1~2 个备用出口形成“主用 兜底”结构。常见问题FAQQ1openclaw gateway提示端口占用怎么办换一个端口启动即可openclaw gateway --port 18790并同步更新你应用中的base_url端口。Q2CC Switch 已添加供应商但 OpenClaw 识别不到先确认 CC Switch 正常运行。然后重新执行openclaw onboard检查渠道映射是否正确。Q3接口返回 401通常是哪类问题优先排查 API Key是否填写错误是否复制了前后空格渠道是否已过期或权限不足Q4切换渠道后请求仍走旧渠道先看 CC Switch 中“默认供应商”是否真的变更。再到 OpenClaw 控制台查看最新请求日志确认路由是否更新。总结这套组合为什么值得长期用你今天完成的不是一次“临时配置”而是一次可复用的接口架构升级。核心收益有三点稳定本地统一入口降低外部链路波动影响灵活渠道切换在 CC Switch 完成业务代码无感可运维OpenClaw 控制台让排障和监控更直接如果你正在做多模型应用、AI 工具链或 SaaS 集成建议把这套OpenClaw CC Switch作为默认基建模板。下一步你可以做两件事新增一个备用供应商验证“故障切换”流程给团队沉淀一份统一base_url规范避免项目各自为战当入口统一后你的迭代速度会明显提升。