OpenClaw Connection Guide (tailnet setup)

Connect your phone app to an OpenClaw gateway running on your Tailnet.

1. 1) Join the same Tailnet

   Connect both devices to Tailscale: your phone (running Claw To Talk) and the machine running OpenClaw.

   

2. 2) Configure OpenClaw gateway

   In ~/.openclaw/openclaw.json, ensure your gateway has these values:

   "gateway": {
     "port": 18789,
     "mode": "local",
     "bind": "tailnet"
   }

   Then restart gateway: openclaw gateway restart

3. 3) Find MagicDNS hostname

   While Tailscale is connected, locate your OpenClaw host name (for example, claw.tailxxx.ts.net).

   

4. 4) Enter connection details in app

   In Claw To Talk, use: ws://<hostname>:18789

   You can copy your gateway token from ~/.openclaw/openclaw.json or ask your OpenClaw agent for it.

5. 5) Pair and approve the device

   On first connect, the app requests pairing. Approve the request from your OpenClaw host:

   

   openclaw devices list
   openclaw devices approve <device-id>

   

   After approval, retry connect in the app.