Platform Support Overview for OpenClaw Gateway and Companion Apps

This page outlines supported platforms for OpenClaw, including Node and Bun runtimes, companion apps for Windows, macOS, and mobile, plus VPS and hosting options. It helps users choose the right setup for their OS.

Read this when

  • Looking for OS support or install paths
  • Deciding where to run the Gateway

OpenClaw's core is built with TypeScript. Node acts as the primary, default, and recommended runtime. Bun 1.4+ versions that compile with WAL-reset-safe node:sqlite can run the CLI, Gateway, and managed node host, but only when explicitly enabled; check Bun for details.

Companion applications are available for Windows Hub, macOS (menu bar app), and mobile nodes (iOS/Android). Linux companion apps are on the roadmap, though the Gateway already works fully on that platform. On Windows, pick Windows Hub for the desktop experience, native PowerShell installation for command-line workflows, or WSL2 to get the most Linux-compatible Gateway runtime.

Choose your OS

VPS and hosting

Gateway service install (CLI)

Pick any of these (all are supported):

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

The service target depends on OS:

  • macOS: LaunchAgent (ai.openclaw.gateway, or ai.openclaw.<profile> for a named profile)
  • Linux/WSL2: systemd user service (openclaw-gateway[-<profile>].service)
  • Native Windows: Scheduled Task (OpenClaw Gateway or OpenClaw Gateway (<profile>)), with a per-user Startup-folder login item fallback if task creation is denied
291 words · updated Aug 28, 2026