OpenClaw接入智谱GLM-4.7-Flash免费模型教程，打造零成本AI助手

OpenClaw 大家肯定不陌生了，它是一款开源的个人 AI Agent 框架，支持 飞书、钉钉、QQ、Discord 等多平台接入。本文介绍如何将智谱清言的免费模型 GLM-4.7-Flash 接入 OpenClaw，打造零成本的个人 AI 助手。

2026年1月，智谱AI正式发布并开源了 GLM-4.7-Flash，完全免费调用。这是一款混合思考模型，总参数量30B，激活参数量仅3B，在 SWE-bench Verified、τ²-Bench 等主流基准测试中表现优异，适合编程、中文写作、翻译、长文本处理等场景。

下面介绍 OpenClaw 接入 GLM-4.7-Flash 免费模型的方法。

一、获取智谱 API Key

1. 注册账号 访问 BigModel.cn 注册，使用我的邀请链接新用户赠送 2000 万 tokens，可以使用高级模型。
2. 创建 API Key 进入控制台 → API Key 管理 → 创建新的 API Key → 保存凭证。点击复制按钮可以复制 API key。

二、OpenClaw 配置

方式一：交互式配置向导（推荐）

在 OpenClaw 终端执行：

openclaw config

按提示选择：

1. Gateway 运行位置：选择 Local
2. 模型选择：选择 Zhipu AI / GLM
3. API Key 输入：粘贴你的智谱 API Key
4. 确认配置：保存并重启

如果没生效，执行以下命令重启：

openclaw gateway restart

方式二：手动编辑配置文件

编辑 .env 文件，添加智谱 API Key

nano ~/.openclaw/.env

添加以下内容：

ZAI_API_KEY=你的智谱API密钥

编辑 ~/.openclaw/openclaw.json，添加以下配置：

在 models.providers 中添加智谱配置：

"zai": {
  "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
  "api": "openai-completions",
  "models": [
    {
      "id": "glm-4.7-flash",
      "name": "GLM-4.7 Flash",
      "reasoning": true,
      "input": ["text"],
      "cost": {
        "input": 0,
        "output": 0,
        "cacheRead": 0,
        "cacheWrite": 0
      },
      "contextWindow": 204800,
      "maxTokens": 131072
    }
  ]
}

在 auth.profiles 中添加认证信息：

"zai:default": {
  "provider": "zai",
  "mode": "api_key"
}

设置模型 alias：在 agents.defaults.models 中设置

"models": {
  "zai/glm-4.7-flash": {
    "alias": "GLM"
  }
}

设置为默认模型（可选）：在 agents.defaults.model 中设置：

"model": {
  "primary": "zai/glm-4.7-flash"
}

重启 Gateway：

openclaw gateway restart

三、测试验证

查看可用模型：在聊天窗口发送

model list

确认显示 glm-4.7-flash。

切换模型：如需切换模型，使用命令

/model glm-4.7-flash

四、API 端点说明

国内版（CN）：https://open.bigmodel.cn/api/paas/v4 适用于国内注册账号

国际版（Global）：https://api.z.ai/api/paas/v4 适用于国际注册账号

注意：国内用户请使用 CN 端点，API Key 可能不互通。

五、常见问题

Q1: 网络错误怎么办？

A: 检查是否使用了正确的 API 端点。国内 API Key 请使用 CN 端点。

Q2: 模型不可用？

A: 执行 openclaw gateway restart 重启服务。

Q3: Token 超限？

A: GLM-4.7-Flash 上下文窗口为 204800 tokens，请减少上下文长度或分段处理。

六、相关资源

• 使用指南：https://docs.bigmodel.cn/cn/guide/models/free/glm-4.7-flash

• 接口文档：https://docs.bigmodel.cn/api-reference/模型-api/对话补全