ClawdBotAI LogoClawdBotAI
HomeDocsPlatformsLinux

Linux

The Gateway is fully supported on Linux

Overview

The Gateway is fully supported on Linux. Node is the recommended runtime. Bun is not recommended for the Gateway (WhatsApp/Telegram bugs).

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

Install

Follow the Getting Started guide.

Optional flows:

Gateway service install (CLI)

Use one of these:

clawdbot onboard --install-daemon

Or:

clawdbot gateway install

Or:

clawdbot configure

Select Gateway service 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.

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
WindowsiOS