白嫖指南：用智谱 AI 免费模型驱动 OpenClaw

🎯 核心优势

智谱 AI（BigModel）提供三款完全免费的模型，可无缝接入 OpenClaw：

模型	类型	上下文	核心能力	适用场景
glm-4.7-flash	文本	200K	Agentic Coding、前端生成、复杂任务规划	代码开发、文档写作、数据分析
glm-4.6v-flash	多模态	128K	图片/视频/文件理解、OCR、视觉工具调用	截图分析、文档解析、视频内容提取
cogview-3-flash	图像生成	-	文生图、多分辨率、快速推理	PPT 配图、设计素材、创意生成

免费额度： 注册即送，具体速率限制查看 [智谱控制台] (https://www.bigmodel.cn/usercenter/proj-mgmt/rate-limits)

📋 前置准备

1. 注册智谱 AI 账号

访问 https://bigmodel.cn 注册账号，完成实名认证。

2. 获取 API Key

登录 https://www.bigmodel.cn/console/apikey
创建新 API Key
复制保存（格式：xxxxxxxx.xxxxxxxxxxxxxxxx）

3. 配置 OpenClaw

编辑 ~/.openclaw/openclaw.json，添加智谱 AI 模型配置：

{
  "models": [
    {
      "id": "bigmodel/glm-4.7-flash",
      "provider": "openai-compatible",
      "config": {
        "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
        "apiKey": "你的 API_KEY",
        "model": "glm-4.7-flash"
      },
      "contextWindow": 200000,
      "maxOutputTokens": 131072,
      "usage": ["chat", "agent"]
    },
    {
      "id": "bigmodel/glm-4.6v-flash",
      "provider": "openai-compatible",
      "config": {
        "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
        "apiKey": "你的 API_KEY",
        "model": "glm-4.6v-flash"
      },
      "contextWindow": 128000,
      "usage": ["chat", "agent", "vision"]
    },
    {
      "id": "bigmodel/cogview-3-flash",
      "provider": "openai-compatible",
      "config": {
        "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
        "apiKey": "你的 API_KEY",
        "model": "cogview-3-flash"
      },
      "usage": ["image"]
    }
  ],
  "defaultModel": "bigmodel/glm-4.7-flash"
}

注意：

baseUrl 固定为 https://open.bigmodel.cn/api/paas/v4
apiKey 替换为你的真实 API Key
配置后重启 OpenClaw：openclaw gateway restart

🚀 使用示例

场景 1：代码开发（glm-4.7-flash）

/switch bigmodel/glm-4.7-flash

帮我创建一个 ClassCMS 插件，实现股票数据展示功能：
1. 调用 Tushare API 获取实时行情
2. 缓存数据到数据库
3. 前端页面显示 K 线图

优势： 200K 上下文支持大型项目，Agentic Coding 能力可自主完成多文件开发。

场景 2：截图分析（glm-4.6v-flash）

/switch bigmodel/glm-4.6v-flash

[发送截图]

分析这个网页的布局结构，生成复刻的 HTML/CSS 代码

优势： 原生多模态工具调用，支持像素级前端复刻、视觉交互调试。

场景 3：文档解析（glm-4.6v-flash）

/switch bigmodel/glm-4.6v-flash

[上传 PDF 文件]

提取这份财报的核心财务数据，整理成对比表格

优势： 128K 上下文支持长文档，跨页逻辑理解，复杂表格解析。

场景 4：PPT 配图（cogview-3-flash）

/switch bigmodel/cogview-3-flash

生成一张温馨而富有教育意义的背景图，适合用于幼儿防溺水 PPT。
图中应包含清澈的游泳池，周围有救生圈、救生衣等安全设施，
以及配备游泳圈快乐玩耍的小朋友们，色彩明亮，适合儿童视觉
分辨率：1344x768

优势： 多分辨率支持（1024x1024、1344x768 等），数秒快速生成。

💡 进阶技巧

1. 模型自动切换

在 OpenClaw 中配置任务路由，根据任务类型自动选择模型：

{
  "routing": {
    "vision": "bigmodel/glm-4.6v-flash",
    "coding": "bigmodel/glm-4.7-flash",
    "image": "bigmodel/cogview-3-flash"
  }
}

2. 长上下文优化

glm-4.7-flash 支持 200K 上下文，适合：

完整代码库分析
长篇小说创作/分析
多文档联合处理

建议： 启用上下文缓存（cache）减少重复 token 消耗。

3. 多模态工作流

结合 glm-4.6v-flash 的视觉工具调用能力：

1. 上传网页截图 → glm-4.6v-flash 分析布局
2. 生成 HTML 代码 → glm-4.7-flash 优化逻辑
3. 生成配图 → cogview-3-flash 创建素材
4. 整合输出 → 完整页面

⚠️ 注意事项

速率限制

免费模型有速率限制，查看当前限制： https://www.bigmodel.cn/usercenter/proj-mgmt/rate-limits

建议：

高频任务添加本地缓存
批量处理时控制并发
关键任务准备备用模型

模型选择建议

任务类型	推荐模型	理由
日常对话	glm-4.7-flash	响应快、中文优化
代码开发	glm-4.7-flash	Agentic Coding 强化
图片理解	glm-4.6v-flash	原生多模态
视频分析	glm-4.6v-flash	时序融合、关键帧提取
文档解析	glm-4.6v-flash	跨页逻辑、复杂表格
图像生成	cogview-3-flash	多分辨率、快速

成本控制

虽然免费，但建议：

监控 API 用量（控制台实时查看）
本地缓存重复查询结果
长文本任务启用上下文缓存

🔧 故障排查

问题 1：配置后无法调用

检查：

# 测试 API Key 有效性
curl -X POST "https://open.bigmodel.cn/api/paas/v4/chat/completions" \
  -H "Authorization: Bearer 你的 API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-4.7-flash","messages":[{"role":"user","content":"test"}]}'

解决：

确认 API Key 正确
检查网络（国内直连，无需代理）
验证 openclaw.json 语法

问题 2：响应速度慢

原因： 免费模型可能有排队 解决：

避开高峰时段（工作日 9-11 点、14-16 点）
降低 max_tokens 参数
启用流式输出（stream: true）

问题 3：多模态任务失败