# Clawdbot + GLM-4.7 快速配置

> **你的配置**：国内用户 + GLM Coding Plan 套餐（GLM-4.7）
>
> **通信方式**：Web 控制面板
>
> **目标**：5 分钟完成配置

---

## 🚀 快速配置（WSL2）

### 第 1 步：进入 WSL2

在 Windows PowerShell 中运行：

```powershell
wsl
```

### 第 2 步：配置 GLM-4.7

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

```bash
# 配置 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 连接

```bash
# 测试 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

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

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

### 第 5 步：访问 Web 界面

在浏览器中打开：

```
http://localhost:18789/
```

**如果无法访问**：

```bash
# 在 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`

### 修改模型

如果需要切换模型：

```bash
# 编辑配置
vim ~/.bashrc

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

# 重新加载
source ~/.bashrc

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

---

## ⚠️ GLM 套餐验证

### 验证是否使用套餐额度

**方法 1：查看控制台**

1. 访问 [智谱AI控制台 - 套餐使用](https://open.bigmodel.cn/usercenter/billing)
2. 发送几条测试消息
3. 查看"套餐使用情况"是否减少

**方法 2：使用 curl 测试**

```bash
# 发送测试请求
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 中转

```bash
# 安装 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 完成任务

---

## 🔧 常用命令

```bash
# 启动 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**: 查看日志或测试响应：

```bash
# 启动时添加详细日志
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**: 检查防火墙和端口：

```bash
# 检查端口是否监听
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. **探索高级功能**：浏览器操作、文件管理等

祝使用愉快！🚀

有问题随时问我！