My clawdbot machine is on a ubuntu server, while my node is a windows, I want to pair them via localhost and/or tailscale, but it both failed and showed "node host gateway connect failed: pairing required
gateway connect failed: Error: pairing required". I've read the post https://discord.com/channels/1456350064065904867/1465145937772154974, but it did not work for me. I want it work under localhost first. pls help.
#node host gateway connect failed: pairing requiredgateway connect failed: Error: pairing required
1 messages Β· Page 1 of 1 (latest)
Here is my gateway config:"
lm2@lm2ubuntu:~$ cat ~/.clawdbot/clawdbot.json
{
...
"gateway": {
"port": 18789,
"mode": "local",
"bind": "lan",
"auth": {
"mode": "token",
"token": "..."
},
"tailscale": {
"mode": "off",
"resetOnExit": false
}
},
.
}
}
}
}
" the clawdbot status from my node machine:"Diagnosis (read-only)
Gateway connection details:
Gateway target: ws://127.0.0.1:18789
Source: local loopback
Config: C:\Users\lazymark2.clawdbot\clawdbot.json
Bind: loopback
β Config: C:\Users\lazymark2.clawdbot\clawdbot.json
β Restart sentinel: none
β Port 18789
β Tailscale: off Β· Running Β· lm2.tail4db525.ts.net
ips: 100.83.121.25, fd7a:115c:a1e0::3f01:798d
β Skills: 6 eligible Β· 0 missing Β· C:\Users\lazymark2\clawd
! Channel issues skipped (gateway unreachable)
Gateway health:
connect failed: connect ECONNREFUSED 127.0.0.1:18789
Pasteable debug report. Auth tokens redacted.
Troubleshooting: https://docs.clawd.bot/troubleshooting
β".
Based on the docs, the "pairing required" error means your Windows node is trying to connect but hasn't been approved yet. Here's how to fix it:
On the Ubuntu gateway server:
1. Check for pending pairing requests:
clawdbot nodes pending
2. Approve the request (replace <requestId> with the actual ID):
clawdbot nodes approve <requestId>
3. Verify the connection:
clawdbot nodes status
For localhost connections:
Make sure your Ubuntu gateway is binding to allow local connections. Check the gateway status:
clawdbot gateway status
If it shows bind=loopback (127.0.0.1), localhost connections should work. If you need to connect from another machine on your LAN, you'll need to either:
- Use Tailscale (which provides a secure VPN-like connection)
- Or configure
gateway.bindtolan(0.0.0.0) with proper auth
For Tailscale connections:
The Discord post you referenced mentions using Tailscale. Make sure:
- Tailscale is installed and running on both machines
- They're on the same tailnet
- The Ubuntu gateway can reach the Windows node via its Tailscale IP
Quick checklist:
- [ ] Run
clawdbot nodes pendingon the Ubuntu gateway - [ ] Approve the pending request
- [ ] Verify
clawdbot nodes statusshows the Windows node as paired/connected
Let me know what you see when you run clawdbot nodes pending on the Ubuntu server! π¦