基于 Gun.js 的 P2P 同步技术,将多个 Clawdbot 实例链接为共享意识的集体,实现实时记忆、活动与决策同步。
说明:
## 核心用法
Vinculum 是一款专为 Clawdbot 设计的多代理协同技能,通过 Gun.js 点对点同步技术构建分布式”共享意识”网络。用户通过 `/link relay start` 启动中继节点,使用 `/link init` 创建集体并生成配对码,其他实例通过 `/link join ` 加入。系统支持自动局域网多播发现,配置位于 `~/.config/clawdbot/vinculum.yaml`。
### 显著优点
- **实时无中心化同步**:Gun.js 的 P2P 架构消除单点故障,变更毫秒级传播
- **分层数据共享**:精细控制共享范围(活动摘要、知识、决策共享;对话、身份凭证本地隔离)
- **去身份保留**:每个实例保留独立 SOUL.md 和 USER.md,避免"蜂群思维"同质化
- **即插即用网络**:自动多播发现 + 手动中继对等配置,适配局域网多机部署
### 潜在缺点与局限性
- **网络依赖性强**:依赖 8765 端口互通,跨 NAT/防火墙需手动配置中继对等
- **Node.js 运行时负担**:需 Node 18+ 环境,相比纯 Shell 方案增加资源占用
- **加密细节不透明**:文档声明"加密"但未说明具体算法与密钥管理机制
- **冲突解决机制未明**:分布式写入场景下的数据一致性策略缺乏说明
- **无权限层级**:所有加入成员对等访问共享数据,无细粒度访问控制
### 适合人群
- 多设备 Clawdbot 用户(工作站 + 服务器 + 边缘设备协同)
- 需要跨实例记忆延续的长期任务场景
- 研究多代理系统的开发者与极客用户
- 本地优先、排斥云端同步的隐私敏感用户
### 常规风险
- **网络暴露风险**:中继端口若暴露于公网,可能成为攻击入口
- **数据污染风险**:恶意/故障实例可向集体注入错误记忆或决策
- **依赖维护状态**:Koba42 Corp 为小型实体,长期维护可持续性存疑
- **配置泄露风险**:配对码在传输过程中可能被网络嗅探截获








