Enable globally-routable IPv6 addresses for P2P agent communication using Yggdrasil.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install yggdrasil
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install yggdrasil using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Yggdrasil Connectivity?
The Yggdrasil skill is a critical networking component for Openclaw Skills, providing every AI agent with a unique, globally-routable 200::/8 IPv6 address. By leveraging Ed25519 keypairs, this skill moves beyond local-only networking, allowing agents to communicate securely across the internet without complex firewall configurations or NAT traversal issues. It serves as the backbone for decentralized, peer-to-peer agent interactions within the ecosystem.
This skill acts as a diagnostic and management layer for the Yggdrasil daemon. It ensures that the underlying networking infrastructure is healthy, the daemon is active, and the agent's identity is correctly mapped to a reachable network address. For developers building distributed AI systems, this skill is essential for maintaining reliable connectivity between remote nodes and ensuring high availability in Openclaw Skills deployments.
Yggdrasil Connectivity Use Cases
- Verifying if an agent is globally reachable for P2P communication within Openclaw Skills.
- Troubleshooting failed message delivery between remote AI agents.
- Retrieving and confirming a routable IPv6 address for peer sharing.
- Diagnosing installation issues or permission errors within Docker environments.
- Guiding users through the setup process when global connectivity is missing.
How Yggdrasil Connectivity Works
- The skill executes the yggdrasil_check() function to probe the local environment for the Yggdrasil binary and running daemon.
- It analyzes the system response to determine the current connectivity state: fully routable, local/test mode, or derived-only.
- If Yggdrasil is detected, it automatically handles configuration generation and daemon startup within the Openclaw Skills gateway.
- It provides actionable feedback to the agent or user, such as identifying missing system capabilities (CAP_NET_ADMIN) or PATH issues.
- It facilitates the transition from local development to global P2P deployment by ensuring the Ed25519-based address is active and correctly shared across the Openclaw Skills network.
Yggdrasil Connectivity Setup
To enable global P2P networking for your agents, install the necessary package via npm and ensure the Yggdrasil binary is available on your system path to work with Openclaw Skills:
npm install @resciencelab/declaw
For Linux environments, ensure the process has CAP_NET_ADMIN privileges to manage the TUN interface. If running within Docker, use the following flags to allow Openclaw Skills to manage networking:
docker run --cap-add=NET_ADMIN --device=/dev/net/tun ...
After installation, restart the gateway to allow the plugin to detect the binary and initialize the daemon automatically.
Yggdrasil Connectivity Data Schema & Taxonomy
The skill organizes connectivity status and address metadata to provide clear diagnostics for Openclaw Skills. The following table describes the interpretation of result states:
| State | Description | Accessibility |
|---|---|---|
| yggdrasil | Daemon is active and configured | Globally routable via 200::/8 |
| test_mode | Local or Docker-only environment | Restricted to local machine peers |
| derived_only | Daemon is not running | Unreachable; requires installation |
All addresses are cryptographically derived from the agent's unique Ed25519 keypair, ensuring consistent identity and security across the Openclaw Skills network.
Yggdrasil Connectivity Advanced Features
- Automatic daemon lifecycle management upon Openclaw Skills gateway startup.
- Advanced support for CAP_NET_ADMIN capability detection in Linux environments.
- Docker-specific configuration support for containerized agent deployments using Openclaw Skills.
- Seamless integration with P2P messaging protocols for automated failover diagnostics.
- Dynamic address generation based on cryptographic keypairs to ensure secure agent-to-agent identity verification.
SKILL.md
Loading
Related Openclaw Skills
MagicBox Node.js Development Standard
A comprehensive development standard and best practices guide for building scalable Node.js and TypeScript applications.
Activity Logger
A lightweight skill for capturing AI agent conversations into structured daily Markdown files.
ClawHub Auto Update
Automatically manages versioning and updates for all your installed ClawHub skills to ensure your AI agents stay up to date.
Apple WeatherKit Skill
A professional-grade integration for fetching granular weather data and extended forecasts directly from Apple's WeatherKit API.
Markdown Canvas Renderer
A high-efficiency tool to convert markdown files into visually appealing HTML pages for browser viewing or Canvas display.
WeChat Image Generator
A high-efficiency tool for creating WeChat-optimized images like covers and charts without relying on expensive image generation tokens.
METADATA
Featured*
