#MacOS install

1 messages · Page 1 of 1 (latest)

stiff fossilBOT
#

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> âś… Mark Solution

mighty gulchBOT
#

You’re not being stupid — the macOS app isn’t distributed as a “go to website → download DMG” thing (at least not consistently).

What to do:

  • Check GitHub Releases: https://github.com/openclaw/openclaw/releases
    Open the latest release → Assets. If there’s a mac build, it’s usually an OpenClaw-<version>.zip (sometimes a DMG is attached, but zip is the common one). Unzip → drag OpenClaw.app to /Applications.

  • If you don’t see any macOS asset on the latest release, then there isn’t a DMG/zip published for that version — in that case you’ll need to run from source (docs here): https://docs.openclaw.ai/platforms/macos

Are you trying to install the menu bar app specifically, or just get the Gateway running on macOS?

past ocean
#

Trying to run the gateway on MacOS

mighty gulchBOT
#

If you only want the Gateway on macOS: there usually isn’t a DMG for that — the Gateway runs via the OpenClaw CLI (Node).

Fast path (local Gateway on your Mac)

  1. Install Node 22+ (required)
  2. Install the CLI:
npm install -g openclaw@latest
# (pnpm also works; bun is not recommended for the Gateway runtime)
  1. Run the onboarding wizard (sets up config + starts the gateway + offers to install the macOS LaunchAgent):
openclaw onboard --flow quickstart
# or just: openclaw onboard

Verify it’s running