clawdbot/docs/platforms/linux.md

summary, read_when

summary	read_when
Linux support + companion app status	Looking for Linux companion app status Planning platform coverage or contributions

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

• Getting Started
• Install & updates
• Optional flows: Bun, Nix, Docker

Gateway

• Gateway runbook
• Configuration

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[-<profile>].service:

[Unit]
Description=Clawdbot Gateway (profile: <profile>, v<version>)
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[-<profile>].service