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

Documentation

• https://github.com/openclaw/openclaw/tree/main/skills/node-connect

Source

• Agent Skill Exchange