macOS install guide · Independent guidance

Install OpenClaw on macOS and Mac mini

On macOS, use the official installer for the CLI and onboarding; the macOS menu bar companion can manage permissions and connect to a local or remote Gateway. A Mac mini works well as an always-on host when power, login, networking, and managed startup are configured deliberately.

Current snapshotUpdated 2026-08-24Official docs main snapshot · OpenClaw 2026.8.1
01

Install and verify

  1. 1

    Run the official installer

    The installer can provision a supported Node runtime and start onboarding.

    curl -fsSL https://openclaw.ai/install.sh | bash
  2. 2

    Confirm health

    Do not add broad macOS permissions until the base Gateway is healthy.

    openclaw --version
    openclaw doctor
    openclaw gateway status
  3. 3

    Enable managed startup

    Use onboarding or install the Gateway LaunchAgent explicitly.

    openclaw gateway install
    openclaw gateway status --json
02

Mac mini operator checklist

  • Use a dedicated macOS account when the assistant should not inherit personal desktop data.
  • Grant Accessibility, Screen Recording, Camera, or Microphone only for capabilities you intend to expose.
  • Test restart behavior after a reboot and before relying on remote access.
  • Keep remote Gateway access authenticated; prefer an SSH tunnel, trusted private network, or documented access layer over a raw public port.

Primary sources

Verify against the owner.

Content snapshot follows official docs main at the recorded commit; the current package metadata reported 2026.8.1 when verified. Your installed release and live CLI schema remain authoritative.