新增：文档体系重构+CHANGELOG补充+发布产物清理

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

@@ -0,0 +1,308 @@
+# 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. **探索高级功能**：浏览器操作、文件管理等
+
+祝使用愉快！🚀
+
+有问题随时问我！