如何接入 GLM 到 OpenClaw

如何接入 GLM 到 OpenClaw

GLM（智谱 AI）是国产大模型的代表之一，GLM-4.5 系列采用 MoE 架构，在 12 项行业标准基准测试中综合得分 63.2，全球排名第三、国产第一。本教程教你把 GLM 接入 OpenClaw AI Agent 框架，让 AI 帮你写代码、做推理、构建智能体。

GLM 接入 OpenClaw 有两种方式，选一种就行：

前置准备

不管选哪种方式，都需要这几样东西：

• 已安装 Node.js 22.x 或更高版本（运行 node --version 验证）
• 已注册 智谱 GLM 开放平台 账号
• 操作系统为 Windows 10/11、macOS 或 Linux
• 电脑能上网（GLM 国内直连，不用梯子）

步骤一：获取 GLM API Key

两种方式都要先领一张 GLM 的「通行证」（API Key）。

1.1 注册并登录

1. 访问 智谱 GLM 开放平台，点击「登录」注册账号
2. 支持手机号、邮箱等多种注册方式，无需信用卡即可获得免费额度
3. 按平台提示完成实名认证（个人开发者需上传身份证信息）

1.2 创建 API Key

1. 登录后进入平台左侧 「控制台」→「API 密钥管理」 页面
2. 点击 「添加新的 API 密钥」 按钮
3. 输入名称（如 openclaw-dev），点击确认
4. 页面会显示一串密钥，这就是你的通行证

1.3 了解可用模型

注：GLM-4.5 系列采用分段计费，输入长度 [0, 32K) 区间单价为 ¥0.8/M，[32K, 128K) 区间单价为 ¥1.2/M。缓存命中价格更低，适合生产环境。

步骤二：安装 OpenClaw

如果你还没装 OpenClaw，先装上。

1. 打开终端

• Windows 用户：按 Win + R，输入 cmd，回车
• Mac 用户：按 Command + 空格，输入「终端」，回车

2. 安装 OpenClaw CLI

1npm install -g openclaw-cli

步骤三：接入 GLM

从这里开始，方式 A 和方式 B 分开走，选一种跟着做即可。

方式 A：引导向导接入（推荐新手）

OpenClaw 自带一个引导向导，跟着它一步步填就能接好，全程不用手写配置。

A1. 启动向导

在终端里输入：

1openclaw onboard

A2. 依次选择 Yes → QuickStart → Custom Provider

向导会问你几个问题，照下面选：

1. 第一个问「是否开始配置」→ 输入 Yes，回车
2. 问你选哪种模式 → 选 QuickStart（快速开始）
3. 问你选哪种供应商 → 选 Custom Provider（自定义供应商，因为我们要接 GLM）

A3. 输入 API Base URL

向导问你 API 地址，填这个：

回车确认。

A4. 粘贴 GLM API Key

向导问你 API Key，把步骤一领到的 ID.密钥 格式的通行证粘进去，回车。

A5. 填写模型 ID

向导问你用哪个模型，先填默认的：

回车。之后还会问你选什么协议，选 OpenAI-compatible（GLM 兼容 OpenAI 格式）。

A6. 验证连接

向导会自动测试连接，出现 Verification successful（验证成功）字样就说明接通了！

A7. 自定义显示名称

最后向导会让你给这个接入点起个名字（显示用），随便填，比如 GLM，回车完成。

方式 B：配置文件手动接入（进阶）

如果你更喜欢直接改配置文件，可以跳过向导，手动编辑。

B1. 初始化配置文件

如果还没初始化过，先跑：

1openclaw config init

这会在当前目录生成 config.json 文件。

B2. 编写 GLM 模型配置

打开 config.json，推荐用环境变量方式（最安全，避免 Key 明文写入）：

1{
2  "models": [
3    {
4      "name": "glm-4.5",
5      "provider": "openai-compatible",
6      "baseURL": "https://open.bigmodel.cn/api/paas/v4",
7      "apiKeyEnv": "GLM_API_KEY",
8      "maxTokens": 4096,
9      "temperature": 0.7
10    },
11    {
12      "name": "glm-4-flash",
13      "provider": "openai-compatible",
14      "baseURL": "https://open.bigmodel.cn/api/paas/v4",
15      "apiKeyEnv": "GLM_API_KEY",
16      "maxTokens": 4096,
17      "temperature": 0.7
18    }
19  ],
20  "defaultModel": "glm-4.5"
21}

然后设置环境变量：

