Platforms

OpenClaw core is written in TypeScript. Node is the recommended runtime. Bun is not recommended for the Gateway — known issues with WhatsApp and Telegram channels; see Bun (experimental) for details.

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
• Fly.io: Fly.io
• Hetzner (Docker): Hetzner
• GCP (Compute Engine): GCP
• Azure (Linux VM): Azure
• exe.dev (VM + HTTPS proxy): exe.dev

Common links

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

  Copy

  openclaw gateway status

Gateway service install (CLI)

Use one of these (all supported):

• Wizard (recommended):
  text

  Copy

  openclaw onboard --install-daemon
• Direct:
  text

  Copy

  openclaw gateway install
• Configure flow:
  text

  Copy

  openclaw configure
  → select Gateway service
• Repair/migrate:
  text

  Copy

  openclaw doctor
  (offers to install or fix the service)

The service target depends on OS:

• macOS: LaunchAgent (
  text

  Copy

  ai.openclaw.gateway
  or
  text

  Copy

  ai.openclaw.<profile>
  ; legacy
  text

  Copy

  com.openclaw.*
  )
• Linux/WSL2: systemd user service (
  text

  Copy

  openclaw-gateway[-<profile>].service
  )
• Native Windows: Scheduled Task (
  text

  Copy

  OpenClaw Gateway
  or
  text

  Copy

  OpenClaw Gateway (<profile>)
  ), with a per-user Startup-folder login item fallback if task creation is denied

Related

• Install overview
• macOS app
• iOS app