OpenClaw 的 61 架构里LLM 层是最容易被低估的一格。Pi Agent 在前头把记忆、用户请求和 Prompt 组装成一次推理调用Gateway 在后头管鉴权、管上下文、管路由中间这一格接谁整条链路的手感就跟着变。想让它接一条不用分头维护各家地址的通道TaoToken 是不少开发者会选的做法打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建 Key把模型 Base URL 填成 https://taotoken.net/apiPi Agent 的推理请求就收敛到同一个出口。这次改动只落在 LLM 层Gateway 的路由表、Channel 的消息格式、远端节点那批 WebSocket 长连接一行都不用碰。原文把 OpenClaw 从 Channel 一路拆到 Studio拆到 LLM 那一格时只留下一句「本地 Qwen 或云端 Claude」云端那半边的 Key 从哪来、地址填什么没往下写。这篇补的就是这一层一条能复制的接入路径加一套跑通之后能自己核对的检查方法。整个过程不需要重读一遍源码只要认准三个字段——base_url、api_key、model。1. 61 架构里为什么只动 LLM 层就够1.1 Channel、Gateway、Pi Agent 各自守着的边界Channel 是耳朵和嘴。它寄生在微信、Telegram、钉钉这类 IM 里把收到的消息统一转成内部 JSON再交给 Gateway。Gateway 是心脏维护与远端节点的 WebSocket 长连接管着结构化记忆——临时对话落 SQLite检索知识进 Vector DB用户上传的文档进文件柜——再决定一条指令是分发出去还是留在本机执行。Pi Agent 是大脑的业务层按 ReAct 模式把记忆、请求和 Prompt 拼成一次调用递给 LLM。这三层的接口是稳定的。LLM 那一格只负责逻辑推演换成谁上面三层看到的都是一次普通的推理返回不需要知道后面连的是哪家。所以接入配置的改动面天然就被限制在这一格里面。1.2 分头维护厂商地址问题会先在 Pi Agent 上露头本地 Qwen 和云端模型同时开着的时候麻烦不在模型本身在地址和凭据。本地要一个 endpoint云端要一个 endpoint今天换模型明天调参数配置文件里就长出第二套、第三套字段。Pi Agent 每加一条推理路径Gateway 的配置就要跟着动一次。把 Base URL 统一到 https://taotoken.net/api 之后OpenClaw 侧只剩一组凭据。换模型时改的是模型 ID 那个字段不是地址。Gateway 的路由逻辑照旧跑变的是它下游那个 LLM 客户端指向的出口。这就像给一栋楼改总进线各层的配电箱不用重拉只是电从哪来变了。1.3 这次不碰的三个敏感区原文提到 Pi Agent 内部的 Factory 机制会根据工具命中频率自动提权也提到 Gateway 和 Local Node 目前跑在同一个 Node.js 进程里社区的方向是引入 Sidecar 把执行挪进独立容器。这两块都属于推理链路之外的治理和执行域跟本次接入没有关系。另外远端节点上跑的个性化 Skill、本地节点上的通用 Skill靠的是 Gateway 的 Skill 路由表不是模型地址。凡是涉及「谁去执行」的逻辑这轮配置都不需要重新审视。2. 动手前先把 Key 和两个地址分清楚2.1 在控制台建一把 YOUR_API_KEY先打开 TaoToken注册登录之后进控制台创建一把 API Key。复制出来丢进密码管理器别直接粘在聊天记录里。本文所有示例中它都写成 YOUR_API_KEY这个占位符的作用是提醒你真 Key 不要提交进 Git也不要写进会同步到公共仓库的 dotfile。如果你同时要给 Codex、Claude Code 之类的工具用同一把 Key也建议在这里统一创建、统一管理后面轮换的时候只改一处不会漏掉某个角落里的旧配置。2.2 落地页管注册接口地址管推理这里有两个地址很容易混用途地址说明注册、建 Key、看模型广场、查用量https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end给人点的浏览器打开填进 OpenClaw 的 Base URLhttps://taotoken.net/api给程序调的末尾不带 /v1常见错误是把第一个地址填进 base_url 字段结果 Pi Agent 拿回来的是一段 HTML然后在解析阶段报一个跟网络毫无关系的错。记住一句浏览器里点的是落地页配置文件里写的是 https://taotoken.net/api。3. OpenClaw 模型配置里base_url 那一行怎么改3.1 环境变量写法三个键就够如果你的 OpenClaw 是用环境变量注入模型参数的改的就是下面这三个值。键名以你本地版本自带的示例为准核心是让 base_url 指向统一入口而不是沿用某个厂商的官方域名。# OpenClaw 启动前注入或写进 .env 再 source OPENCLAW_LLM_BASE_URLhttps://taotoken.net/api OPENCLAW_LLM_API_KEYYOUR_API_KEY OPENCLAW_LLM_MODELYOUR_MODEL_ID改完之后确认一件事Gateway 进程启动时能读到这三行。systemd、pm2、docker compose 各有各的注入方式只要别出现「配置文件改了但进程读到的是旧环境变量」这种情况就行。3.2 配置文件写法字段名对照本地版本如果你用的是配置文件而不是环境变量结构大致是模型层下面挂一组连接参数。下面这段是字段示意键名请对照你本地 OpenClaw 版本的示例配置别原样照抄一个不属于你那个版本的 schema。{ llm: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: YOUR_API_KEY, model: YOUR_MODEL_ID } }值得强调的是 base_url 的写法到 /api 为止。多一个 /v1或者反过来少写一段路径都会让请求落到不存在的端点上。Provider 字段选兼容 OpenAI 协议的那一类即可OpenClaw 对这类协议的支持是最通用的。3.3 模型 ID 从模型广场取不要凭记忆写YOUR_MODEL_ID 这个位置该填什么以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场当时列出的 ID 为准。不要凭印象拼一个带日期后缀的名字也不要拿别处抄来的字符串直接填进去——模型名对不上时服务端返回的通常是一句语焉不详的报错排查起来比网络问题还费时间。建议的做法是先在模型对话页面上用同一把 Key 发一条测试消息确认这个模型 ID 确实可用再把它写进 OpenClaw 的配置。这样能提前把「Key 的问题」和「模型名的问题」分开省掉一轮来回试。4. Gateway 路由照旧这些部分确认不动4.1 Channel 与结构化记忆Channel 层的职责是把 IM 消息转成内部 JSON这件事跟模型走哪条通道无关。记忆的存放位置也不变临时对话还在 SQLite检索知识还在 Vector DB文档还在文件柜。Gateway 判断一条指令该本地执行还是转发远端靠的是 Skill 路由表不是模型端点。配置改完之后你可以随手发一条普通对话验证一下如果 Channel 收到了回复说明 JSON 转换、Gateway 鉴权、Pi Agent 组装、LLM 推理、回推消息这一整条链路是通的。4.2 Skill 路由表与远端节点远端节点那批 WebSocket 长连接同样不受影响。手机上发一句「帮我截一张办公室那台机器的屏幕」走的还是 Gateway 查路由表、下发指令、远端执行、图片回传这一套。中间唯一变化的是Pi Agent 判断该调用 screenshot 工具的那次推理请求发往了统一入口。注意这个边界OpenClaw 能执行的是它自己那套 Skill 体系里的动作模型地址改的是推理环节不会让任何工具突然获得新权限。4.3 Studio 里对一次请求链路Studio 是治理和可观测那一层平时看的是 Agent 状态、日志流、文件变动和函数耗时。改完配置之后这里是第一个能看出差异的地方如果 LLM 调用开始报错日志里会先出现连接层的异常而不是工具执行层的异常。反过来也成立如果 Studio 里显示工具调用正常、只是模型回复慢那说明配置是通的问题在别处不要急着回去改 base_url。5. Pi Agent 不通的时候按这四类报错排5.1 401 与 403Key 没生效这一类最常见的原因是 Key 没被进程读到。检查顺序是配置文件或 .env 里是否确实写了 YOUR_API_KEY 对应的真值、启动用户是否有权限读这个文件、容器场景下环境变量是否透传进去。还有一种情况是 Key 建好之后被删除或轮换过本地还留着旧值。5.2 404地址尾部多写了 /v1或者填成了落地页如果响应是 404 或路径不存在的提示先看 base_url 那一行。正确写法是 https://taotoken.net/api末尾不带 /v1同时确认没有把浏览器用的落地页地址填进去。这两种错误的表现很像但日志里请求路径会暴露答案。5.3 模型名不匹配用的是列表里没有的 ID模型 ID 拼错、或者用了别处抄来但当前不可用的名称会表现为请求被拒。回去对照模型广场的当前列表改用同一把 Key 在模型对话里先验证一次。5.4 改完没重启旧进程还握着老地址配置改完不重启Gateway 里的 LLM 客户端还会用启动时读到的旧值。这是最容易被忽略的一类尤其是在用守护进程管理工具的情况下。重启之后再去 Studio 看新的请求记录。6. 跑通之后去控制台对一下这次调用配置生效、Pi Agent 能正常回话之后回 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentopenclaw_usage 看一眼用量确认这次 OpenClaw 的调用确实记在了你这把 Key 下面。如果能对上说明鉴权和路由都是通的接下来就可以放心让它跑自动化任务了。想先手动试几个模型可以直接开 模型对话用同一把 Key 发消息如果 OpenClaw 要长期挂着跑去 Coding Plan 看看额度档位是否合适Key 的轮换和新建都在 控制台 API Keys 里完成。配好之后别急着加新工具先让它在原有 Skill 上稳定跑两天再考虑扩场景。