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

• VPS hub: VPS hosting
• Railway (one-click): Railway
• Fly.io: Fly.io
• Hetzner (Docker): Hetzner
• GCP (Compute Engine): GCP
• exe.dev (VM + HTTPS proxy): exe.dev

Common links

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

Gateway service install (CLI)

Use one of these (all supported):

• Wizard (recommended): clawdbot onboard --install-daemon
• Direct: clawdbot gateway install
• Configure flow: clawdbot configure → select Gateway service
• 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)