企业官网建设流程全解析

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，地址在 console，Key 管理页在 api-keys。想先看看模型对话效果，可以直接用 模型对话 试跑。

注意：无论用哪家的 Key，都不要写进公开仓库，也不要在截图里露出完整串。Key 等同于账户余额的消费凭证。

2.3 配置文件位置

OPENCLAW 的主配置文件是openclaw.json，放在用户目录下的.openclaw文件夹里：

• Windows：C:\Users\<你的用户名>\.openclaw\openclaw.json
• macOS / 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 } ] } } } }

字段含义对照如下：

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 Gateway"

4.3 发一条测试消息

openclaw agent --agent main --message "你好，用一句话介绍你自己"

正常返回一段文本，就说明 GLM5.1 已经通过 OPENCLAW 调通了。想确认走的是哪个模型，可以加--verbose看请求日志里的 model 字段。

4.4 看实时日志

openclaw logs --follow

日志里会打印请求的 baseUrl、model 和响应状态码。排障时这个比猜有用得多。

5. 本篇常见报错排查清单

如果上面都排完还是不通，跑一次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，然后发一条测试消息。三步走完再去做别的，能省掉大量「改了没反应」的排查时间。