1. 为什么 OpenClaw 接 GLM-5-Turbo 总在“最后一公里”翻车OpenClaw 是一个把大模型接进本地工作流的开源 Agent 网关它能让你在终端 TUI、飞书、Telegram 里直接调用模型干活。GLM-5-Turbo 是智谱面向编码场景推出的高并发模型上下文窗口大、推理链完整配合“龙虾套餐”这类充值权益单位成本比按量付费低不少。把这两者接起来理论上就是填个 Base URL、贴个 API Key、写个模型名的事——但真正动手的人会发现坑几乎全集中在“端点匹配”和“验证方式”这两件事上。我见过太多人卡在同一幕配置文件改完openclaw gateway restart也跑了TUI 里敲一句hi屏幕上只回一个冷冰冰的NO没有任何报错堆栈。于是开始怀疑 Key 错了、套餐没生效、OpenClaw 不支持这个模型……实际上模型早就正常返回了只是 TUI 的渲染层没把 reasoning content 显示出来。这类“假故障”最消耗耐心也最容易让人误删配置重来。这篇 SOP 面向三类人刚买龙虾套餐想接 OpenClaw 的新手、被 401/429 反复折磨的调试者、以及想把 endpoint 统一收口到 TaoToken 通道的老用户。我会把端点为什么必须是/api/paas/v4、套餐权益和 API Key 到底谁管谁、TUI 显示 NO 时该信谁一条条拆开讲并给出可直接复制的openclaw.json片段和逐条验证命令。核心检索词就三个OpenClaw 接入、GLM-5-Turbo 配置、龙虾套餐端点。读完你至少能做到curl 一次通、日志能看到dispatch complete、换渠道能收到完整回复。先说结论避免你走弯路龙虾套餐走的是标准 OpenAI 协议端点https://open.bigmodel.cn/api/paas/v4不是 Coding Plan 那个带coding的路径API Key 是身份凭证套餐是计费方案两者缺一不可TUI 显示异常时以 curl 和日志为准别以界面为准。下面按“问题场景 → 前置准备 → 可复制配置 → 验证动作 → 报错排查 → 通道收口”的顺序展开每一步都带命令和预期结果。2. 接入前必须搞清的端点、Key 与套餐关系2.1 龙虾套餐和 Coding Plan 的端点不是同一个这是 90% 的rate limit报错的根源。网上很多旧教程会告诉你把 Base URL 写成https://open.bigmodel.cn/api/coding/paas/v4那是 GLM Coding Plan 的专用端点。龙虾套餐虽然也是智谱的服务但它走标准 OpenAI 协议通道正确端点是https://open.bigmodel.cn/api/paas/v4端点写错会发生什么鉴权和计费通道全部对不上平台识别不到你的套餐权益于是按“无有效额度”处理直接返回限流。你以为是并发太高其实是路径错了。判断方法很简单curl 时如果返回429且提示 rate limit先检查 URL 里有没有多余的coding段。2.2 API Key 是身份套餐是钱包很多人误以为买了套餐OpenClaw 会自动走某个“神秘通道”扣费不需要自己的 Key。真相是龙虾套餐本质是智谱平台内的充值权益你仍然要用自己在开放平台申请的 API Key 发起请求只是消耗的额度由套餐承担而不是个人免费额度。Key 形如xxxxxxxx.xxxxxxxxxxxx在智谱开放平台的 API Keys 管理页创建或复制。所以配置里必须同时满足两件事baseUrl指向标准端点api_key是你自己的有效 Key。缺任何一个要么 401要么 429。2.3 OpenClaw 的配置结构长什么样OpenClaw 的主配置文件在~/.openclaw/openclaw.json核心分四块auth声明 provider 和鉴权模式models定义 provider 的 baseUrl、协议类型和模型列表agents指定默认用哪个模型channels管飞书/Telegram 这类接入渠道。模型 ID 固定写glm-5-turbo协议类型写openai-completions因为智谱这个端点兼容 OpenAI 的 chat completions 格式。如果你打算把 endpoint 统一收口避免每个项目各配一套 Key可以在models.providers里把baseUrl换成 TaoToken 的统一通道Key 也换成 TaoToken 的 Key模型名保持glm-5-turbo不变。这样 OpenClaw、Cline、Codex 可以共用一套凭证排查时只看一个入口。TaoToken 的 API 地址是https://taotoken.net/apiKey 在控制台的 API Keys 页面生成。2.4 版本与前置条件OpenClaw 建议用2026.3.13或更高版本低版本对 reasoning 字段的解析不完整会加重 TUI 显示问题。检查版本openclaw --version如果低于这个版本先升级再配。另外确认本地已经能正常访问智谱开放平台网络层面没有拦截。前置条件就这三条套餐已购、OpenClaw 已装且版本达标、智谱平台有有效 Key。3. 可复制的 openclaw.json 配置与 TaoToken 通道切换3.1 直连智谱的完整配置片段打开配置文件open -e ~/.openclaw/openclaw.json把下面这段完整粘贴进去替换YOUR_ZHIPU_API_KEY为你自己的 Key。如果你没有飞书机器人把channels.feishu整段删掉即可。{ meta: { lastTouchedVersion: 2026.3.13 }, auth: { profiles: { zai:default: { provider: zai, mode: api_key } } }, models: { mode: merge, providers: { zai: { baseUrl: https://open.bigmodel.cn/api/paas/v4, api: openai-completions, apiKey: YOUR_ZHIPU_API_KEY, models: [ { id: glm-5-turbo, name: GLM-5-Turbo, reasoning: true, input: [text], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 204800, maxTokens: 131072 } ] } } }, agents: { defaults: { model: { primary: zai/glm-5-turbo }, models: { zai/glm-5-turbo: {} }, workspace: /Users/你的用户名/.openclaw/workspace, compaction: { mode: safeguard }, maxConcurrent: 4, subagents: { maxConcurrent: 8 }, sandbox: { mode: off } } }, channels: { feishu: { enabled: true, appId: 你的飞书AppID, appSecret: 你的飞书AppSecret, connectionMode: websocket } }, gateway: { mode: local } }保存后重启网关openclaw gateway restart3.2 切换到 TaoToken 统一通道如果你不想在多个工具里散落智谱 Key把models.providers.zai里的baseUrl和apiKey换成 TaoToken 的即可模型 ID 和协议类型不动zai: { baseUrl: https://taotoken.net/api, api: openai-completions, apiKey: YOUR_TAOTOKEN_API_KEY, models: [ { id: glm-5-turbo, name: GLM-5-Turbo, reasoning: true, input: [text], contextWindow: 204800, maxTokens: 131072 } ] }TaoToken 的 Key 在控制台生成地址是https://taotoken.net/api-keys。这样 OpenClaw、Cline、Codex 可以共用同一个 Base URL 和 Key出问题时只查一个入口不用在智谱和 TaoToken 之间来回切。注意切换后模型名仍然是glm-5-turbo不要改成别的别名否则 OpenClaw 找不到对应 provider。3.3 配置项逐条说明auth.profiles.zai:default里的mode: api_key表示用静态 Key 鉴权不是 OAuth。models.mode: merge表示这份配置与默认配置合并不会覆盖其他 provider。reasoning: true告诉 OpenClaw 这个模型会返回推理内容TUI 渲染时按 reasoning 处理——这也是显示 NO 的诱因之一。contextWindow和maxTokens按 GLM-5-Turbo 的实际能力填写小了会提前截断写大了可能被平台拒绝。agents.defaults.model.primary必须是zai/glm-5-turbo这种provider/model格式只写glm-5-turbo会找不到。sandbox.mode: off是本地调试用的生产环境按需开启。4. 逐条验证curl、日志与多渠道确认4.1 命令行 curl 验证最可靠不要只依赖 TUI。先在终端直接打智谱端点替换你的 Keycurl https://open.bigmodel.cn/api/paas/v4/chat/completions \ -H Authorization: Bearer YOUR_ZHIPU_API_KEY \ -H Content-Type: application/json \ -d { model: glm-5-turbo, messages: [{role: user, content: hi}] }成功标志返回 JSON 里包含content: Hi there...之类的文本。如果返回401是 Key 无效或没带上返回429先检查 URL 有没有写成coding/paas/v4返回404多半是模型名拼错。如果走 TaoToken 通道把 URL 换成https://taotoken.net/api/chat/completionsKey 换成 TaoToken 的其余不变。这一步通了说明凭证和端点都没问题问题一定在 OpenClaw 侧。4.2 查看 OpenClaw 日志curl 通了但 TUI 没反应时开一个终端跟日志openclaw logs --follow然后在 TUI 或飞书里发一句hi观察日志。成功时会看到类似dispatch complete (replies1)的标志。如果日志里有dispatch complete但 TUI 空白基本可以确认是渲染 Bug不是配置问题。如果日志里出现401或local proxy failed那才是真的鉴权或代理层出错需要回到第 3 节检查配置。4.3 多渠道交叉验证TUI 显示 NO 时换飞书或 Telegram 发同一句话。如果机器人正常回复完整内容说明 OpenClaw 配置完全成功TUI 只是显示层的问题。这一步能帮你把“配置错误”和“显示错误”彻底分开避免在错误的方向上改配置。4.4 验证清单按顺序过一遍每步都有明确预期步骤命令/动作预期结果1curl 智谱端点返回含 content 的 JSON2openclaw gateway restart无报错退出3openclaw logs --follow能看到请求日志4TUI 发 hi可能显示 NO已知 Bug5飞书发 hi收到完整回复6日志查 dispatch出现dispatch complete六步里第 1、5、6 步通过就算接入成功。第 4 步失败不影响使用。5. 401、429、TUI 显示 NO 与 local proxy failed 排查5.1 报错 401Key 无效或没带上典型日志401 Unauthorized或invalid api key。原因有三Key 复制时带了空格、Key 已过期或被删、配置里apiKey字段名写错。排查动作重新在智谱平台复制 Key确认models.providers.zai.apiKey字段存在且值完整。如果走 TaoToken确认 Key 是在https://taotoken.net/api-keys生成的且没有混用智谱的 Key。5.2 报错 429端点写错或额度耗尽典型日志API rate limit reached。第一嫌疑是baseUrl里多了coding段。第二嫌疑是套餐额度真的用完了去智谱后台看剩余额度。第三嫌疑是并发超过maxConcurrent设置把它从 4 调到 2 试试。注意429 不一定是“太快”端点错导致的鉴权失败也会伪装成限流。5.3 TUI 显示 NO渲染 Bug不是配置错现象curl 通、飞书通、日志有dispatch complete但 TUI 只显示NO。这是 OpenClaw TUI 对 GLM-5-Turbo 的 reasoning content 渲染不完整导致的模型实际已经返回。处理方式以 curl 和飞书结果为准等 OpenClaw 后续版本修复。不要因为这个去改reasoning字段改成false可能让模型不返回推理链反而影响效果。5.4 local proxy failed本地代理层没起来典型日志local proxy failed或connection refused。这通常是gateway.mode不是local或者网关进程没启动。排查确认配置里gateway.mode: local然后openclaw gateway restart再用openclaw gateway status看进程状态。如果端口被占用换一个端口或杀掉占用进程。5.5 reading choices 报错响应格式不匹配典型日志error reading choices或unexpected response format。这多半是api字段写成了别的协议比如anthropic-messages。GLM-5-Turbo 走 OpenAI 协议api必须是openai-completions。改完重启网关再试。5.6 OAuth 相关报错模式选错了如果你看到OAuth token expired或refresh token failed说明auth.profiles.zai:default.mode被写成了oauth。智谱这个端点用静态 Key改成api_key即可。OAuth 模式适用于另一类需要浏览器授权的服务不适用于这里的 API Key 鉴权。5.7 排查顺序建议遇到任何报错按这个顺序走先 curl 直连端点确认凭证有效再看openclaw logs --follow定位是鉴权层还是渲染层然后换飞书渠道交叉验证最后才动配置文件。多数人一上来就改配置结果把本来对的字段改错了反而增加排查成本。6. 把 endpoint 收口到 TaoToken 后的联调与长期用法配置跑通只是第一步长期用下去要考虑凭证管理和多工具协同。如果你同时用 OpenClaw、Cline、Codex每个工具各配一套智谱 Key轮换和排查都很麻烦。把 endpoint 统一到 TaoToken 通道后Base URL 固定为https://taotoken.net/apiKey 在控制台统一生成和吊销模型名保持glm-5-turbo三件套Base URL Key Model ID在哪个工具里都一致。联调时的验证动作和直连一样先 curlhttps://taotoken.net/api/chat/completions确认返回正常再重启 OpenClaw 网关看日志有没有dispatch complete最后在飞书发一句测试。三步都过说明收口成功。之后新增工具时只填这三件套即可不用再回智谱平台翻 Key。长期编码或跑 Agent 任务的话可以考虑用 Coding Plan 这类按周期计费的方案配合统一通道额度管理和成本核算都更清晰。模型对话类的临时验证直接在模型对话页测一句就行不用改本地配置。接入文档里有各工具的完整配置示例遇到字段不确定时对照着填。最后提醒一个实操细节切换通道后旧配置里的apiKey一定要替换干净不要留着智谱的 Key 混用否则日志里会出现两套鉴权记录排查时容易误判。改完配置记得openclaw gateway restart配置不会热加载。