概述

Yggdrasil Setup

Yggdrasil gives every OpenClaw agent a globally-routable 200::/8 IPv6 address derived from their Ed25519 keypair. Without it, P2P addresses are local-only.

Quick Reference

Situation	Action
---	---
"Is P2P working?" / "Can I connect?"	`yggdrasil_check()`, explain result
"What is my address?" (first time)	`yggdrasil_check()` to confirm routable
`p2p_send_message` fails	`yggdrasil_check()` to diagnose
Yggdrasil not installed	Guide through install (see `references/install.md`)
User asks what Yggdrasil is	Explain briefly, offer to install

Interpreting yggdrasil_check Results

Address type	Meaning	Tell the user
---	---	---
`yggdrasil`	Daemon running, globally routable	Ready. Share the address with peers.
`test_mode`	Local/Docker only	Fine for testing on the same machine. Not reachable by internet peers.
`derived_only`	Yggdrasil not running	Address is NOT reachable. Install Yggdrasil first.

Troubleshooting derived_only

If yggdrasil_check() returns derived_only after install:

Binary not on PATH: Run which yggdrasil. If not found, add to PATH or reinstall.
Gateway not restarted: The plugin detects the binary at startup. Restart the OpenClaw gateway.
Permission denied: On Linux, Yggdrasil needs CAP_NET_ADMIN to create a TUN interface. Run as root or use setcap.
Docker: Container needs --cap-add=NET_ADMIN and --device=/dev/net/tun.

After Install

Restart the OpenClaw gateway.
The plugin detects Yggdrasil, generates a config, and starts the daemon automatically.
Call yggdrasil_check() to confirm the routable 200: address.

See references/install.md for platform-specific install commands.

版本历史

共 1 个版本

v0.1.3 当前

2026-03-30 06:19 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)