Cloud-Local Bridge

# Cloud-Local Bridge

让云端和本地 OpenClaw 实例无缝协同，支持自然语言配对、文件互通、命令远程执行。

核心特性

✅ 自然语言配对 - 不用记指令，像聊天一样说"我想连接云端" ✅ 跨通道配对 - QQ/微信/Telegram/邮件都能完成配对 ✅ 2步完成 - 像添加微信好友一样简单

⚡ 自然语言配对

直接发送自然语言

| 你发送 | 机器人回应 | |--------|-----------| | `配对` | 收到配对码 | | `我想连接云端` | 收到配对码 | | `添加设备` | 收到配对码 | | `配对 847291` | 配对成功 | | `查看配对` | 显示已连接设备 | | `帮助配对` | 显示帮助 |

支持的自然语言

• 发起配对：
• `配对`、`我要配对`、`想配对`
• `连接`、`连接云端`、`连接本地`
• `添加设备`、`添加云端`、`添加好友`
• `关联设备`、`互相关联`
• `pair`、`connect`

• 确认配对：
• `配对 123456`

• 查看状态：
• `查看配对`、`配对状态`
• `我的设备`、`设备列表`

• 取消：
• `取消配对`、`删除设备`

📱 配对流程

1. ```
2. 用户 A（本地） 用户 B（云端）
3. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
4. 发送「我想连接云端」 (等待)
5. ↓
6. 收到配对码: 847291
7. ↓
8. 发送配给 B (接收配对码)
9. ↓ 4. B 发送「配对 847291」
10. ↓
11. ✅ 配对成功! ✅ 配对成功!
12. ```

🚀 快速启动

```bash cd /root/.openclaw/workspace/skills/cloud-local-bridge/scripts

# 启动 Bridge 服务 python3 bridge_server.py --port 8080 --token "xxx" ```

🔧 组件说明

| 文件 | 说明 | |------|------| | `qq_handler.py` | 自然语言配对处理器 | | `bridge_server.py` | Bridge 服务端 | | `bridge_client.py` | Bridge 客户端 | | `sync_files.py` | 文件同步 |

💡 使用场景

场景1：QQ 配对

``` 你：我想连接云端 机器人：📱 发起配对成功！配对码：847291

（你把配对码发给云端用户）

云端用户：配对 847291 机器人：🎉 配对成功！已连接本地电脑 ```

场景2：跨平台配对

``` 本地（QQ）：配对 → 收到 582391 → 通过 QQ 发送给云端 云端（Telegram）：发送配对请求到 API → 配对成功 ```

📁 文件结构

``` cloud-local-bridge/ ├── SKILL.md ├── scripts/ │ ├── qq_handler.py # 🆕 自然语言处理器 │ ├── bridge_server.py # 服务端 │ ├── bridge_client.py # 客户端 │ └── sync_files.py # 文件同步 └── references/ └── EXAMPLES.md ```

⚠️ 注意事项

• 配对码 10 分钟后过期
• 配对状态保存在 `~/.openclaw/bridge_pairing_state.json`
• 确保网络互通