/install ipv6-p2p
IPv6 P2P
Direct agent-to-agent messaging over Yggdrasil IPv6. Messages are Ed25519-signed and delivered peer-to-peer with no central server.
Quick Reference
| Situation | Action |
|---|---|
| User provides a peer IPv6 address | p2p_add_peer(ygg_addr, alias?) |
| User wants to send a message | p2p_send_message(ygg_addr, message, port?) |
| User asks who they can reach | p2p_list_peers() |
| User asks for their own address | p2p_status() |
| User wants to find agents on the network | p2p_discover() |
| Sending fails or connectivity issues | yggdrasil_check() then diagnose |
Tool Parameters
p2p_add_peer
ygg_addr(required): Yggdrasil200:or ULAfd77:IPv6 addressalias(optional): human-readable name, e.g. "Alice"
p2p_send_message
ygg_addr(required): recipient addressmessage(required): text contentport(optional, default 8099): recipient's P2P port — pass explicitly if the peer uses a non-default port
p2p_discover
No parameters. Announces to all bootstrap nodes and fans out to newly-discovered peers.
p2p_status
Returns: own address, known peer count, unread inbox count.
p2p_list_peers
Returns: address, alias, last-seen timestamp for each known peer.
Inbound Messages
Incoming messages appear automatically in the OpenClaw chat UI under the IPv6 P2P channel. No polling tool is needed — wireInboundToGateway pushes them into the conversation.
Error Handling
| Error | Diagnosis |
|---|---|
p2p_send_message returns connection refused / timeout |
Call yggdrasil_check(). If derived_only → Yggdrasil not running. If yggdrasil → peer is down or port blocked. |
p2p_discover returns 0 new peers |
Bootstrap nodes may be unreachable. Retry later or check network. |
| TOFU key mismatch (403 from peer) | Peer rotated keys. User must re-add with p2p_add_peer. |
Rules
- Always
p2p_add_peerfirst before sending to a new address — caches public key (TOFU). - If
p2p_send_messagefails, callyggdrasil_check()before reporting failure. - Never invent IPv6 addresses — always ask the user explicitly.
- Valid formats:
200:xxxx::x(Yggdrasil mainnet) orfd77:xxxx::x(ULA/test).
See references/flows.md for example interaction patterns.
See references/discovery.md for how peer discovery works.
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install ipv6-p2p - 安装完成后,直接呼叫该 Skill 的名称或使用
/ipv6-p2p触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Ipv6 P2p 是什么?
Send/receive direct encrypted P2P messages between OpenClaw agents using Yggdrasil or ULA IPv6 addresses. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 315 次。
如何安装 Ipv6 P2p?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install ipv6-p2p」即可一键安装,无需额外配置。
Ipv6 P2p 是免费的吗?
是的,Ipv6 P2p 完全免费(开源免费),可自由下载、安装和使用。
Ipv6 P2p 支持哪些平台?
Ipv6 P2p 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Ipv6 P2p?
由 Yilin(@jing-yilin)开发并维护,当前版本 v0.1.3。