clawdbot/docs/platforms/index.md

summary, read_when

summary	read_when
Platform support overview (Gateway + companion apps)	Looking for OS support or install paths Deciding where to run the Gateway

Platforms

Clawdbot core is written in TypeScript. Node is the recommended runtime. Bun is not recommended for the Gateway (WhatsApp/Telegram bugs).

Companion apps exist for macOS (menu bar app) and mobile nodes (iOS/Android). Windows and Linux companion apps are planned, but the Gateway is fully supported today. Native companion apps for Windows are also planned; the Gateway is recommended via WSL2.

Choose your OS

• macOS: macOS
• iOS: iOS
• Android: Android
• Windows: Windows
• Linux: Linux

VPS & hosting

• Hetzner (Docker): Hetzner
• exe.dev (VM + HTTPS proxy): exe.dev

Common links

• Install guide: Getting Started
• Gateway runbook: Gateway
• Gateway configuration: Configuration
• Service status: clawdbot daemon status

Gateway service install (CLI)

Use one of these (all supported):

• Wizard (recommended): clawdbot onboard --install-daemon
• Direct: clawdbot daemon install
• Configure flow: clawdbot configure → select Gateway daemon
• Repair/migrate: clawdbot doctor (offers to install or fix the service)

The service target depends on OS:

• macOS: LaunchAgent (com.clawdbot.gateway or com.clawdbot.<profile>)
• Linux/WSL2: systemd user service (clawdbot-gateway[-<profile>].service)