Skip to main content

​
Linux App

The Gateway is fully supported on Linux. The core is written in TypeScript, so it runs anywhere Node or Bun runs. Native Linux companion apps are planned. Contributions are welcome if you want to help build one.

​
Beginner quick path (VPS)

  1. Install Node 22+
  2. npm i -g clawdbot@latest
  3. clawdbot onboard --install-daemon
  4. From your laptop: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
  5. Open http://127.0.0.1:18789/ and paste your token
Step-by-step VPS guide: exe.dev

​
Install

​
Gateway

​
Gateway service install (CLI)

Use one of these: 
clawdbot onboard --install-daemon
Or: 
clawdbot daemon install
Or: 
clawdbot configure
Select Gateway daemon when prompted. Repair/migrate: 
clawdbot doctor

​
System control (systemd user unit)

Clawdbot installs a systemd user service by default. Use a system service for shared or always-on servers. The full unit example and guidance live in the Gateway runbook. Minimal setup: Create ~/.config/systemd/user/clawdbot-gateway.service: 
[Unit]
Description=Clawdbot Gateway
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/clawdbot gateway --port 18789
Restart=always
RestartSec=5

[Install]
WantedBy=default.target
Enable it: 
systemctl --user enable --now clawdbot-gateway.service