在用 OpenClaw 搭建自己的 AI 助手时很多人都会遇到一个现实问题官方模型很好用但价格不便宜。与此同时市面上出现了大量「OpenAI 协议兼容」的中转服务、代理服务和低价模型平台价格往往只有官方的一半甚至更低。那么能不能让 OpenClaw 直接走这些中转 API享受低价模型的同时保持原有体验答案是可以而且配置起来并不复杂。这篇文章会手把手带你在 OpenClaw 中接入一个「OpenAI 协议兼容」的中转 API让它变成一个新的模型提供方后续在任何 Agent / 会话中都能像用官方模型一样调用它。说明文中以通用的「OpenAI 协议兼容中转」为例比如常见的第三方代理、自建中转、国内云厂商的兼容接口等。只要对方支持/v1/chat/completions这一套协议基本都可以照这个思路接入。一、什么是「中转 API」为什么要接入中转 API本质上就是一个代理层它对外暴露与 OpenAI 类似的接口比如POST https://your-proxy.example.com/v1/chat/completions Authorization: Bearer sk-xxxxxx Content-Type: application/json请求格式也是标准的 Chat Completions{ model: gpt-4o-mini, messages: [ { role: user, content: 你好帮我写一段文案 } ] }而中转服务内部可以是转发到官方 OpenAI但价格更低团购 / 批发 / 共享额度转发到其它云厂商的模型DeepSeek、各种国产大模型等转发到自建模型本地部署 / 私有化部署为什么要接入中转降本同样的模型能力价格更低灵活可以把不同厂商的模型统一接到一个中转OpenClaw 只需适配一次可控中转层可以做审计、过滤、限流、日志分析等二、OpenClaw 对接中转的核心思路OpenClaw 的模型配置大致可以理解为三层Provider提供方比如openai、anthropic、gemini、local等具体模型例如gpt-4.1、gpt-4o-mini等模型别名alias给复杂的 providermodel 起一个好记的名字比如cheap-gpt要把中转接进来核心思路是在配置中新增一个「OpenAI 协议兼容」的 Provider例如my_proxy给它设置baseUrl你的中转服务地址apiKey中转服务的 API 密钥建议放环境变量models声明可用模型列表在aliases里给这些模型起别名例如cheap-gpt后续在对话 / Agent / Skill 里只需要写model: cheap-gpt即可三、准备工作从中转服务拿到这三样东西在配置 OpenClaw 之前你需要从中转平台确认以下信息Base URL接口地址常见形式https://your-proxy.example.com/v1https://api.xxx.com/v1有的可能是https://your-proxy.example.com/proxy/openai/v1注意中转文档里路径是否已经包含/v1。API Key一般形如sk-xxxxxxxxxxx或一个自定义 token大多数情况使用Authorization: Bearer API_KEY这个标准写法。模型名称比如gpt-4o-minigpt-4.1-minideepseek-chat或者平台自定义的模型名这个名字要和中转文档中写的一致后面会用到。四、在 OpenClaw 中增加中转 Provider提示不同版本的 OpenClaw 配置文件路径可能略有区别请以你本地的实际情况为准。一般可以通过openclaw gateway config.get查看当前配置结构。1. 先把中转 API Key 放到环境变量推荐不建议把密钥直接写死在配置文件里更安全的做法是使用环境变量。例如在运行 OpenClaw 的 shell / systemd / Docker 环境中export MY_PROXY_API_KEY你的中转服务 API Key如果你是用 systemd可以在 service 文件里加一行EnvironmentMY_PROXY_API_KEY你的中转服务 API KeyDocker 则可以在docker-compose.yml里配置environment。2. 使用 config.patch 增量更新配置推荐做法推荐用 OpenClaw 自带的config.patch方式而不是直接整文件覆盖这样风险更小。假设你创建一个proxy-models.json文件内容如下示例{ models: { providers: { my_proxy: { kind: openai-compatible, baseUrl: https://your-proxy.example.com/v1, apiKey: env:MY_PROXY_API_KEY, models: { cheap-gpt: { name: gpt-4o-mini, maxTokens: 16000 } } } }, aliases: { cheap-gpt: my_proxy/cheap-gpt } } }配置说明my_proxy这是你给中转服务起的 provider 名称可以自定义kind: openai-compatible告诉 OpenClaw 这是一个 OpenAI 协议兼容的服务baseUrl中转的接口地址注意是否带/v1apiKey: env:MY_PROXY_API_KEY从环境变量中读取密钥models.cheap-gpt.name实际发给中转的模型名比如gpt-4o-minialiases.cheap-gpt定义一个别名之后你只用cheap-gpt这个名字即可保存后在终端执行openclaw gateway config.patch --file proxy-models.json成功后Gateway 会自动重启新的模型配置就生效了。五、在 OpenClaw 中实际使用中转模型配置完成后你就可以像使用其它模型一样使用cheap-gpt这个别名1. 在聊天 / 命令里切换模型如果你用的是命令式切换视你实际使用的 UI 而定可能类似/model cheap-gpt然后再输入你的问题OpenClaw 就会通过中转服务调用对应模型。2. 在 Agent 或 Skill 配置中指定在某个 Agent 配置或 Skill 中把model字段改成{ model: cheap-gpt }这样这个 Agent 默认就走中转模型了。六、常见问题与排错思路1. 报错401 / 403 未授权排查步骤确认中转后台的 API Key 是否复制正确有没有多空格、少字符。确认中转服务的文档是否要求通过Authorization: Bearer xxx传递有些服务会要求用自定义 Header比如X-API-Key: xxx这种情况需要在 OpenClaw 的 provider 配置中增加自定义 header参考官方文档。确认环境变量是否正确注入到运行 OpenClaw 的进程中你在 shell 里设置的export如果是通过 systemd 启动的 OpenClaw可能不会生效需要改 service 文件。2. 报错404 / 405 / 500404 / 405通常是 URL 路径错了检查中转文档要求的具体路径是不是/v1/chat/completions有的中转需要写成https://xxx.com/proxy/openai/v1而不是https://xxx.com/v1500通常是中转服务内部错误查看中转服务日志或者尝试用 curl / Postman 直接调中转接口进行对比测试。3. 报错模型不存在 / 模型名不识别确认models.my_proxy.models.cheap-gpt.name填写的模型名和中转平台文档一致。有的平台模型名可能是deepseek-chat、gpt-4.1-mini-2025-01-01这种需要原样填入。七、进阶玩法多个中转 按场景切换如果你不止有一个中转服务还可以在 OpenClaw 里给不同中转配置不同别名然后按场景选择模型。例如{ models: { providers: { my_proxy_fast: { kind: openai-compatible, baseUrl: https://fast-proxy.example.com/v1, apiKey: env:FAST_PROXY_KEY, models: { fast-gpt: { name: gpt-4o-mini, maxTokens: 16000 } } }, my_proxy_cheap: { kind: openai-compatible, baseUrl: https://cheap-proxy.example.com/v1, apiKey: env:CHEAP_PROXY_KEY, models: { ultra-cheap: { name: gpt-4o-mini, maxTokens: 16000 } } } }, aliases: { fast-gpt: my_proxy_fast/fast-gpt, ultra-cheap: my_proxy_cheap/ultra-cheap } } }使用策略可以是重要任务、需要更稳定响应的用fast-gpt日常闲聊、生成初稿、批量任务用ultra-cheap这样既能保证关键场景的稳定又最大程度压低整体成本。八、安全与成本小建议密钥一定要用环境变量或秘密管理不要写死在 Git 仓库里。可以在中转服务层做请求限速防止脚本错误导致暴涨费用日志记录方便排错内容过滤敏感内容处理定期查看中转平台账单确认费用是否符合预期并适当调整模型选择和调用频率。九、总结这篇文章我们做了几件事说明了什么是中转 API以及为什么要在 OpenClaw 里接入它们基于「OpenAI 协议兼容」的思路在 OpenClaw 中增加了一个新的 provider通过config.patch的方式安全地把中转配置合并到现有配置里用模型别名alias让你在日常使用中只需记一个简单名字比如cheap-gpt给出了常见错误排查方法和多中转进阶用法只要你的中转服务遵循 OpenAI 的 Chat Completions 协议那么按照文中的思路基本都可以顺利接入到 OpenClaw 中实现「同样的体验更低的成本」。