1. OpenClaw 接入智谱 GLM 到底解决什么问题OpenClaw 是一个以 MIT 协议开源的 AI 智能体框架社区里因为它的龙虾标识习惯叫它“龙虾”。它能做什么简单说它把大模型能力包装成一个可以本地运行、多渠道接入的智能体网关对话记录、长期记忆、技能文件都以 Markdown 和 YAML 存在你自己的机器上你可以用任何文本编辑器打开看用 Git 备份用 grep 搜。适合谁适合想把 AI 助手跑在自己环境里、又不想被单一模型绑死的开发者和小团队。但 OpenClaw 本身不生产模型它需要接一个“大脑”。智谱 GLM 系列就是国内开发者最常接的大脑之一GLM-4 系列主打通用能力和长文本GLM-Z1 系列强化逻辑推理AutoGLM 则偏向智能体任务拆解。把 OpenClaw 和智谱 GLM 接起来你得到的是一个本地可控、模型可换、还能从飞书或 Telegram 发消息触发的智能体。这篇要解决的核心检索词就是OpenClaw 通过 API Key 接入智谱 GLM 的完整流程。我会从 Node.js 环境准备讲起到 Base URL 和模型名怎么填再到连通性验证最后给一份可复制的 settings 配置片段和一次真实对话调用。整个过程不需要你懂底层推理照着做就能在本地跑通。我试过在 macOS 和 Ubuntu 上各跑一遍踩过的坑主要集中在 Node 版本和 Base URL 结尾斜杠上后面会单独讲。先明确一件事OpenClaw 是框架智谱 GLM 是模型提供方两者之间靠 API Key 和 Base URL 握手。你只要把这三样东西配对剩下的就是验证。2. 前置准备Node.js 环境与智谱 API Key 获取2.1 Node.js 版本与包管理器OpenClaw 对 Node.js 版本有要求官方建议 22 或更新版本。为什么强调这个因为低版本 Node 在 fetch 和 ESM 加载上会有兼容问题表现就是启动时报ERR_REQUIRE_ESM或者连接超时。你可以先查一下当前版本node -v如果输出是 v18 或 v20建议升级。用 nvm 的话nvm install 22 nvm use 22包管理器推荐 pnpm安装快、依赖扁平。全局装一个npm install -g pnpm pnpm -v2.2 获取智谱 API Key登录智谱开放平台完成实名认证后在 API Key 管理页面创建一个新 Key。创建时给它起个名字比如openclaw-local方便以后区分。Key 只显示一次复制后先存到本地一个安全文件里别直接贴在聊天窗口。这里有个细节智谱的 Key 通常是一串以点分隔的字符串形如xxxxxxxx.yyyyyyyy。如果你拿到的 Key 里包含空格或换行粘贴到配置文件时一定要去掉否则请求会返回 401。2.3 安装 OpenClaw用 pnpm 全局安装pnpm install -g openclaw openclaw --version如果提示命令找不到检查 pnpm 的全局 bin 目录是否在 PATH 里。macOS 和 Linux 一般是~/.local/share/pnpmWindows 是%LOCALAPPDATA%\pnpm。安装完成后先别急着配智谱跑一次openclaw config看看向导能不能正常启动。向导会弹出一段安全警告提示 OpenClaw 有读取文件和执行命令的权限。这是它作为本地智能体的正常行为在私人机器或虚拟机里选 Local 继续即可。3. 可复制配置Base URL、模型名与 settings 片段3.1 理解 Base URL 和模型名OpenClaw 接任何 OpenAI 兼容接口都需要三个东西Base URL、API Key、Model ID。智谱的接口是 OpenAI 兼容的所以 Base URL 填智谱的 API 地址Model ID 填具体模型名比如glm-4-plus或glm-4-flash。这里要特别注意Base URL 的结尾不要多加斜杠。我见过有人填成https://open.bigmodel.cn/api/paas/v4/结果请求路径拼成双斜杠服务端返回 404。正确写法是https://open.bigmodel.cn/api/paas/v4如果你希望通过统一网关来管理多个模型的 Key也可以把 Base URL 指向 TaoToken 的 API 地址https://taotoken.net/api然后在 TaoToken 控制台里配置智谱的 Key。这样 OpenClaw 只需要认一个 Base URL换模型时不用改框架配置。两种方式都行下面我以直连智谱为例因为这是最直接的验证路径。3.2 可复制的 settings 配置片段OpenClaw 的配置文件通常位于~/.openclaw/settings.json或项目目录下的settings.json。你可以直接复制下面这段把YOUR_ZHIPU_API_KEY替换成你自己的 Key{ models: { default: glm-4-plus, providers: { zhipu: { baseUrl: https://open.bigmodel.cn/api/paas/v4, apiKey: YOUR_ZHIPU_API_KEY, models: [ { id: glm-4-plus, name: GLM-4 Plus, contextWindow: 128000 }, { id: glm-4-flash, name: GLM-4 Flash, contextWindow: 128000 } ] } } }, agent: { name: lobster-local, workspace: ./workspace } }如果你用的是 TOML 格式的配置等价写法是[models] default glm-4-plus [models.providers.zhipu] baseUrl https://open.bigmodel.cn/api/paas/v4 apiKey YOUR_ZHIPU_API_KEY [[models.providers.zhipu.models]] id glm-4-plus name GLM-4 Plus contextWindow 128000保存后用openclaw config validate检查语法。如果输出Config OK说明结构没问题。3.3 用向导配置的替代路径如果你不想手写 JSON也可以走openclaw config向导。在模型供应商那一步选智谱相关选项认证方式选 CN然后粘贴 API Key默认模型保持 GLM-4 系列不动一路回车。向导本质上就是帮你生成上面那段 JSON所以两种方式结果一样。向导跑完后建议打开生成的 settings.json 核对一遍 Base URL 和模型名。我遇到过向导把模型名写成glm-4而实际账号只开通了glm-4-plus的情况导致请求返回模型不存在。核对一遍能省掉后面排障的时间。4. 验证请求一次真实对话调用与成功结果4.1 用 curl 先验接口在动 OpenClaw 之前先用 curl 确认智谱接口本身是通的。这一步能帮你把“Key 问题”和“框架问题”分开curl -X POST https://open.bigmodel.cn/api/paas/v4/chat/completions \ -H Authorization: Bearer YOUR_ZHIPU_API_KEY \ -H Content-Type: application/json \ -d { model: glm-4-plus, messages: [ {role: user, content: 用一句话说明你是什么模型} ] }如果返回 JSON 里choices[0].message.content有内容说明 Key 和 Base URL 都对。如果返回 401检查 Key 是否复制完整如果返回 404检查 Base URL 是否多了斜杠。4.2 在 OpenClaw 里发起对话接口通了之后启动 OpenClawopenclaw start然后在另一个终端里发一条消息openclaw chat 你好请用一句话介绍 OpenClaw 接入智谱 GLM 的意义预期输出会是一段中文回复类似OpenClaw 接入智谱 GLM 后你可以在本地智能体框架里直接调用国产大模型能力实现对话、任务自动化与多渠道消息触发。如果你看到的是Error: connect ECONNREFUSED说明 OpenClaw 没读到配置里的 Base URL检查 settings.json 路径是否正确。如果看到401 Unauthorized回到 4.1 用 curl 再验一次 Key。4.3 验证模型切换OpenClaw 支持多模型切换。你可以在对话时指定模型openclaw chat --model glm-4-flash 用一句话说明 Flash 和 Plus 的区别如果切换成功说明 settings.json 里的 models 数组被正确加载。这一步很关键因为很多人只配了 default 模型后面想换模型时发现列表是空的。5. 常见报错排查401、local proxy failed、reading choices5.1 401 Unauthorized这是最常见的报错。原因通常有三个Key 复制时带了空格、Key 已过期或被删除、请求头里 Authorization 格式不对。排查顺序先用 curl 验 Key再检查 settings.json 里 apiKey 字段有没有多余字符。如果 Key 没问题检查 Base URL 是否指向了正确的区域端点。5.2 local proxy failed这个报错通常出现在你本机设置了网络代理但 OpenClaw 没有走代理或者代理配置和实际网络环境不匹配。表现是请求发不出去日志里出现local proxy failed。解决方法是检查环境变量HTTP_PROXY和HTTPS_PROXY如果不需要代理就清掉如果需要确保 OpenClaw 启动时能读到这些变量。5.3 reading choices 报错完整报错可能是Cannot read properties of undefined (reading choices)。这说明请求返回的 JSON 结构里没有 choices 字段通常是服务端返回了错误信息但框架没正确解析。你可以打开 OpenClaw 的调试日志openclaw start --log-level debug然后在日志里找原始响应体。常见原因是模型名写错服务端返回{error: {message: model not found}}而框架尝试读 choices 就报了这个错。把模型名改成账号实际开通的模型即可。5.4 OAuth 相关报错如果你在配置里误开了 OAuth 认证可能会看到OAuth token exchange failed。OpenClaw 接智谱用的是 API Key 模式不需要 OAuth。检查 settings.json 里有没有多余的authType或oauth字段删掉后重启。5.5 配置三件套核对表不管遇到哪种报错先核对这三样项目正确示例常见错误Base URLhttps://open.bigmodel.cn/api/paas/v4结尾多斜杠、漏掉/v4API Keyxxxxxxxx.yyyyyyyy带空格、带换行、已过期Model IDglm-4-plus写成glm-4但账号未开通如果你用的是 TaoToken 作为统一网关Base URL 换成https://taotoken.net/apiKey 换成 TaoToken 控制台生成的 KeyModel ID 保持智谱的模型名不变。这样三件套依然成立只是 Key 的来源变了。6. 长期使用建议与接入入口跑通之后你可能会想让 OpenClaw 长期在后台运行或者接入飞书、Telegram 等渠道。这时候建议把 settings.json 纳入 Git 管理但 API Key 不要直接提交用环境变量引用{ apiKey: ${ZHIPU_API_KEY} }然后在 shell 里 exportexport ZHIPU_API_KEYxxxxxxxx.yyyyyyyy这样换机器时只需要重新设置环境变量配置文件可以安全同步。如果你需要更系统地管理多个模型的 Key或者想让 OpenClaw 同时接智谱、Claude 等多个提供方可以走统一网关的方式。在 TaoToken 控制台创建 API Key把 Base URL 指向https://taotoken.net/api然后在 OpenClaw 里只配一个 provider。这样以后换模型只需要在控制台调整不用改本地配置。接入文档和 API Key 管理入口在这里API Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite模型对话验证https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite如果你打算把 OpenClaw 用在长期编码或 Agent 任务上Coding Plan 会更合适Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite最后说一个实用技巧OpenClaw 的 workspace 目录里会生成对话历史和技能文件定期用git add和git commit备份比任何云同步都可靠。智谱的 Key 如果泄露第一时间去开放平台删除重建别犹豫。