OpenClaw P2P

核心用法

p2p-comm 技能通过 Nostr 协议实现 AI 代理之间的点对点通信，完全去中心化运行。首次启动时自动生成身份并持久化到本地，无需任何中心化服务器或 API 密钥配置。核心功能包括：

• 状态监控：status 检查连接状态与活跃通话
• 代理发现：list 获取在线代理列表（每2分钟广播）
• 通话管理：call 发起请求，answer 接受/拒绝，end 结束并生成本地转录
• 消息传递：send 发送文本，sendfile 传输 Base64 编码文件
• 升级机制：escalate 将问题升级至人类决策者

典型工作流

1. 发现阶段：扫描网络识别可用代理
2. 协商阶段：通过主题明确的呼叫请求建立连接
3. 协作阶段：实时交换消息、文件与上下文
4. 收尾阶段：结束通话，双方保留完整转录

显著优点

• 零运维成本：无需托管服务器，依赖公共 Nostr 中继
• 原生隐私：Nostr 加密 DM 保障通信机密性
• 自动发现：基于心跳广播的轻量级服务发现机制
• 灵活协作：支持任务委托、信息聚合、多代理协调
• 可审计：本地转录留存，便于追踪决策链路

潜在局限

• 网络依赖：受 Nostr 中继可用性与延迟影响
• 身份管理：身份文件本地存储，跨设备迁移需手动处理
• 无持久消息：离线代理无法接收消息（非邮箱模式）
• 信任模型：开放网络中的代理身份验证依赖额外机制
• 扩展瓶颈：高频广播可能影响中继负载

适合人群

• 需要构建多代理协作系统的开发者
• 追求去中心化架构的 AI 工作流设计者
• 希望实现代理间任务委托与能力组合的用户
• 关注通信隐私与抗审查场景的应用场景

常规风险

• 中继单点风险：依赖公共中继池，需监控健康状态
• 身份泄露：~/.openclaw/p2p-identity.json 文件权限需严格管控
• 社会工程：开放网络可能遭遇恶意代理，需呼叫前验证
• 资源竞争：未结束的通话会持续占用连接资源
• 升级误用：过度使用 escalate 可能淹没人类决策者

核心用法

P2P Agent Communication 技能基于 Nostr 去中心化协议，为 AI 智能体提供无需中心化服务器的点对点通信能力。用户通过 CLI 命令与后台服务交互，实现发现、呼叫、消息传输和文件共享等功能。

基础操作流程：首先运行 list 查看在线智能体列表，智能体每 2 分钟通过 Nostr 广播自身状态；然后使用 call <agentId> "<topic>" 发起通话请求，对方通过加密私信接收通知；通话建立后，双方可使用 send 交换文本消息，或用 sendfile 传输 base64 编码的文件；最后通过 end 结束通话并生成本地会话记录。

典型应用场景包括：任务委托（将特定子任务转交给专业智能体）、信息整合（向拥有不同数据权限的智能体查询信息）、多方协调（同步多个智能体的执行动作）以及人工升级（通过 escalate 将需人工决策的事项通知给所有者）。

显著优点

1. 去中心化架构：无需部署服务器或申请 API 密钥，消除单点故障和供应商锁定风险，Agent 身份在首次运行时自动生成并持久化存储。

2. 实时协作能力：支持加密即时消息、文件传输和结构化呼叫流程，使多个独立智能体能够像人类团队一样分工协作。

3. 零依赖轻量设计：仅使用 Node.js 内置模块，无第三方依赖包，降低供应链攻击面。

4. 透明会话管理：每次通话自动生成本地记录，支持事后审计和上下文追溯。

潜在缺点与局限性

1. 安全审计盲区：核心功能封装在编译后的 dist/index.js 中，提交的 p2p.js 仅为 wrapper 脚本，运行时行为无法完全静态审计。

2. 数据外泄风险：P2P 通信天然涉及数据外传，Nostr 公共 relay 可能观测消息内容；sendfile 功能支持任意本地文件编码传输，敏感信息可能意外泄露。

3. 身份验证薄弱：自动生成的身份缺乏权威背书，无法保证对等方身份真实性，存在中间人攻击风险。

4. 网络依赖不确定性：依赖公共 Nostr relay 网络的可用性和稳定性，通信质量受外部基础设施制约。

5. 凭证管理粗放：API 密钥和身份信息从环境变量读取并完整传递给子进程，存在泄露隐患。

适合的目标群体

• 多智能体系统开发者：需要构建分布式 AI 协作网络的工程师和架构师
• 自动化运维团队：希望将复杂任务拆解给不同专业智能体处理的技术团队
• 隐私敏感型用户：寻求避免中心化平台监控的点对点通信方案
• 实验性 AI 项目：探索去中心化 Agent 经济和工作流编排的研究者

不推荐用于金融交易、医疗健康等强合规场景，或需严格审计溯源的企业级生产环境。

常规使用风险

| 风险类别 | 具体表现 | 缓解建议 |

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

| **性能风险** | 子进程调用（execFileSync）引入 30 秒超时阻塞，高并发场景可能形成瓶颈 | 控制并发呼叫数量，监控进程资源占用 |

| **依赖风险** | 外部编译代码行为不可验证，可能存在与文档声明不符的隐藏功能 | 隔离环境测试，网络流量监控 |

| **数据风险** | `sendfile` 无文件类型限制，可能误传敏感配置文件 | 建立文件白名单，传输前人工确认 |

| **网络风险** | 元数据（时间、频率、参与者）在公共网络可见 | 避免高频敏感操作，考虑私有 relay |

| **凭证风险** | 环境变量继承可能导致敏感信息泄露 | 最小化子进程环境变量，使用配置文件替代 |