Does OpenClaw work on Apple Silicon Macs (M1, M2, M3, M4)?

Yes. OpenClaw runs natively on Apple Silicon without Rosetta translation. The installer automatically detects your chip architecture (arm64) and installs the correct binaries. Performance is excellent on all M-series chips, including M1, M2, M3, and M4 variants.

Does OpenClaw work on Intel Macs?

Yes. OpenClaw fully supports Intel-based Macs running macOS 12 Monterey or later. The installer detects x86_64 architecture and installs the correct binaries. Performance is comparable to Apple Silicon for API-based workloads.

What version of macOS do I need for OpenClaw?

OpenClaw requires macOS 12 Monterey or later. This includes macOS 13 Ventura, macOS 14 Sonoma, and macOS 15 Sequoia. Older versions like Big Sur or Catalina are not supported due to Node.js 22 compatibility requirements.

Can I run OpenClaw 24/7 on my MacBook?

You can, but it is not ideal for business automation. When your MacBook sleeps, loses WiFi, or restarts for updates, OpenClaw stops — which means missed follow-ups and broken automations. For 24/7 operation, use a Mac Mini as a dedicated server or deploy on a VPS.

Should I use Homebrew or the one-line installer for OpenClaw on Mac?

Both work well. The one-line installer is fastest and handles everything automatically. Homebrew is better if you already manage your tools through brew and want OpenClaw integrated into your Homebrew update workflow. The result is identical — same OpenClaw installation either way.

How do I uninstall OpenClaw from my Mac?

Run 'openclaw uninstall' in Terminal. This removes the OpenClaw binary and daemon. Your configuration files in ~/.openclaw are preserved by default. To remove everything, also delete the ~/.openclaw directory: rm -rf ~/.openclaw. If installed via Homebrew, run 'brew uninstall openclaw'.

How to Install OpenClaw on Mac: Complete macOS Guide (2026)

Install OpenClaw on macOS with one command: curl -sSL https://get.openclaw.ai/install.sh | bash. Requires macOS 12 Monterey or later, Node.js 22+, and 2 GB RAM. Works natively on M1, M2, M3, and Intel Macs.

This guide covers three installation methods, macOS-specific troubleshooting, post-install configuration, and how to run OpenClaw 24/7 on a Mac Mini.

Prerequisites One-Line Installer Homebrew Install Docker on Mac Post-Install Steps Troubleshooting Mac Mini Server FAQ

What Do You Need to Install OpenClaw on Mac?

Most modern Macs already meet these requirements. The installer handles Node.js automatically.

System Requirements

macOS 12 Monterey or later

Sonoma, Ventura, and Monterey all supported

Node.js 22+

The installer handles this automatically

2 GB RAM minimum, 4 GB recommended

Every Mac since 2012 meets this requirement

10 GB free disk space

For OpenClaw, Node.js, and skill cache

Apple Silicon (M1/M2/M3/M4) or Intel

Fully native on both — no Rosetta needed

API key (Anthropic, OpenRouter, or free Ollama)

Needed to power the AI agent's reasoning

RECOMMENDED

Method 1: One-Line Installer

The fastest way to install OpenClaw on macOS. One command handles everything — dependencies, configuration, and the setup wizard.

Open Terminal and Run

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

Open Terminal from Applications > Utilities (or press Cmd+Space and type "Terminal"). Paste the command above and press Enter.

What the Installer Does

Detects macOS version and chip architecture (arm64 or x86_64)
Installs or updates Node.js 22+ via nvm if not present
Downloads the latest OpenClaw release
Creates the ~/.openclaw configuration directory
Launches the interactive setup wizard
Registers openclaw as a launchd service (optional)

Expected Output

[OpenClaw Installer] Detected macOS 15.3 (arm64) [OpenClaw Installer] Node.js 22.x found ✓ [OpenClaw Installer] Downloading OpenClaw v2.4.1... [OpenClaw Installer] Installing to /usr/local/bin/openclaw [OpenClaw Installer] Creating ~/.openclaw directory [OpenClaw Installer] Installation complete ✓ Starting setup wizard... ? Choose your AI provider: (Anthropic / OpenRouter / Ollama) ? Enter your API key: **** ? Connect messaging platform? (Telegram / WhatsApp / Skip) OpenClaw is ready! Run: openclaw status

Method 2: Homebrew Install

If you already use Homebrew to manage your Mac tools, install OpenClaw from the official tap. Same result as the one-liner, integrated into your brew workflow.

Homebrew Command

brew install openclaw/tap/openclaw && openclaw init && openclaw start

Requires macOS 12+ with Homebrew installed. If you don't have Homebrew, use Method 1 instead.

