u-desk/docs/08-用户指南/clawdbot国内用户配置方案.md

Clawdbot 国内用户通信方案

你的情况：国内用户 + GLM 套餐

限制：无法使用 WhatsApp/Telegram

解决方案：使用 Web 界面或其他国内平台

---

🎯 推荐方案（按优先级）

方案 1：Web 控制面板 ⭐ 最简单

优点：

• ✅ 无需额外配置
• ✅ 直接在浏览器使用
• ✅ 功能完整
• ✅ 无需翻墙

使用方法：

1. 启动 Clawdbot 网关

   # 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 原生不支持钉钉，需要创建一个简单的中转服务：

# 创建项目目录
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. 访问 飞书开放平台
2. 创建企业自建应用
3. 获取 App ID 和 App Secret
4. 启用机器人能力

2. 配置事件订阅

类似于钉钉方案，需要创建中转服务接收飞书事件并转发到 Clawdbot。

详细文档：飞书机器人开发指南

---

方案 4：企业微信机器人

优点：

• ✅ 国内可用
• ✅ 企业级
• ✅ 安全稳定

配置步骤：

1. 在企业微信群聊中添加机器人
2. 获取 Webhook URL
3. 参考钉钉方案创建中转服务

---

方案 5：微信公众号（高级）

优点：

• ✅ 随时随地使用
• ✅ 无需翻墙
• ✅ 用户友好

缺点：

• 需要服务器域名备案
• 配置复杂

适用场景：需要公开服务或团队使用

---

方案 6：命令行 + 定时推送

优点：

• ✅ 最简单
• ✅ 无需额外配置
• ✅ 适合开发者

使用方法：

# 发送消息给 Clawdbot
clawdbot message send --message "帮我分析这段代码"

# 查看回复
clawdbot message list

结合定时任务：

# 创建定时任务脚本
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）

# 打开 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

# 配置环境变量
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 步：启动网关

# 前台运行（测试）
clawdbot gateway --port 18789 --verbose

# 或后台运行
nohup clawdbot gateway --port 18789 > ~/clawdbot.log 2>&1 &

第 4 步：访问 Web 界面

在浏览器中打开：

http://localhost:18789/

如果访问不了：

# 检查 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 对话！

---

💡 进阶配置

允许局域网访问

如果你想在手机或其他设备上访问：

# 启动时绑定所有网卡
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/

设置开机自启

# 创建 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 分钟）：

# 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/

就这么简单！有任何问题随时问我 🚀