1. OPENCLAW 接 GLM5.1 到底卡在哪OPENCLAW 是一个把大模型能力接进本地工作流的开源 Agent 框架你可以把它理解成一个「调度中枢」它自己不生产模型而是通过 Provider 配置去调用外部大模型 API然后驱动对话、代码补全、自动化任务。GLM5.1 是智谱系的新一代通用模型推理和代码能力比上一代有明显提升适合放进 OPENCLAW 里当主力模型用。硅基流动SiliconFlow则是国内一个兼容 OpenAI 接口协议的大模型云平台模型广场里能直接找到 GLM 系列按量计费部分小模型免费新用户还有体验额度。这套组合适合谁适合刚接触 OPENCLAW、想用免费或低成本额度把 GLM5.1 跑起来的新手。你不需要自己有显卡也不需要折腾本地推理环境只要拿到一个 API Key写对配置文件骨架就能让 OPENCLAW 调通 GLM5.1。新手最容易卡住的地方其实就三个第一API Key 拿到了但不知道往哪填第二配置文件openclaw.json的层级结构写错Provider 名字和 Agent 引用对不上第三改完配置没重启 Gateway以为没生效。这篇就围绕这三个坑把从 Key 获取到连通性验证的完整链路走一遍同时给出用 TaoToken 统一 Key 通道的配置示例方便你后面接多个模型时不用来回换 Key。2. 前置准备Key 通道与配置文件骨架2.1 硅基流动侧拿 Key先在硅基流动控制台创建 API 密钥生成的串以sk-开头。这里有个细节密钥只在创建时完整显示一次关掉页面就查不到了所以复制后立刻存进密码管理器。如果你只是先测试模型广场里Qwen/Qwen2.5-7B-Instruct这类小模型可以免费用拿它做连通性验证最省额度。2.2 TaoToken 统一 Key 通道如果你后面还要接别的模型一个个平台去管 Key 会很乱。TaoToken 提供统一 Key 通道把不同平台的调用收敛到一个入口OPENCLAW 里只配一份凭证就行。它的 API 地址是https://taotoken.net/api兼容 OpenAI 协议所以配置方式和硅基流动几乎一样只是baseUrl和apiKey换成 TaoToken 的。控制台里可以创建和管理 Key地址在 consoleKey 管理页在 api-keys。想先看看模型对话效果可以直接用 模型对话 试跑。注意无论用哪家的 Key都不要写进公开仓库也不要在截图里露出完整串。Key 等同于账户余额的消费凭证。2.3 配置文件位置OPENCLAW 的主配置文件是openclaw.json放在用户目录下的.openclaw文件夹里WindowsC:\Users\你的用户名\.openclaw\openclaw.jsonmacOS / Linux~/.openclaw/openclaw.json改之前先复制一份openclaw.json.bak。我试过直接改坏配置又没备份结果 Gateway 起不来只能重装这个坑没必要踩。3. 可复制配置openclaw.json 骨架3.1 Provider 节点打开openclaw.json找到models→providers加入硅基流动这个 Provider。下面这份骨架可以直接抄把apiKey换成你自己的{ models: { providers: { siliconflow: { baseUrl: https://api.siliconflow.cn/v1, apiKey: sk-替换为你的硅基流动API密钥, api: openai-completions, models: [ { id: Pro/zai-org/GLM-4.7, name: Silicon GLM 4.7, contextWindow: 128000, maxTokens: 8192 }, { id: Qwen/Qwen2.5-7B-Instruct, name: Qwen 7B Free, contextWindow: 32768, maxTokens: 8192 } ] } } } }字段含义对照如下字段说明baseUrl硅基流动 API 地址固定https://api.siliconflow.cn/v1apiKey你的硅基流动密钥sk-开头api协议类型填openai-completionsmodels[].id模型 ID必须和模型广场完全一致注意大小写models[].name显示名自定义contextWindow上下文窗口 token 数maxTokens单次输出上限3.2 换成 TaoToken 通道如果走 TaoToken 统一 Key把 Provider 换成这样其余结构不变{ models: { providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: 替换为你的TaoToken密钥, api: openai-completions, models: [ { id: Pro/zai-org/GLM-4.7, name: TaoToken GLM 4.7, contextWindow: 128000, maxTokens: 8192 } ] } } } }3.3 Agent 默认模型Provider 配好后还要告诉 Agent 用哪个模型。找到agents→defaults{ agents: { defaults: { model: { primary: siliconflow/Pro/zai-org/GLM-4.7 }, models: { siliconflow/Pro/zai-org/GLM-4.7: { alias: glm }, siliconflow/Qwen/Qwen2.5-7B-Instruct: { alias: qwen } } } } }关键规则只有一条primary的值格式是Provider名/模型ID。这里的siliconflow必须和你在providers里写的键名一模一样写错一个字母就会报 Unknown model。alias是简写方便切换。3.4 settings.json 补充项部分版本会把运行参数放在settings.json里和openclaw.json同目录。如果你需要控制超时和重试可以加{ request: { timeoutMs: 60000, maxRetries: 2 }, logging: { level: info } }timeoutMs给到 60000 是留足 GLM5.1 长输出的时间设太小会出现回复截断的假象。4. 验证请求与成功结果4.1 先用 curl 验 Key在配置 OPENCLAW 之前先确认 Key 本身能用。终端里跑curl https://api.siliconflow.cn/v1/chat/completions \ -H Authorization: Bearer YOUR_API_KEY \ -H Content-Type: application/json \ -d { model: Qwen/Qwen2.5-7B-Instruct, messages: [{role: user, content: 你好}] }返回 JSON 里带choices字段说明 Key 没问题。如果这里就报 401别急着改 OPENCLAW先把 Key 重新复制一遍确认没有多余空格或换行。4.2 重启 Gateway 让配置生效改完openclaw.json必须重启服务否则读的还是旧配置# macOS / Linux openclaw gateway restart # Windows先停再起 openclaw gateway stop schtasks /Run /TN openclaw Gateway4.3 发一条测试消息openclaw agent --agent main --message 你好用一句话介绍你自己正常返回一段文本就说明 GLM5.1 已经通过 OPENCLAW 调通了。想确认走的是哪个模型可以加--verbose看请求日志里的 model 字段。4.4 看实时日志openclaw logs --follow日志里会打印请求的 baseUrl、model 和响应状态码。排障时这个比猜有用得多。5. 本篇常见报错排查清单现象可能原因处理方式401 / UnauthorizedKey 无效或带空格重新复制确认无换行403余额不足控制台充值或换免费模型Unknown model模型 ID 写错和模型广场逐字比对注意大小写连接超时网络或 baseUrl 错确认能访问api.siliconflow.cn配置不生效没重启 Gateway执行openclaw gateway restart回复被截断maxTokens 太小调大对应模型的 maxTokensProvider 找不到primary 前缀和 Provider 键名不一致检查siliconflow/前缀拼写免费模型也调不动账号未激活重新登录确认注册流程完成如果上面都排完还是不通跑一次openclaw doctor --fix它会自动检测配置层级和常见环境问题。想快速验证模型本身是否可用可以到 模型对话 里直接发一条消息对比结果。6. 后续接入与 Key 管理配置跑通之后你大概率会想加更多模型。这时候统一 Key 通道的价值就出来了在 api-keys 里管理凭证OPENCLAW 侧只维护一份 Provider 配置新增模型时改models数组即可不用动 Agent 引用。接入细节和参数说明可以对照 接入文档 逐项核对。如果你打算把 OPENCLAW 长期当编码或 Agent 工作流用频繁调用下按量计费会累积可以看看 Coding Plan 这类套餐是否更划算。用 Claude Code 接 Anthropic 系模型的场景配置入口在 ClaudeCodeAnthropic思路和本篇一致换 baseUrl 和 Key 就行。最后留一个实用习惯每次改完openclaw.json先openclaw doctor --fix再openclaw gateway restart然后发一条测试消息。三步走完再去做别的能省掉大量「改了没反应」的排查时间。
