agentskillexchange Diagnose OpenClaw node pairing and route failures
Guides an agent through the exact route, pairing, and auth checks needed when an OpenClaw companion node fails to connect over LAN, Tailscale, or a public URL. Use it when a node setup is broken and you need diagnosis, not when you simply want to list devices or advertise OpenClaw itself.
Prerequisites
openclaw CLI, optional Tailscale CLI
Installation
Use the upstream install or setup path that matches your environment:
- npm install -g openclaw@latest
- Use pnpm for source checkouts. The repository is a pnpm workspace, and bundled
- git clone https://github.com/openclaw/openclaw.git
- pnpm install
Requirements and caveats from upstream:
- Runtime: Node 24 (recommended) or Node 22.19+.
- Public inbound DMs require an explicit opt-in: set dmPolicy="open" and include "*" in the channel allowlist (allowFrom / channels.discord.allowFrom / channels.slack.allowFrom; legacy: channels.discord.dm.allowFrom, ch...
- Group/channel safety: set agents.defaults.sandbox.mode: "non-main" to run non-main sessions inside sandboxes. Docker is the default sandbox backend; SSH and OpenShell backends are also available.
Basic usage or getting-started notes:
OpenClaw is a personal AI assistant you run on your own devices.
Website · Docs · Vision · DeepWiki · Getting Started · [Updat...
New install? Start here: Getting started
Source: https://github.com/openclaw/openclaw/tree/main/skills/node-connect
Extracted from upstream docs: https://raw.githubusercontent.com/openclaw/openclaw/HEAD/README.md