yggdrasil-setup

What This Skill Does

The yggdrasil-setup skill is a specialized diagnostic and management tool for the OpenClaw AI agent, specifically designed to handle Yggdrasil network integration. Yggdrasil acts as a decentralized, encrypted IPv6 overlay network that provides every OpenClaw instance with a unique, globally-routable address derived directly from its cryptographic Ed25519 keypair. By facilitating this setup, the skill enables true peer-to-peer (P2P) communication across disparate machines, bypassing the limitations of traditional NATs and firewalls. Without this, your agent remains isolated to a local or containerized environment, rendering it unreachable by external peers. This skill automates the verification of the daemon's state, helps users distinguish between local test modes and public-facing connectivity, and provides guided installation paths.

Installation

To integrate this skill into your OpenClaw environment, use the command-line interface provided by the hub. Execute the following command in your terminal:

clawhub install openclaw/skills/skills/jing-yilin/yggdrasil

Once installed, the plugin will interface with the system daemon. After successful installation, always remember to restart your OpenClaw gateway. This restart is critical, as it allows the gateway to perform a handshake with the Yggdrasil daemon, ensuring that your agent properly broadcasts its presence on the network. You can verify the installation at any time by triggering the check function, which will output your current IPv6 routable address if successfully configured.

Use Cases

This skill is essential for decentralized collaborative workflows. Use it when you are preparing to share data or services with another agent instance. Specifically, use this skill if you encounter connection errors during p2p_send_message execution, as it acts as your primary diagnostic tool to verify network layer health. It is also the go-to tool for onboarding: if a user asks about their agent's reachability or requests a connection string, the skill provides the definitive, routable address necessary to initiate a P2P handshake. Finally, use this skill to troubleshoot "silent failures" where messages are sent but never arrive, identifying if the underlying routing daemon has crashed or failed to bind to the interface.

Example Prompts

1. "Hey OpenClaw, can you check if I am reachable by other agents on the internet right now?"
2. "I'm trying to send a file to another agent, but it says the connection failed. Can you diagnose my network status?"
3. "What is my P2P address? I need to share it with my teammate so they can sync their agent with mine."

Tips & Limitations

Always check the yggdrasil_check() output status carefully. If the status is test_mode, do not attempt to share that address with peers outside your local network, as it will be inaccessible. If the status returns derived_only, it indicates that the Yggdrasil daemon is not running; you must install or start the service before the agent can participate in the P2P network. Note that Yggdrasil setup requires appropriate network permissions on your host machine to create virtual interfaces; ensure your environment configuration allows for TUN/TAP device creation. If you face issues post-installation, verify that your firewall is not blocking the Yggdrasil port (default: 9001).