Files
openclaw/docs/platforms/index.md
Peter Steinberger 6a6635abb3 feat(daemon): support Bun 1.4 managed services (#129593)
* feat(daemon): support Bun 1.4 managed runtimes

Amp-Thread-ID: https://ampcode.com/threads/T-01a037b7-66db-71f0-91e7-1578b383afb2

* fix(daemon): enforce Bun SQLite safety

Amp-Thread-ID: https://ampcode.com/threads/T-01a037b7-66db-71f0-91e7-1578b383afb2

* fix(daemon): preserve lightweight Bun startup

Amp-Thread-ID: https://ampcode.com/threads/T-01a037b7-66db-71f0-91e7-1578b383afb2

* docs: show Bun runtime opt-in commands

Amp-Thread-ID: https://ampcode.com/threads/T-01a037b7-66db-71f0-91e7-1578b383afb2

---------

Co-authored-by: Amp <amp@ampcode.com>
2026-08-26 00:45:43 -07:00

2.4 KiB

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

OpenClaw core is written in TypeScript. Node is the primary, default, and recommended runtime. Bun 1.4+ builds with WAL-reset-safe node:sqlite can run the CLI, Gateway, and managed node host as an explicit opt-in; see Bun.

Companion apps exist for Windows Hub, macOS (menu bar app), and mobile nodes (iOS/Android). Linux companion apps are planned, but the Gateway is fully supported today. On Windows, choose Windows Hub for the desktop app, native PowerShell install for terminal-first use, or WSL2 for the most Linux-compatible Gateway runtime.

Choose your OS

VPS and hosting

Gateway service install (CLI)

Use one of these (all 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