CLI to connect Clawdbot gateways to OpenClawHQ
npm install clawdbot-hqConnect your Clawdbot gateway to OpenClawHQ for monitoring and management.
``bashOne-time connection test
npx clawdbot-hq connect --token "hq_your_token_here"
Get Your Token
1. Sign in at openclawhq.com
2. Go to Settings → Gateway
3. Copy your HQ token (starts with
)Commands
`bash
Connect with token
clawdbot-hq connect --token "hq_xxx"Connect and keep running (recommended)
clawdbot-hq connect --token "hq_xxx" --daemonReconnect with saved credentials
clawdbot-hq reconnect --daemonCheck connection status
clawdbot-hq statusDisconnect gateway
clawdbot-hq disconnect
`How It Works
Your gateway sends heartbeats to OpenClawHQ every 30 seconds:
Gateway (anywhere) → OpenClawHQ API → Firestore → Dashboard
Works through NAT/firewalls — the gateway makes outbound connections, so no port forwarding needed.
Options
| Option | Description |
|--------|-------------|
|
, -t | Your OpenClawHQ token |
| --daemon, -d | Keep running and send heartbeats |
| --interval | Heartbeat interval in seconds (default: 30) |Running as a Service
$3
`bash
Create plist
cat > ~/Library/LaunchAgents/com.clawdbot.hq.plist << 'EOF'
Label
com.clawdbot.hq
ProgramArguments
/usr/local/bin/npx
clawdbot-hq
reconnect
--daemon
RunAtLoad
KeepAlive
EOFLoad service
launchctl load ~/Library/LaunchAgents/com.clawdbot.hq.plist
`$3
bash
Create service file
sudo cat > /etc/systemd/system/clawdbot-hq.service << 'EOF'
[Unit]
Description=Clawdbot HQ Connection
After=network.target[Service]
Type=simple
ExecStart=/usr/bin/npx clawdbot-hq reconnect --daemon
Restart=always
User=your-username
[Install]
WantedBy=multi-user.target
EOF
Enable and start
sudo systemctl enable clawdbot-hq
sudo systemctl start clawdbot-hq
`Troubleshooting
"Invalid token" — Make sure you're using the token from Settings → Gateway, not your API key.
"Connection failed" — Check your internet connection. The gateway needs outbound HTTPS access to openclawhq.com.
Gateway shows offline — Make sure the daemon is running. Check with
- OpenClawHQ Dashboard
- Clawdbot Documentation
- GitHub Issues
MIT