macOS Installation

Install and configure OpenClaw on Mac

1System Requirements

  • macOS 12 (Monterey) or higher
  • Apple Silicon (M1/M2/M3) or Intel processor
  • At least 8GB RAM
  • Node.js 22+

2Install Node.js

Recommended to use Homebrew:

terminal
# Install Homebrew (if not installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Node.js
brew install node@22

3Install OpenClaw

Install globally with npm:

terminal
npm install -g clawdbot

4Auto-start on Boot

Create a LaunchAgent for auto-start:

terminal
# Create plist file
cat << 'EOF' > ~/Library/LaunchAgents/com.clawdbot.plist
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.clawdbot</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/clawdbot</string>
        <string>start</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
</dict>
</plist>
EOF

# Load the service
launchctl load ~/Library/LaunchAgents/com.clawdbot.plist

Tips

  • β€’iTerm2 or Warp terminal recommended
  • β€’Apple Silicon Macs perform better with local models

Warning

  • β€’Ensure system firewall allows OpenClaw network access

Frequently Asked Questions

Does OpenClaw work on Apple Silicon Macs?β–Ύ

Yes, OpenClaw fully supports Apple Silicon (M1/M2/M3/M4) and Intel Macs running macOS 12 Monterey or later.

How do I install Node.js on macOS?β–Ύ

The recommended approach is using Homebrew: run "brew install node@22". You can also download the installer from nodejs.org.

Can OpenClaw auto-start on macOS boot?β–Ύ

Yes, create a LaunchAgent plist file in ~/Library/LaunchAgents/ and load it with launchctl. The guide includes the exact configuration.