When to Use Homebrew vs the One-Liner

Use Homebrew if:

You already manage tools with brew
You want updates via brew upgrade
You prefer Homebrew's uninstall flow
You manage multiple development environments

Use the One-Liner if:

You want the fastest setup possible
You don't have Homebrew installed
You're new to the Mac terminal
You want automatic Node.js installation

Method 3: Docker on Mac

Run OpenClaw in a Docker container for maximum isolation. Best for security-conscious users, VPS practice, or when you want to keep your Mac clean.

Docker Commands

git clone https://github.com/openclaw/openclaw.git && cd openclaw && bash docker-setup.sh

Requires Docker Desktop for Mac. Download from docker.com — supports both Apple Silicon and Intel.

Docker Desktop Requirements

Docker Desktop 4.x for Mac
macOS 12 Monterey or later
4 GB RAM allocated to Docker
10 GB free disk space
Apple Silicon or Intel supported

When Docker Makes Sense

You want container isolation for security
You're practicing for VPS deployment
You don't want Node.js on your system
You need reproducible environments
You run multiple OpenClaw instances

For a deeper dive, read our complete Docker setup guide.

What Should You Do After Installing OpenClaw on Mac?

After installing, verify everything works, connect your messaging platforms, and configure your agent.

Verify Installation

Run openclaw status to check the service
Run openclaw test to validate API connectivity
Access dashboard at localhost:18789
View logs: openclaw logs --follow

Connect Messaging Platforms

Telegram: Create bot via @BotFather, paste token
WhatsApp: Scan QR code or use Business API
iMessage: Pair via the setup wizard (Mac-only)
Slack/Discord: Add app via OAuth

Configure Your Agent

Run openclaw configure for guided setup
Set your agent's personality and tone
Choose notification preferences
Configure network and security settings

Install Skills

Browse 10,700+ skills on ClawHub
Run openclaw skills install <skill-name>
Core integrations are built-in
Run openclaw skills list to see installed

macOS-Specific Troubleshooting

Common issues when installing OpenClaw on macOS and how to fix them.

"xcode-select: error: command line tools are not installed"

Run: xcode-select --install — this installs Apple's Command Line Tools, which include git and build utilities that OpenClaw's installer needs. The download is about 1 GB and takes a few minutes.

xcode-select --install

"brew: command not found"

Homebrew is not installed. Install it first with the official one-liner, then retry the OpenClaw Homebrew install. Alternatively, skip Homebrew and use the curl one-line installer instead.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

"permission denied" errors during install

The installer cannot write to /usr/local or ~/.openclaw. Fix ownership with chown, then re-run the installer. Do not use sudo with the curl installer — it should run as your user.

sudo chown -R $(whoami) /usr/local ~/.openclaw

Gatekeeper blocks OpenClaw: "cannot be opened because the developer cannot be verified"

Go to System Settings > Privacy & Security, scroll down, and click "Allow Anyway" next to the blocked app. Alternatively, right-click the binary and select "Open" to bypass Gatekeeper for that specific file.

Node.js version too old (below v22)

The installer should handle this automatically. If it doesn't, install nvm (Node Version Manager) and use it to install Node.js 22. Then re-run the OpenClaw installer.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash && nvm install 22

For more troubleshooting, visit our complete troubleshooting guide.

Can You Use a Mac Mini as an Always-On OpenClaw Server?

Yes — and it's one of the best dedicated hardware options. The Mac Mini combines Apple Silicon performance with low power consumption and silent operation.

Apple Silicon Power

M-series chips deliver excellent performance per watt. The M2 Mac Mini idles at under 7W — less than a lightbulb — while running OpenClaw 24/7.

Always-On Reliability

macOS is designed for always-on operation. Enable 'Prevent automatic sleeping' in Energy settings. The Mac Mini has no moving parts — no fan noise, no mechanical failures.

Security Isolation

A dedicated Mac Mini means OpenClaw runs on its own machine — not your daily driver. Your personal files, API keys, and browsing data stay separate.

Read the Full Mac Mini Setup Guide

Stop Wasting 40-60% of Your AI Budget

Download the free '6 Token Drains' guide — identify the hidden patterns burning through your tokens and get copy-paste fixes for each one.

Read the Free Guide

See what we've built for real businesses →

Skip the Setup Headaches

Get OpenClaw running in 20 minutes with our guided workshop — step-by-step setup guidance and lifetime access.

Save 10+ hours/week Cut AI costs by 97% Deploy in under 20 min

Get the Automation Playbook (Free)

One deploy-ready automation every week. Same strategies our clients pay thousands for. 400+ business owners already inside.

Need it done for you?

Book a Free Strategy Call See what we've built for real businesses →