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

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

@@ -0,0 +1,356 @@
+# Windows + Clawdbot + GLM-4.7 配置指南
+
+> **准确步骤**：从零开始，10 分钟完成配置
+>
+> **你的环境**：Windows + WSL2 + GLM Coding Plan (GLM-4.7)
+
+---
+
+## 第一步：打开 WSL2 Ubuntu
+
+在 Windows 中，按 `Win + R`，输入：
+```
+wsl
+```
+
+**或者**：打开 PowerShell，输入 `wsl` 回车
+
+---
+
+## 第二步：配置 GLM-4.7（在 WSL2 中执行）
+
+### 复制以下命令，粘贴到 WSL2 终端
+
+```bash
+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
+```
+
+**重要**：
+- 将 `你的GLM_API_KEY` 替换为你的真实 API Key
+- 不要删除引号
+
+### 验证配置
+
+```bash
+echo $OPENAI_BASE_URL
+echo $OPENAI_API_KEY
+echo $MODEL_NAME
+```
+
+应该显示：
+- `https://open.bigmodel.cn/api/paas/v4/`
+- 你的 API Key
+- `glm-4-plus`
+
+---
+
+## 第三步：安装 Node.js 22（如果还没安装）
+
+在 WSL2 中执行：
+
+```bash
+curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
+sudo apt-get install -y nodejs
+```
+
+验证安装：
+```bash
+node --version
+```
+应该显示：`v22.x.x`
+
+---
+
+## 第四步：安装 Clawdbot
+
+在 WSL2 中执行：
+
+```bash
+npm install -g clawdbot@latest
+```
+
+验证安装：
+```bash
+clawdbot --version
+```
+
+---
+
+## 第五步：启动 Clawdbot
+
+在 WSL2 中执行：
+
+```bash
+clawdbot gateway --port 18789
+```
+
+**看到以下输出说明成功**：
+```
+[INFO] Gateway starting on port 18789
+[INFO] Ready
+```
+
+---
+
+## 第六步：访问 Web 界面
+
+### 在 Windows 浏览器中打开
+
+```
+http://localhost:18789/
+```
+
+### 如果访问不了
+
+**在 PowerShell（管理员）中执行**：
+
+```powershell
+# 1. 获取 WSL2 IP
+wsl hostname -I
+
+# 2. 配置端口转发（替换下面的 IP 地址）
+netsh interface portproxy add v4tov4 listenport=18789 listenaddress=0.0.0.0 connectport=18789 connectaddress=172.x.x.x
+```
+
+再次访问 `http://localhost:18789/`
+
+---
+
+## 第七步：测试对话
+
+在 Web 界面中输入：
+```
+你好
+```
+
+如果收到回复，配置成功！✅
+
+---
+
+## 完整配置命令（复制即用）
+
+### 在 WSL2 中一次性执行：
+
+```bash
+# 1. 配置 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 && \
+
+# 2. 安装 Node.js 22（如果需要）
+curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && \
+sudo apt-get install -y nodejs && \
+
+# 3. 安装 Clawdbot
+npm install -g clawdbot@latest && \
+
+# 4. 启动服务
+clawdbot gateway --port 18789
+```
+
+---
+
+## 常用操作
+
+### 查看 Clawdbot 日志
+
+启动时添加 `--verbose`：
+```bash
+clawdbot gateway --port 18789 --verbose
+```
+
+### 后台运行
+
+```bash
+nohup clawdbot gateway --port 18789 > ~/clawdbot.log 2>&1 &
+```
+
+查看日志：
+```bash
+tail -f ~/clawdbot.log
+```
+
+### 停止服务
+
+```bash
+ps aux | grep clawdbot
+kill <进程ID>
+```
+
+### 重启服务
+
+```bash
+# 停止
+ps aux | grep clawdbot
+kill <进程ID>
+
+# 启动
+clawdbot gateway --port 18789
+```
+
+---
+
+## 验证 GLM-4.7 连接
+
+在 WSL2 中执行：
+
+```bash
+curl -X POST https://open.bigmodel.cn/api/paas/v4/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $OPENAI_API_KEY" \
+  -d '{
+    "model": "glm-4-plus",
+    "messages": [{"role": "user", "content": "你好"}]
+  }'
+```
+
+如果返回 JSON 包含 AI 回复，说明 API 连接正常。
+
+---
+
+## 配置文件位置
+
+```
+~/.bashrc                 # 环境变量配置
+~/.clawdbot/              # Clawdbot 配置目录
+  ├── config.json         # 主配置文件
+  └── workspace/          # 工作空间
+```
+
+---
+
+## 故障排查
+
+### 问题 1：`node: command not found`
+
+**解决**：安装 Node.js 22
+```bash
+curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
+sudo apt-get install -y nodejs
+```
+
+### 问题 2：`clawdbot: command not found`
+
+**解决**：安装 Clawdbot
+```bash
+npm install -g clawdbot@latest
+```
+
+### 问题 3：浏览器访问不了 `localhost:18789`
+
+**解决**：检查服务是否启动
+```bash
+ps aux | grep clawdbot
+```
+
+如果没有运行，重新启动：
+```bash
+clawdbot gateway --port 18789
+```
+
+### 问题 4：配置没生效
+
+**解决**：重新加载环境变量
+```bash
+source ~/.bashrc
+```
+
+验证配置：
+```bash
+echo $OPENAI_BASE_URL
+echo $OPENAI_API_KEY
+echo $MODEL_NAME
+```
+
+### 问题 5：API 返回错误
+
+**检查**：
+1. API Key 是否正确
+2. 网络是否正常
+3. 套餐是否有效
+
+测试网络：
+```bash
+curl -I https://open.bigmodel.cn
+```
+
+---
+
+## 快速检查清单
+
+配置完成后，逐项检查：
+
+- [ ] WSL2 可以正常使用
+- [ ] `node --version` 显示 v22.x.x
+- [ ] `clawdbot --version` 显示版本号
+- [ ] `echo $OPENAI_API_KEY` 显示你的 API Key
+- [ ] `echo $MODEL_NAME` 显示 `glm-4-plus`
+- [ ] `curl` 测试 API 返回正常
+- [ ] `clawdbot gateway` 启动成功
+- [ ] 浏览器可以访问 `http://localhost:18789/`
+- [ ] Web 界面可以发送消息并收到回复
+
+全部勾选 ✅ = 配置成功！
+
+---
+
+## 下一步
+
+配置成功后，你可以：
+
+1. **开始对话**：在 Web 界面与 GLM-4.7 对话
+2. **尝试功能**：让 AI 帮你写代码、分析文档
+3. **设置自启**：配置开机自动启动（见下方）
+
+---
+
+## 开机自动启动（可选）
+
+在 WSL2 中执行：
+
+```bash
+# 创建 systemd 服务
+sudo cat > /etc/systemd/system/clawdbot.service << 'EOF'
+[Unit]
+Description=Clawdbot AI Assistant
+After=network.target
+
+[Service]
+Type=simple
+User=$USER
+WorkingDirectory=/home/$USER
+Environment="OPENAI_BASE_URL=https://open.bigmodel.cn/api/paas/v4/"
+Environment="OPENAI_API_KEY=$OPENAI_API_KEY"
+Environment="MODEL_NAME=glm-4-plus"
+ExecStart=/usr/bin/clawdbot gateway --port 18789
+Restart=always
+
+[Install]
+WantedBy=multi-user.target
+EOF
+
+# 启动服务
+sudo systemctl daemon-reload
+sudo systemctl enable clawdbot
+sudo systemctl start clawdbot
+
+# 查看状态
+sudo systemctl status clawdbot
+```
+
+---
+
+## 完成！
+
+现在你的 Windows 电脑上已经运行着：
+- ✅ Clawdbot（24/7 AI 助手）
+- ✅ GLM-4.7（最新旗舰模型）
+- ✅ Web 界面（浏览器访问）
+
+**访问地址**：http://localhost:18789/
+
+**开始使用吧！** 🚀