← Back to Skills Marketplace
315
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install ipv6-p2p
Description
Send/receive direct encrypted P2P messages between OpenClaw agents using Yggdrasil or ULA IPv6 addresses.
README (SKILL.md)
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.
Usage Guidance
This skill intends to run a peer-discovery and P2P service that will contact external bootstrap endpoints, announce your agent's address/public key, and serve endpoints to peers. Before installing, ask the publisher these questions: (1) Will the '@resciencelab/declaw' Node package be installed automatically? If so, provide the exact install source (registry or GitHub release). (2) Where and how are Ed25519 keys generated, stored, and protected? Are persistent keys written to disk and to which path? (3) Which remote endpoints will be contacted (confirm the bootstrap URL and any fallback addresses) and can discovery/gossip be disabled or limited? (4) Does the agent open a listening port, and can you restrict or opt out of listening? If you cannot verify the package source and key/storage behavior, run this in an isolated environment or decline installation. Because the registry and SKILL.md disagree about installation, treat the skill as untrusted until the author clarifies those gaps.
Capability Analysis
Type: OpenClaw Skill
Name: ipv6-p2p
Version: 0.1.3
The skill bundle is designed for legitimate IPv6 P2P messaging between agents, with clear documentation and operational instructions. There is no evidence of intentional malicious behavior, such as data exfiltration, unauthorized execution, or persistence mechanisms. The external network call to `https://resciencelab.github.io/DeClaw/bootstrap.json` in `references/discovery.md` is for a stated and necessary purpose (fetching bootstrap nodes for peer discovery in a decentralized system) and does not indicate malicious intent, although it represents a standard supply chain dependency risk inherent in such systems. The `SKILL.md` contains no prompt injection attempts.
Capability Assessment
Purpose & Capability
The name/description (Yggdrasil/IPv6 P2P messaging) matches the instructions (peer discovery, signed messages, gossip). However SKILL.md contains an install metadata entry (node package "@resciencelab/declaw") while the registry manifest lists no install spec — mismatch between claimed runtime dependency and the registry. Also the skill implies it will sign messages with Ed25519 keys but does not declare where keys come from or how they are managed.
Instruction Scope
The runtime instructions direct the agent to fetch a remote bootstrap list and POST /peer/announce to remote nodes, fan-out to other peers, run a periodic gossip loop, and serve /peer endpoints locally. Those actions will cause network traffic to external endpoints and can expose the agent's P2P address and public key. While these actions are expected for a P2P feature, the SKILL.md gives the agent broad discretion to announce and communicate with arbitrary peers and does not clarify consent, logging, or key storage — increasing the chance of unintended data leakage or persistent network activity.
Install Mechanism
No install spec is present in the registry manifest (skill marked instruction-only), but SKILL.md includes install metadata pointing to a Node package (@resciencelab/declaw). This inconsistency is problematic: either the skill depends on an external package that won't be installed automatically, or an installation step is missing/undeclared. Both possibilities are a red flag because an undeclared install step could mean required code won't run or could be performed ad-hoc without clear review.
Credentials
The skill requests no environment variables or credentials (good), but it requires Ed25519 signing and TOFU key caching. SKILL.md and references do not say how keys are generated, stored, or protected (no config paths declared). Absence of declared secrets is proportional to the stated purpose, but the missing key management details are a gap that should be clarified before trust.
Persistence & Privilege
The skill describes running a startup announce and a periodic gossip loop (every 10 minutes) and serving HTTP endpoints. Although 'always' is false, the skill expects to maintain ongoing network presence and perform background announcements. Combined with autonomous model invocation being allowed, this increases the operational blast radius (periodic external network calls and listening on ports) and requires explicit user consent and clear operational controls that are not documented here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ipv6-p2p - After installation, invoke the skill by name or use
/ipv6-p2p - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.3
Complete skill docs: add all tool params, error handling table, inbound message explanation, discovery reference
v0.1.2
ipv6-p2p v0.1.2
- Added peer discovery section: agents now support automatic peer discovery via bootstrapping and gossip.
- Documented the new `p2p_discover()` function for finding other agents on the network.
- Expanded usage instructions to explain the peer discovery mechanism and periodic gossip.
- Updated install instructions and homepage URLs to `declaw`.
- Added configuration example for discovery settings.
v0.1.0
Initial release
Metadata
Frequently Asked Questions
What is Ipv6 P2p?
Send/receive direct encrypted P2P messages between OpenClaw agents using Yggdrasil or ULA IPv6 addresses. It is an AI Agent Skill for Claude Code / OpenClaw, with 315 downloads so far.
How do I install Ipv6 P2p?
Run "/install ipv6-p2p" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Ipv6 P2p free?
Yes, Ipv6 P2p is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Ipv6 P2p support?
Ipv6 P2p is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Ipv6 P2p?
It is built and maintained by Yilin (@jing-yilin); the current version is v0.1.3.
More Skills