1# PowerShell（临时，当前会话有效）
2$env:GLM_API_KEY = "你的ID.密钥"
3
4# 或设为系统永久环境变量（重启终端仍有效）
5[System.Environment]::SetEnvironmentVariable("GLM_API_KEY", "你的ID.密钥", "User")

1# macOS / Linux（临时）
2export GLM_API_KEY="你的ID.密钥"
3
4# 写入 ~/.bashrc 永久生效
5echo 'export GLM_API_KEY="你的ID.密钥"' >> ~/.bashrc
6source ~/.bashrc

B3. 关键参数说明

步骤四：测试验证

4.1 重启 OpenClaw 服务

配置完成后（方式 B 需重启加载配置；方式 A 向导已自动处理，可跳过）：

1openclaw restart

4.2 检查当前模型状态

1openclaw status

预期输出应显示 glm-4.5 为默认模型。

4.3 发送测试消息

在 OpenClaw 的聊天界面中发送一条测试消息：

如果收到来自 GLM 的回复，恭喜你——接入成功！🎉

4.4 Python 快速验证（可选）

绕过 OpenClaw 直接验证 API Key 是否有效：

1from openai import OpenAI
2
3client = OpenAI(
4    api_key="你的GLM API Key",   # 格式：ID.密钥
5    base_url="https://open.bigmodel.cn/api/paas/v4"
6)
7
8response = client.chat.completions.create(
9    model="glm-4.5",
10    messages=[
11        {"role": "system", "content": "你是一个有用的 AI 助手。"},
12        {"role": "user", "content": "说一句'Hello, GLM!'"}
13    ],
14    max_tokens=100
15)
16
17print("✅ 连接成功！模型回复：")
18print(response.choices[0].message.content)

运行前确保已安装依赖：

1pip install openai
2python test_glm.py

场景应用示例

🧩 场景 1：智能体编程

GLM-4.5 专为智能体应用打造，工具调用成功率达 90.6%，超越 Claude-4-Sonnet、Kimi-K2、Qwen3-Coder：

效果：

• 原生工具调用、网页浏览、多轮对话
• 支持智能体编程、深度搜索、通用工具使用
• 在 CC-Bench 智能体编程测试中表现卓越

🧩 场景 2：复杂推理

GLM-4.5 的混合推理模式支持思考/非思考两种模式：

使用示例：

1请帮我分析这段代码的时间复杂度和空间复杂度，
2并给出优化建议：
3[粘贴你的代码]

效果：

• AIME24 数学竞赛 91% 通过率
• MATH 500 达到 98.2%
• 思考模式展示完整推导过程

🧩 场景 3：免费开发测试

利用 glm-4-flash 永久免费的特性：

效果：

• 128K 上下文，30 并发
• 适合开发测试、原型验证、轻量任务
• 无需担心成本，可放心迭代

最佳实践

💰 成本优化技巧

1. 利用 Prompt 缓存：智谱平台支持隐式缓存，将 system prompt 和工具定义等固定内容放在消息开头，缓存命中后成本降低 80% 以上

2. 按需选模：

   • 开发测试 → glm-4-flash（永久免费）
   • 通用对话 → glm-4.5-air（高性价比）
   • 复杂推理 → glm-4.5（旗舰性能）
   • 多模态任务 → glm-4-plus

3. 控制上下文长度：GLM-4.5 采用分段计费，输入长度 < 32K 时单价更低，合理控制对话历史

4. 切换推理模式：简单任务用非思考模式获得即时响应，复杂任务才启用思考模式

🔒 安全建议

1. 永远不要将 API Key 提交到 Git 仓库 —— 确保 .gitignore 包含 .env 和 config.json
2. 定期轮换 Key —— 在智谱控制台定期更新密钥（建议每 90 天更换）
3. 设置用量告警 —— 在开放平台设置预算上限，防止意外超额
4. 使用最小权限原则 —— 仅授予必要的 API 权限范围

🐛 故障排查速查表

扩展与进阶

📚 更多学习资源

🚀 进阶玩法

• 多模型混合部署：在 config.json 中同时配置 GLM + 其他模型，根据任务类型动态切换
• 流式输出（Streaming）：开启 SSE 流式返回，提升长文本的交互体验
• 工具调用（Function Calling）：GLM-4.5 工具调用成功率 90.6%，可对接外部 API
• 混合推理模式：通过参数控制思考/非思考模式，平衡速度与质量
• 多模态理解：GLM-4-Plus 支持图像输入，可进行图像理解和描述