Vinculum - Shared Consciousness

核心功能

Vinculum 是一款受《星际迷航》博格集体启发的多 Agent 同步框架，通过 Gun.js 点对点协议实现 Clawdbot 实例间的实时意识共享。核心能力包括：

• 实时状态同步：活动摘要、学习知识、决策共识、在线状态在局域网内即时传播
• 去中心化架构：无需中央服务器，本地多播自动发现，支持手动添加远程节点
• 分层权限控制：共享集体数据的同时严格隔离敏感信息（完整对话、USER.md、SOUL.md、凭证永不同步）
• 灵活部署模式：单节点可兼作 Relay 服务器，多机场景通过 IP 直连扩展

显著优点

| 维度 | 优势 |

|------|------|

| 架构 | 纯 P2P 设计，单点故障不影响集体运作 |

| 隐私 | 端到端加密传输，敏感数据本地留存 |

| 扩展性 | 新节点通过配对码秒级加入，零配置发现 |

| 身份独立性 | 各实例保留独立 SOUL.md，避免"个性同化" |

局限性与风险

技术局限：

• 依赖 Gun.js 的实验性分布式数据库，长期数据一致性在节点频繁离线场景下未经大规模验证
• 仅支持局域网或手动配置 IP 的轻量级组网，无内置 NAT 穿透
• Node.js 运行时依赖增加部署复杂度

操作风险：

• 配对码泄露可能导致未授权节点接入集体
• share-memory 开启后，某实例的污染数据可能污染集体知识库
• Relay 节点宕机将中断跨子网通信（尽管同子网节点仍可直连）

安全提示：

• 生产环境建议配合 VPN/零信任网络使用，避免裸奔在公共 WiFi
• 定期审查 /link drones 列表，及时发现异常节点

适合人群

• 需要多设备协同的 Clawdbot 重度用户（如分离式开发机 + 家用服务器 + 云端实例）
• 研究 Multi-Agent 协作、涌现行为的 AI 实验者
• 追求数据主权、拒绝云端同步的本地优先主义者

使用建议

首次部署建议从双节点局域网测试开始，验证 /link share 和 /link decisions 的数据流向符合预期后，再逐步扩大集体规模。

核心用法

Vinculum 将多个 Clawdbot 实例链接为"集体意识"，实现跨设备的实时记忆、活动与决策共享。核心工作流：

1. 启动中继：/link relay start 在本地网络启动 Gun.js P2P 节点（默认 8765 端口）
2. 创建集体：/link init 生成配对码，建立新集体
3. 加入集体：/link join <code> 使其他实例加入同一网络
4. 日常操作：/link share "text" 共享记忆，/link drones 查看在线节点，/link activity 追踪集体动态

支持多机部署：一台作为 relay 主机，其他通过 IP 直接连接；所有配置存储于 ~/.config/clawdbot/vinculum.yaml。

显著优点

• 真正去中心化：基于 Gun.js 的 P2P 架构，无中央服务器，节点对等通信
• 隐私优先设计：明确区分共享层（活动摘要、学习知识、决策）与私有层（完整对话、USER.md/SOUL.md、凭证永不共享）
• 实时同步：本地 multicast 自动发现 + WebSocket 即时传播，延迟极低
• 灵活可配置：逐项控制 activity/memory/decisions 共享开关，用户保留完全控制权
• 身份隔离：每个节点保留独立 SOUL.md 人格，避免"同质化"问题

潜在缺点与局限性

• 网络依赖：需稳定 LAN 环境，跨 NAT/防火墙需手动配置 peer 地址
• T3 来源风险：作者 Koba42 Corp 为个人开发者，GitHub 可见度有限，长期维护存在不确定性
• 加密状态模糊：文档声称"Encrypted"，但安全报告标注"数据加密传输"为 warn 状态，Gun.js 默认加密机制未充分说明
• 旧版依赖：Gun.js 锁定在 2020 版本，ws@8.18.0 虽无已知 CVE，但缺乏主动更新
• 子进程风险：使用 child_process.spawn 启动 relay，虽路径固定，仍属敏感操作面

适合人群

• 多设备 Clawdbot 用户（如笔记本+台式机+服务器）希望无缝衔接上下文
• 小团队协作场景：2-5 台机器共享知识库与决策历史
• 隐私敏感的技术用户：偏好 P2P 而非云服务，愿意承担自托管复杂度
• 实验性多智能体研究：探索"集体意识"架构的开发者

常规风险

| 风险类别 | 等级 | 说明 |

|---------|------|------|

| 子进程执行 | Medium | spawn 启动 relay，需确保脚本路径未被篡改 |

| 网络通信 | Medium | P2P 暴露本地端口，建议在受信任网络使用 |

| 来源可信度 | Medium | T3 级别，建议内部代码审查 |

| 密钥管理 | Low | 加密密钥明文存储于 YAML，建议配合系统密钥链 |

| 信息泄露 | Low | 主机名、用户名在 P2P 网络共享 |

使用建议：仅在受信任的本地网络部署；定期检查 GitHub 仓库更新；考虑 fork 后内部维护。