核心用法
ClawBot Network 是 OpenClaw 的分布式协作扩展，通过中央服务器将运行在 VPS、MacBook、Mac Mini 等不同设备上的 OpenClaw 实例连接为统一网络。核心工作流程分为三步：
1. 部署中央服务器：在 VPS 上启动 Node.js 服务（WebSocket 3002 端口 + REST API 3001 端口）
2. 连接客户端：通过一键安装脚本或 Python SDK 将各设备的 clawdbot 接入网络
3. 协作通信：实现群聊、@提及、任务指派、离线消息队列等功能
Python SDK 提供高级抽象层，支持装饰器模式处理消息（@bot.on_message）、提及（@bot.on_mention）和任务（@bot.on_task），可与 OpenClaw 原生的 sessions_spawn 无缝集成。
显著优点
- 架构简洁：星型拓扑，单中央服务器管理多客户端，部署成本低
- 功能完整：覆盖即时通信、任务分发、离线补偿、自动重连等企业级需求
- 多设备原生：自动检测 MacBook/Mac Mini/Linux 设备类型
- 低门槛接入：提供一键安装脚本和高级 Python SDK，非专业用户也可快速部署
- OpenClaw 深度集成：任务可直接触发
sessions_spawn执行子代理
潜在缺点与局限性
- 单点故障：中央服务器宕机则全网瘫痪，无高可用设计
- 安全基础薄弱：默认 HTTP/WebSocket 明文传输，无内置认证机制，需依赖外部 Nginx + SSL 加固
- 扩展性瓶颈：SQLite 单机存储、Node.js 单进程架构，难以支撑大规模节点
- 网络依赖严格：客户端需持续维护 WebSocket 长连接，弱网环境重连风暴风险
- 无权限体系：所有接入节点理论上可互相 @ 和指派任务，缺乏角色隔离
适合人群
- 个人开发者或小型团队：拥有 2-5 台设备（VPS + 本地机器）需协同管理
- 边缘计算场景：需要在家庭服务器、办公电脑、云主机间分发任务
- OpenClaw 重度用户：希望将单设备 AI 助手扩展为多设备智能体网络
- 原型验证阶段：快速搭建分布式代理通信 PoC，后续可迁移至更健壮方案
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 中间人攻击 | HTTP/WSS 未强制启用，敏感指令可能被截获 | 必须配置 Nginx + SSL，切换至 wss:// |
| 未授权接入 | 无 token/密钥验证，任何人可连入网络 | 添加防火墙白名单，实施 token 认证 |
| 指令注入 | 任务内容直接传递给 `sessions_spawn`，存在命令注入可能 | 对 task['description'] 做输入校验和沙箱隔离 |
| 服务拒绝 | 无速率限制，恶意节点可洪泛消息 | 增加消息队列背压和 IP 限流 |
| 数据持久化 | SQLite 单文件存储，损坏后消息历史丢失 | 定期备份 + 考虑迁移至 PostgreSQL |
总体评估：作为个人/小团队的分布式协作工具具有实用价值，但生产环境必须完成安全加固，不建议直接暴露于公网。