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

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