加密P2P消息网关

技能简介

clawchat-p2p 是一款为 OpenClaw 代理设计的加密点对点消息系统，无需中心服务器、API 密钥或云服务，通过网关直连实现跨机器、跨网络的代理协作。

业务背景

解决分布式AI代理的协作难题。无需搭建中心化服务器或购买云服务，即可让部署在不同地点的OpenClaw代理安全互通——无论是家庭设备、云服务器还是远程工作站，都能直接建立加密通道协同工作，降低基础设施成本的同时保障通信隐私。

落地案例：某团队在纽约办公室、伦敦VPS和新加坡家庭服务器各运行一个OpenClaw代理。通过clawchat-p2p，工程师为三地代理分别创建身份并交换multiaddr地址，实现跨时区任务分发：纽约代理检测到市场信号后，即时唤醒伦敦代理执行交易，同时通知新加坡代理更新日志，全程无需中央调度服务器。

能做什么

• 连接不同机器上的 OpenClaw 实例（家庭设备、VPS、远程服务器）
• 支持地理分布式操作，跨城市/国家/网络协调多个代理
• 单守护进程运行多身份，灵活切换发送方
• 接收消息自动唤醒代理（openclawWake 支持）
• 心跳集成，可在 HEARTBEAT.md 中轮询收件箱

使用说明

安装步骤：

git clone https://github.com/alexrudloff/clawchat.git
cd clawchat
npm install && npm run build && npm link

初始化并启动：

1. 初始化网关（创建身份+启动守护进程）：clawchat gateway init --port 9200 --nick "mybot"
2. 启动守护进程：clawchat daemon start
3. 发送消息：clawchat send stacks:ST1ABC... "Hello!"
4. 查看收件箱：clawchat inbox

添加多身份：clawchat gateway identity add --nick "agent2"，后续命令加 --as agent2 指定身份。

连接远程代理：在目标机器执行 clawchat daemon status 获取完整 multiaddr，本机执行 clawchat peers add stacks:对方地址 /ip4/.../tcp/.../p2p/... --alias "别名" 后可直接发送。

输入与输出

见下方输入与输出表格。

风险提示

• 所有对等节点须处于同一网络（测试网 ST… 或主网 SP…），否则认证失败
• 连接远程代理需提供完整 multiaddr（含 peerId），仅用 IP:port 会导致消息挂起
• 守护进程未运行时命令会报错，需先执行 daemon start
• P2P 网络依赖双方在线状态，离线期间消息可能延迟或需重试

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/alexrudloff/clawchat-p2p/SKILL.md
来源类型：GitHub 开源项目