u-desk/docs/08-用户指南/GLM4.7-配置指南.md

Clawdbot + GLM-4.7 快速配置

你的配置：国内用户 + GLM Coding Plan 套餐（GLM-4.7）

通信方式：Web 控制面板

目标：5 分钟完成配置

---

🚀 快速配置（WSL2）

第 1 步：进入 WSL2

在 Windows PowerShell 中运行：

wsl

第 2 步：配置 GLM-4.7

在 WSL2 Ubuntu 终端中运行（一键复制）：

# 配置 GLM-4.7（替换你的 API KEY）
echo 'export OPENAI_BASE_URL="https://open.bigmodel.cn/api/paas/v4/"' >> ~/.bashrc && \
echo 'export OPENAI_API_KEY="你的GLM_API_KEY"' >> ~/.bashrc && \
echo 'export MODEL_NAME="glm-4-plus"' >> ~/.bashrc && \
source ~/.bashrc && \
echo "✅ 配置完成！验证如下：" && \
echo "BASE_URL: $OPENAI_BASE_URL" && \
echo "API_KEY: ${OPENAI_API_KEY:0:15}..." && \
echo "MODEL: $MODEL_NAME"

重要：

• 使用 glm-4-plus 作为模型名称（GLM-4.7 的别名）
• 如果套餐中指定了其他模型名称，按套餐说明修改

第 3 步：验证 API 连接

# 测试 GLM-4.7 API
curl -X POST $OPENAI_BASE_URL/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "glm-4-plus",
    "messages": [{"role": "user", "content": "你好，请用中文回复"}]
  }'

如果返回 JSON 响应包含 AI 回复，说明配置成功！✅

第 4 步：安装并启动 Clawdbot

# 安装 Clawdbot（如果还没安装）
npm install -g clawdbot@latest

# 启动网关（前台运行，测试用）
clawdbot gateway --port 18789 --verbose

第 5 步：访问 Web 界面

在浏览器中打开：

http://localhost:18789/

如果无法访问：

# 在 PowerShell（管理员）中运行，配置端口转发
# 先获取 WSL2 IP
wsl hostname -I

# 然后配置端口转发（假设 WSL2 IP 是 172.x.x.x）
netsh interface portproxy add v4tov4 listenport=18789 listenaddress=0.0.0.0 connectport=18789 connectaddress=172.x.x.x

现在访问 http://localhost:18789/ 应该可以打开控制面板了！

---

🎯 GLM-4.7 套餐模型说明

GLM Coding Plan 支持的模型

根据你的套餐类型，可以使用以下模型：

模型名称	说明	适用场景
glm-4-plus	GLM-4.7 旗舰版	复杂推理、代码生成、多模态
glm-4-flash	快速响应版	日常对话、简单任务
glm-4-air	高性价比版	生产环境
glm-4-0520	代码专用版	编程辅助

推荐配置：

• 如果你有 Pro/Max 套餐：使用 glm-4-plus
• 如果你有 Lite 套餐：使用 glm-4-flash 或 glm-4-air

修改模型

如果需要切换模型：

# 编辑配置
vim ~/.bashrc

# 修改 MODEL_NAME
export MODEL_NAME="glm-4-plus"  # 或其他模型

# 重新加载
source ~/.bashrc

# 重启 Clawdbot
# Ctrl+C 停止，然后重新运行
clawdbot gateway --port 18789

---

⚠️ GLM 套餐验证

验证是否使用套餐额度

方法 1：查看控制台

1. 访问 智谱AI控制台 - 套餐使用
2. 发送几条测试消息
3. 查看"套餐使用情况"是否减少

方法 2：使用 curl 测试

# 发送测试请求
curl -X POST $OPENAI_BASE_URL/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "glm-4-plus",
    "messages": [{"role": "user", "content": "测试"}]
  }' -v

# 查看返回的速率限制头部
# 如果显示套餐相关的限制信息，说明使用了套餐

如果消耗账户余额而非套餐

