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

2026-05-01 22:22:06 +08:00
parent 3e1a540b83
commit 6eaaa56eb6
164 changed files with 40346 additions and 64 deletions
--- a/docs/08-用户指南/clawdbot国内用户配置方案.md
+++ b/docs/08-用户指南/clawdbot国内用户配置方案.md
@@ -0,0 +1,395 @@
+# Clawdbot 国内用户通信方案
+
+> **你的情况**：国内用户 + GLM 套餐
+>
+> **限制**：无法使用 WhatsApp/Telegram
+>
+> **解决方案**：使用 Web 界面或其他国内平台
+
+---
+
+## 🎯 推荐方案（按优先级）
+
+### 方案 1：Web 控制面板 ⭐ 最简单
+
+**优点**：
+- ✅ 无需额外配置
+- ✅ 直接在浏览器使用
+- ✅ 功能完整
+- ✅ 无需翻墙
+
+**使用方法**：
+
+1. 启动 Clawdbot 网关
+   ```bash
+   # WSL2 中运行
+   clawdbot gateway --port 18789 --verbose
+   ```
+
+2. 浏览器访问
+   ```
+   http://localhost:18789/
+   ```
+
+3. 如果配置了 Token，粘贴 Token 到设置中
+
+4. 开始对话！
+
+**适用场景**：
+- 本地开发测试
+- 个人使用
+- 不需要移动端访问
+
+---
+
+### 方案 2：钉钉机器人
+
+**优点**：
+- ✅ 国内可用
+- ✅ 支持消息推送
+- ✅ 支持群聊和私聊
+- ✅ 企业友好
+
+**配置步骤**：
+
+#### 1. 创建钉钉机器人
+
+1. 打开钉钉电脑版
+2. 进入某个群聊
+3. 点击右上角"群设置" → "智能群助手"
+4. 点击"添加机器人" → "自定义"
+5. 机器人名称：`Clawdbot`
+6. 安全设置：选择"自定义关键词"，输入 `AI`
+7. 创建后获取 **Webhook URL**
+
+#### 2. 创建中转服务
+
+由于 Clawdbot 原生不支持钉钉，需要创建一个简单的中转服务：
+
+```bash
+# 创建项目目录
+mkdir ~/clawdbot-dingtalk
+cd ~/clawdbot-dingtalk
+
+# 创建中转脚本
+cat > dingtalk-bridge.py << 'EOF'
+from flask import Flask, request, jsonify
+import requests
+import os
+
+app = Flask(__name__)
+
+CLAWDBOT_API = os.getenv("CLAWDBOT_API", "http://localhost:18789")
+WEBHOOK_URL = os.getenv("DINGTALK_WEBHOOK")
+
+@app.route('/dingtalk/webhook', methods=['POST'])
+def dingtalk_webhook():
+    data = request.json
+    content = data.get('text', {}).get('content', '')
+
+    # 发送到 Clawdbot
+    response = requests.post(f"{CLAWDBOT_API}/api/message", json={
+        "message": content
+    })
+
+    # 获取回复并发送到钉钉
+    if response.status_code == 200:
+        reply = response.json().get('reply', '处理中...')
+        requests.post(WEBHOOK_URL, json={"msgtype": "text", "text": {"content": reply}})
+
+    return jsonify({"status": "ok"})
+
+if __name__ == '__main__':
+    app.run(port=5000)
+EOF
+
+# 安装依赖
+pip install flask requests
+
+# 配置环境变量
+echo 'export DINGTALK_WEBHOOK="你的钉钉Webhook URL"' >> ~/.bashrc
+echo 'export CLAWDBOT_API="http://localhost:18789"' >> ~/.bashrc
+source ~/.bashrc
+
+# 启动中转服务
+python dingtalk-bridge.py
+```
+
+#### 3. 配置钉钉机器人 Webhook
+
+在钉钉机器人设置中，将 Webhook URL 设置为：
+```
+http://你的服务器IP:5000/dingtalk/webhook
+```
+
+**使用**：
+在钉钉群聊中发送：`AI 你好`
+
+---
+
+### 方案 3：飞书机器人
+
+**优点**：
+- ✅ 国内可用
+- ✅ 功能强大
+- ✅ 支持富文本
+- ✅ 开发友好
+
+**配置步骤**：
+
+#### 1. 创建飞书应用
+
+1. 访问 [飞书开放平台](https://open.feishu.cn/)
+2. 创建企业自建应用
+3. 获取 App ID 和 App Secret
+4. 启用机器人能力
+
+#### 2. 配置事件订阅
+
+类似于钉钉方案，需要创建中转服务接收飞书事件并转发到 Clawdbot。
+
+**详细文档**：[飞书机器人开发指南](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM)
+
+---
+
+### 方案 4：企业微信机器人
+
+**优点**：
+- ✅ 国内可用
+- ✅ 企业级
+- ✅ 安全稳定
+
+**配置步骤**：
+
+1. 在企业微信群聊中添加机器人
+2. 获取 Webhook URL
+3. 参考钉钉方案创建中转服务
+
+---
+
+### 方案 5：微信公众号（高级）
+
+**优点**：
+- ✅ 随时随地使用
+- ✅ 无需翻墙
+- ✅ 用户友好
+
+**缺点**：
+- 需要服务器域名备案
+- 配置复杂
+
+**适用场景**：需要公开服务或团队使用
+
+---
+
+### 方案 6：命令行 + 定时推送
+
+**优点**：
+- ✅ 最简单
+- ✅ 无需额外配置
+- ✅ 适合开发者
+
+**使用方法**：
+
+```bash
+# 发送消息给 Clawdbot
+clawdbot message send --message "帮我分析这段代码"
+
+# 查看回复
+clawdbot message list
+```
+
+**结合定时任务**：
+
+```bash
+# 创建定时任务脚本
+cat > ~/daily-ai-report.sh << 'EOF'
+#!/bin/bash
+# 每天早上 9 点生成 AI 报告
+clawdbot message send --message "生成今日工作计划"
+EOF
+
+chmod +x ~/daily-ai-report.sh
+
+# 添加到 crontab
+crontab -e
+# 添加：0 9 * * * ~/daily-ai-report.sh
+```
+
+---
+
+### 方案 7：浏览器扩展 + 本地服务
+
+**优点**：
+- ✅ 在浏览器中使用
+- ✅ 支持所有网页
+- ✅ 可视化好
+
+**实现方式**：
+
+1. Clawdbot 提供 Web API
+2. 开发简单的浏览器扩展
+3. 在任意网页上与 AI 对话
+
+---
+
+## 🎯 推荐配置组合
+
+### 个人开发
+- **Web 控制面板**（主要）
+- **命令行**（辅助）
+
+### 小团队
+- **Web 控制面板**
+- **钉钉机器人**（团队协作）
+
+### 企业使用
+- **企业微信机器人**
+- **飞书应用**
+- **Web 控制面板**（备用）
+
+---
+
+## 🚀 快速开始（Web 控制面板）
+
+这是最简单的方式，无需额外配置：
+
+### 第 1 步：安装 Clawdbot（WSL2）
+
+```bash
+# 打开 WSL2
+wsl
+
+# 安装 Node.js 22
+curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
+sudo apt-get install -y nodejs
+
+# 安装 Clawdbot
+npm install -g clawdbot@latest
+```
+
+### 第 2 步：配置 GLM
+
+```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-flash"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+### 第 3 步：启动网关
+
+```bash
+# 前台运行（测试）
+clawdbot gateway --port 18789 --verbose
+
+# 或后台运行
+nohup clawdbot gateway --port 18789 > ~/clawdbot.log 2>&1 &
+```
+
+### 第 4 步：访问 Web 界面
+
+在浏览器中打开：
+
+```
+http://localhost:18789/
+```
+
+**如果访问不了**：
+
+```bash
+# 检查 WSL2 IP
+ip addr show eth0
+
+# 或者使用 localhost 端口转发
+# 在 PowerShell（管理员）中运行：
+netsh interface portproxy add v4tov4 listenport=18789 listenaddress=0.0.0.0 connectport=18789 connectaddress=$(wsl hostname -I)
+```
+
+### 第 5 步：开始对话
+
+在 Web 界面中输入消息，开始与 AI 对话！
+
+---
+
+## 💡 进阶配置
+
+### 允许局域网访问
+
+如果你想在手机或其他设备上访问：
+
+```bash
+# 启动时绑定所有网卡
+clawdbot gateway --port 18789 --host 0.0.0.0 --verbose
+
+# 查看你的 WSL2 IP
+ip addr show eth0 | grep inet
+# 假设显示：inet 172.x.x.x
+
+# 在手机浏览器访问
+# http://172.x.x.x:18789/
+```
+
+### 设置开机自启
+
+```bash
+# 创建 systemd 服务
+sudo cat > /etc/systemd/system/clawdbot.service << 'EOF'
+[Unit]
+Description=Clawdbot AI Assistant
+After=network.target
+
+[Service]
+Type=simple
+User=你的用户名
+WorkingDirectory=/home/你的用户名
+Environment="OPENAI_BASE_URL=https://open.bigmodel.cn/api/paas/v4/"
+Environment="OPENAI_API_KEY=你的GLM_API_KEY"
+Environment="MODEL_NAME=glm-4-flash"
+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
+```
+
+---
+
+## 🎉 总结
+
+作为国内用户，最佳方案是：
+
+1. **主要使用**：Web 控制面板（http://localhost:18789）
+2. **团队协作**：钉钉/飞书机器人
+3. **开发者**：命令行 + Web 界面
+
+**快速开始（3 分钟）**：
+
+```bash
+# 1. 进入 WSL2
+wsl
+
+# 2. 配置 GLM-4.7
+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
+
+# 3. 启动服务
+clawdbot gateway --port 18789
+
+# 4. 浏览器访问
+# http://localhost:18789/
+```
+
+就这么简单！有任何问题随时问我 🚀