How do I install OpenClaw on macOS?

Use the fast path command: npm install -g openclaw@latest && openclaw onboard

What should I do if startup is blocked by gateway mode?

Follow the gateway mode troubleshooting page and validate with openclaw doctor plus logs --follow.

Run doctor checks, inspect startup logs, and execute one end-to-end test command.

macOS Install Guide

Best for local-first usage with native app support, pairing flows, and rapid CLI onboarding.

Fast path (most users)

Installs CLI globally and starts guided onboarding.

npm install -g openclaw@latest && openclaw onboard

Installer path

One-line installer with default runtime setup.

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

Advanced / source path

Best for contributors or custom runtime tuning.

git clone https://github.com/openclaw/openclaw.git && cd openclaw && pnpm install && pnpm run build

macOS platform guide

Platform-specific setup and architecture notes.

Pairing and gateway checks

Verify your local pairing and communication state.

Troubleshooting hub

Common failures and exact debug flow.

Fix gateway.mode=local startup block

Dedicated troubleshooting page with root-cause checks and command order.

Understand openclaw logs --follow output

Command semantics, examples, and what to do when logs look abnormal.

Install Troubleshooting Agent

Share your current command and observed behavior. The assistant maps the issue to the exact docs path and next action.

Desde la documentación oficial

I can help with OpenClaw setup on macOS. Paste your command output or error message.

Common questions: