OpenClaw 接入智谱 GLM-5-Turbo 龙虾套餐：完整避坑指南与 SOP

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/api，Key 在控制台的 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 restart

3.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。先在终端直接打智谱端点，替换你的 Key：

curl 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/completions，Key 换成 TaoToken 的，其余不变。这一步通了，说明凭证和端点都没问题，问题一定在 OpenClaw 侧。

4.2 查看 OpenClaw 日志

curl 通了但 TUI 没反应时，开一个终端跟日志：

openclaw logs --follow

然后在 TUI 或飞书里发一句hi，观察日志。成功时会看到类似dispatch complete (replies=1)的标志。如果日志里有dispatch complete但 TUI 空白，基本可以确认是渲染 Bug，不是配置问题。如果日志里出现401或local proxy failed，那才是真的鉴权或代理层出错，需要回到第 3 节检查配置。

4.3 多渠道交叉验证

TUI 显示 NO 时，换飞书或 Telegram 发同一句话。如果机器人正常回复完整内容，说明 OpenClaw 配置完全成功，TUI 只是显示层的问题。这一步能帮你把“配置错误”和“显示错误”彻底分开，避免在错误的方向上改配置。

4.4 验证清单

按顺序过一遍，每步都有明确预期：

六步里第 1、5、6 步通过，就算接入成功。第 4 步失败不影响使用。

5. 401、429、TUI 显示 NO 与 local proxy failed 排查

5.1 报错 401：Key 无效或没带上

典型日志：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/api，Key 在控制台统一生成和吊销，模型名保持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，配置不会热加载。