原因：Clawdbot 不在 GLM 官方支持列表中

解决方案：使用 One-API 中转

# 安装 One-API
docker run -d --name one-api -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v /root/data/one-api:/data \
  ghcr.io/songquanpeng/one-api:latest

# 访问 http://localhost:3000
# 配置 GLM 套餐渠道

# 修改 Clawdbot 配置使用 One-API
export OPENAI_BASE_URL="http://localhost:3000/v1"
export OPENAI_API_KEY="sk-one-api-token"

# 重启 Clawdbot

---

📊 GLM-4.7 性能特点

GLM-4.7 是智谱AI 2025 年 12 月发布的最新旗舰模型：

• ✅ Vibe Coding 能力：编程能力全球开源第一
• ✅ 200K 长上下文：支持长文本处理
• ✅ 多模态支持：文本、图像、代码
• ✅ 复杂推理：数学、科学、逻辑问题
• ✅ 工具调用：Function Calling、思考模式

在 Clawdbot 中的使用场景

1. 代码生成：请帮我写一个 Python 快速排序
2. 长文本分析：分析这个 100 页的 PDF 文档
3. 复杂推理：如何优化这个算法的时间复杂度？
4. 多轮对话：保持上下文的深度讨论
5. 工具调用：让 AI 调用外部 API 完成任务

---

🔧 常用命令

# 启动 Clawdbot（前台）
clawdbot gateway --port 18789 --verbose

# 启动 Clawdbot（后台）
nohup clawdbot gateway --port 18789 > ~/clawdbot.log 2>&1 &

# 查看日志
tail -f ~/clawdbot.log

# 停止服务
ps aux | grep clawdbot
kill <进程ID>

# 查看配置
echo $OPENAI_BASE_URL
echo $OPENAI_API_KEY
echo $MODEL_NAME

# 测试 API
curl -X POST $OPENAI_BASE_URL/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-4-plus","messages":[{"role":"user","content":"测试"}]}'

---

❓ 常见问题

Q1: 如何确认使用的是 GLM-4.7？

A: 查看日志或测试响应：

# 启动时添加详细日志
clawdbot gateway --port 18789 --verbose

# 在日志中查找模型信息
grep -i "model\|glm" ~/clawdbot.log

Q2: 套餐额度不够用怎么办？

A: 有三个选择：

1. 等待 5 小时：套餐额度会自动刷新
2. 升级套餐：Lite → Pro → Max
3. 多账号轮换：使用 One-API 配置多个账号

Q3: GLM-4.7 和其他模型的区别？

A:

特性	GLM-4-Flash	GLM-4-Air	GLM-4-Plus (GLM-4.7)
速度	最快	快	中等
质量	基础	良好	最佳
成本	免费	低	中等
适用	测试	生产	复杂任务

Q4: Web 界面访问不了？

A: 检查防火墙和端口：

# 检查端口是否监听
netstat -tlnp | grep 18789

# 检查防火墙
sudo ufw status

# 如果防火墙开启，允许端口
sudo ufw allow 18789

# Windows 防火墙（PowerShell 管理员）
New-NetFirewallRule -DisplayName "Clawdbot" -Direction Inbound -LocalPort 18789 -Protocol TCP -Action Allow

Q5: 如何设置开机自启？

A: 使用 systemd 服务（前面已有完整配置）

---

🎉 完成！

现在你已经成功配置了：

• ✅ Clawdbot（在 WSL2 中运行）
• ✅ GLM-4.7（使用你的套餐）
• ✅ Web 控制面板（浏览器访问）

访问地址：http://localhost:18789/

开始使用：在 Web 界面中与 GLM-4.7 对话！

---

📚 下一步

1. 测试对话：在 Web 界面发送"你好"
2. 尝试功能：让 AI 帮你写代码、分析文档
3. 配置自动化：设置定时任务、消息推送
4. 探索高级功能：浏览器操作、文件管理等

祝使用愉快！🚀

有问题随时问我！