1. OpenClaw 接入 GLM-5 到底解决什么问题
OpenClaw 是一个可以跑在自己电脑上的本地 AI 助手框架,它能接多渠道(终端 TUI、Web UI、Slack、Discord),也能挂插件和技能包,本质上是一个可扩展的 Agent 运行平台。GLM-5 是智谱推出的强推理模型,在代码生成、长链路任务规划上表现稳定。把这两者接起来,你得到的是一个数据不出本机、模型能力又足够强的私人助手。
适合谁?三类人最合适:一是想把 AI 助手跑在本地、不想把对话内容传到第三方 SaaS 的开发者;二是需要 Agent 做复杂任务(多步推理、调用工具、读写文件)的工程同学;三是已经在用 GLM Coding Plan、想把它接到本地框架里统一管理的人。
我实测下来,OpenClaw + GLM-5 这套组合的坑主要集中在三个地方:模型名写错导致计费异常、Base URL 没配对导致请求打不通、以及 provider 认证方式选错。这篇教程会把完整搭建流程走一遍,并且重点演示怎么把 endpoint 切到 TaoToken 统一 Key 通道,让多个模型共用一个入口,省去反复换 Key 的麻烦。
整个流程分六步:装 OpenClaw、拿 Key、写配置、验证连通、排错、长期使用。每一步都给可复制的命令和配置片段,你照着敲就能跑通。
2. TaoToken 统一 Key 通道的前置准备
在动手配 OpenClaw 之前,先把 Key 和通道准备好。这一步决定了后面配置能不能一次过。
TaoToken 的作用是提供一个统一的 API 入口,你不需要为每个模型单独记一套 Base URL 和 Key。它的 API 地址是https://taotoken.net/api,兼容 OpenAI 风格的请求格式,所以 OpenClaw 里凡是支持自定义 Base URL 的 provider,都能直接指过来。
具体操作:先到官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 注册账号,然后进控制台创建 API Key。创建入口在 console 页面,路径是console/api-keys,进去后点新建,复制出来的 Key 形如sk-xxxxxxxx,只显示一次,记得存好。
如果你还没决定用哪个模型,可以先到模型对话页面试一下 GLM-5 的响应效果,确认通道通了再往下配。模型对话入口:https://taotoken.net/api 对应的对话页可以直接测。
关于 GLM Coding Plan:如果你已经订阅了智谱的编程套餐,套餐本身是绑定 Z.AI 官方通道的。但如果你想让 OpenClaw 同时能调 GLM-5、Claude、GPT 等多个模型,用 TaoToken 统一 Key 会更省事——一个 Key 走所有模型,配置里只改 model 字段就行。
这里要提醒一点:TaoToken 是合规的 API 聚合通道,不是那种来路不明的转发。你拿到的 Key 有正常的额度管理和调用日志,出问题能查。
准备好这两样东西就可以往下走了:一个 TaoToken API Key,一个装好 Node.js 22+ 的环境。Node 版本用node -v确认,低于 22 的先升级,否则 OpenClaw 装不上。
3. 可复制的 OpenClaw 配置片段
这一步是核心。OpenClaw 的配置分两层:一层是 onboard 交互式初始化,一层是~/.openclaw/openclaw.json手动编辑。我建议先跑 onboard 把骨架生成出来,再手动改 model 和 provider 部分。
先装 OpenClaw。macOS / Linux 用官方脚本:
curl -fsSL https://openclaw.ai/install.sh | bashWindows PowerShell:
iwr -useb https://openclaw.ai/install.ps1 | iex或者用 npm 全局装:
npm install -g openclaw@latest装完执行初始化:
openclaw onboard --install-daemon交互过程里几个关键选择:风险提示选Yes,Onboarding mode 选Quick Start,Model/auth provider 这一步如果你走 TaoToken 统一通道,先随便选一个(比如 OpenAI Compatible),后面手动改配置文件。
初始化完成后,打开配置文件:
openclaw config或者直接编辑~/.openclaw/openclaw.json。下面是我实测能跑通的配置片段,把 provider 指向 TaoToken,model 用 GLM-5:
{ "providers": { "taotoken": { "type": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoToken密钥", "models": { "glm-5": { "id": "glm-5", "contextWindow": 128000 } } } }, "agents": { "defaults": { "model": { "primary": "taotoken/glm-5", "fallbacks": [ "taotoken/glm-4.7", "taotoken/glm-4.6" ] } } } }如果你坚持用 Z.AI 官方通道(已订阅 GLM Coding Plan),provider 段改成:
{ "providers": { "zai": { "type": "zai", "authMode": "coding-plan-cn", "apiKey": "你的智谱Key", "models": { "glm-5": { "id": "zai/glm-5" } } } } }注意模型名格式:走 TaoToken 时用glm-5,走 Z.AI 时用zai/glm-5,前缀不能混。写错了要么报模型不存在,要么走到默认模型上产生额外计费。
配置里三个必填项对齐一下:Base URL 填https://taotoken.net/api,Key 填 TaoToken 控制台拿的sk-开头串,Model ID 填glm-5。这三件套在 Cline、Codex 的 auth.json、CC Switch 里也是同样的填法,逻辑一致。
改完配置重启网关:
openclaw gateway restart4. 验证请求与成功结果
配置写完不代表通了,必须做连通性验证。OpenClaw 自带几个诊断命令,按顺序跑:
openclaw doctor openclaw status openclaw dashboarddoctor检查配置语法和 provider 可达性,status看网关进程状态,dashboard在浏览器打开控制台。三个都正常,说明骨架没问题。
接下来做一次真实请求。启动 TUI:
openclaw在交互界面里输入一句测试:
用 Python 写一个快速排序,并解释时间复杂度如果配置正确,你会看到 GLM-5 的流式输出,代码块和解释都正常返回。这时候去看 TaoToken 控制台的调用日志,应该能看到一条glm-5的请求记录,token 消耗和耗时都有。
再验证一下 fallback 是否生效。把主模型临时改成一个不存在的名字,比如taotoken/glm-5-typo,重启网关后再发请求。正常情况下 OpenClaw 会自动切到glm-4.7,你仍然能拿到回复,只是日志里会标记 fallback 触发。验证完记得改回来。
Web UI 验证:终端启动后会打印一行带 token 的地址,形如http://127.0.0.1:xxxx/?token=xxx,复制到浏览器打开,界面里发一条消息,确认 Web 通道也能走通。
成功的结果长这样:TUI 里模型正常回复、openclaw status显示 gateway running、TaoToken 日志有对应记录、Web UI 能对话。四个都满足,说明 OpenClaw 接入 GLM-5 完整跑通了。
5. 本篇常见报错排查
配的时候大概率会撞上几个典型报错,我按实际遇到的整理一下。
401 Unauthorized:Key 错了或者没生效。先确认openclaw.json里的apiKey是完整的sk-串,没有多余空格。如果 Key 是从环境变量读的,检查echo $TAOTOKEN_API_KEY有没有值。还有一种情况是 Key 被禁用或额度耗尽,去 TaoToken 控制台看 Key 状态。
local proxy failed / connection refused:Base URL 写错,或者网关没起来。确认baseUrl是https://taotoken.net/api,结尾不要多加/v1(OpenClaw 会自己拼)。然后openclaw gateway restart重启,再看openclaw status。
reading choices 报错 / 返回结构解析失败:通常是 provider type 选错了。走 TaoToken 必须用openai-compatible,如果你选成了anthropic或zai,返回的 JSON 结构对不上,就会在解析choices字段时炸掉。改回openai-compatible即可。
OAuth 相关报错:如果你在 onboard 时选了需要 OAuth 的 provider(比如某些官方直连),但没完成授权流程,会卡在认证。走 TaoToken 统一 Key 的话不涉及 OAuth,直接用 API Key 模式,避开这个坑。
模型不可用 / model not found:模型名格式问题。TaoToken 通道用glm-5,Z.AI 通道用zai/glm-5,别混。另外确认你选的模型在套餐支持列表里,GLM Coding Plan 支持 GLM-5、GLM-4.7、GLM-4.6、GLM-4.5、GLM-4.5-Air、GLM-4.5V、GLM-4.6V,不要选 Flash 和 FlashX,那两个可能产生额外计费。
网关启动但请求超时:检查本机网络出口是否正常,curl https://taotoken.net/api看能不能通。如果公司网络有出口限制,换网络环境再试。
排查顺序建议:先openclaw doctor看配置,再openclaw status看进程,最后看 TaoToken 日志确认请求有没有到达。三层定位,基本能锁定问题在哪。
6. 长期使用与统一 Key 的接入建议
跑通之后,日常使用还有几个优化点。
模型故障转移配置建议保留。fallbacks数组里放两到三个备选模型,主模型限流或维护时自动切换,服务不中断。我一般把glm-4.7放第一备选,glm-4.6放第二,够用。
技能系统按需装。clawhub是技能包管理工具:
npm i -g clawhub clawhub search "postgres backups" clawhub install my-skill-pack clawhub update --all插件同理,openclaw plugins list看已装,openclaw plugins install @openclaw/voice-call装新的,装完openclaw gateway restart。
如果你同时用 Cline、Codex、CC Switch 这些工具,建议全部指向 TaoToken 统一 Key。Base URL 都是https://taotoken.net/api,Key 用同一个,Model ID 按各自格式填。这样你只需要管理一个 Key,额度、日志、计费都在一个地方看,省心。
长期跑 Agent 任务的话,Coding Plan 比按量付费更划算,适合高频调用场景。接入文档在 https://taotoken.net/api 对应的 doc 页面有详细说明,遇到格式问题先翻文档。
安全方面提醒一句:OpenClaw 是高权限 Agent,能读写文件、执行命令。如果暴露到公网,必须配访问控制,不要默认开放端口。本地用的话,绑定127.0.0.1就行。
最后,如果你还没拿 Key,去 API Keys 页面创建一个:https://taotoken.net/api 对应的 console/api-keys。创建完直接填进openclaw.json的apiKey字段,重启网关就能用。整套流程走下来,从装到跑通大概二十分钟,剩下的时间就是调技能和插件了。