You want OpenClaw, the AI agent that actually does things, running on your Mac. You’ve heard it’s powerful, you know it’s open-source, and you’re ready to set it up.
But here’s the thing: OpenClaw wasn’t built by Apple. It doesn’t come from the App Store. And getting it running means opening Terminal, which is where most people bail.
This guide is your handhold. We’re walking through every step, from “where do I even start?” to “holy crap, it’s responding to my questions” with zero assumptions about what you already know. If you can copy and paste, you can do this.
What You Need Before You Start
- ●A Mac — works on Intel (2015+) or Apple Silicon (M1/M2/M3/M4), macOS 12 (Monterey) or newer
- ●An internet connection (for downloading stuff)
- ●30 minutes (realistically 20, but let’s pad it)
- ●Admin access to install software on your Mac
That’s it. You don’t need a computer science degree. You don’t need to have used Terminal before. You just need to follow steps.
The Two Paths: Terminal vs. Mac App
Path 1: The Manual Install (This Guide)
- ●You download components yourself
- ●You run commands in Terminal
- ●You configure settings manually
- ●Total control, zero hand-holding — Free, takes 20-30 minutes
Path 2: The PaioClaw Mac App
- ●You download one app
- ●You click Install
- ●It handles everything automatically
- ●Less control, maximum convenience — Free tier available, takes 2 minutes
This guide covers Path 1. Still here? Let’s install OpenClaw the manual way.
Step 1: Install Homebrew (The Mac Package Manager)
Homebrew is how Mac users install developer tools without losing their minds. Think of it as the App Store for command-line software.
Check If You Already Have It
Open Terminal (Cmd + Space, type “Terminal”, hit Enter), then:
brew --version
If you see something like Homebrew 4.2.9, you’re good. Skip to Step 2.
Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Your Mac might ask for your password — that’s normal. Type it in (you won’t see characters appear, but it’s working). Installation takes 2-5 minutes.
Apple Silicon Macs: One Extra Step
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile eval "$(/opt/homebrew/bin/brew shellenv)"
Verify: brew --version should print the version number.
Step 2: Install Node.js (OpenClaw’s Engine)
OpenClaw is built on Node.js. You don’t need to know what that means. You just need to install it.
brew install node
Takes 1-3 minutes. Verify:
node --version npm --version
You should see two version numbers (e.g., v22.5.1 and 10.8.1). Exact numbers don’t matter — what matters is that both commands work.
Step 3: Install Git
Git helps you download OpenClaw’s code from GitHub. Check first:
git --version
If you see a version number, skip ahead. Otherwise:
brew install git
Step 4: Download OpenClaw
Create a Projects folder and clone the repo:
mkdir -p ~/Projects cd ~/Projects git clone https://github.com/openclaw/openclaw.git cd openclaw
Should take 10-30 seconds depending on your internet speed.
Step 5: Install OpenClaw’s Dependencies
npm install
This is the longest step (3-5 minutes). You’ll see a progress bar and lots of package names scrolling by — that’s normal. When done you’ll see something like added 847 packages in 3m.
Step 6: Configure OpenClaw (First-Time Setup)
OpenClaw uses a .env file to store settings. Create one from the example template:
cp .env.example .env open -a TextEdit .env
You’ll see lines like:
OPENAI_API_KEY=your_key_here ANTHROPIC_API_KEY=your_key_here AGENT_NAME=OpenClaw
1. Add Your AI Model API Key
You need a key from OpenAI (platform.openai.com) or Anthropic (console.anthropic.com). Paste it in:
OPENAI_API_KEY=sk-proj-abc123...
2. (Optional) Customize Agent Name
Change AGENT_NAME=OpenClaw to whatever you want to call your AI assistant.
3. (Optional) Add Service Credentials
For Gmail, Calendar, Slack, etc., you’ll add OAuth credentials here. Skip for now — you can add services later. Save the file (Cmd+S) and close TextEdit.
Step 7: Run OpenClaw for the First Time
Moment of truth. In Terminal (still in ~/Projects/openclaw), run:
npm start
You should see output like:
> [email protected] start > node src/index.js [INFO] OpenClaw initialized [INFO] Web interface running at http://localhost:3000 [INFO] Agent ready. Say hello!
If you see errors instead, check the troubleshooting section. Otherwise keep Terminal open.
Step 8: Talk to Your Agent
Open your web browser and go to http://localhost:3000. You should see OpenClaw’s chat interface. Try a test message: “Hello, are you working?”
If it responds with something like “Yes, I’m running and ready to help!” — congratulations, you’ve installed OpenClaw on your Mac.
Add Your First Skill
OpenClaw without skills is like a phone without apps. In the web interface, go to the Skills tab. Click Install on the Email Summarizer skill. Now try: “Summarize my unread emails.”
Step 9: Make OpenClaw Start Automatically (Optional)
Right now, OpenClaw only runs when you manually start it in Terminal. To run it in the background:
Option A: Use pm2
npm install -g pm2 cd ~/Projects/openclaw pm2 start npm --name "openclaw" -- start pm2 save pm2 startup
Stop with pm2 stop openclaw, start again with pm2 start openclaw.
Option B: Just Use the PaioClaw Mac App
The PaioClaw app runs as a native Mac application — starts when you log in, lives in your menu bar, doesn’t require Terminal to stay open. Like Spotify or Dropbox.
What to Do Next
1. Connect Your Accounts
In the OpenClaw web interface, go to Settings → Integrations. Connect Gmail, Google Calendar, Slack, and any other services you use. Each connection uses OAuth — you’re not giving OpenClaw your passwords.
2. Install Essential Skills
- ●Email Summarizer – Daily digest of important emails
- ●Calendar Assistant – Natural language scheduling
- ●Task Tracker – Sync tasks across platforms
- ●Daily Briefing – Morning roundup of what matters
3. Create Your First Workflow
Pick one repetitive task and build a prompt for it: “Every morning at 8am, send me a summary of unread emails from my boss and flag anything urgent.”
4. Join the Community
OpenClaw has an active Discord, Reddit (r/openclaw), and GitHub. Steal workflows. Share yours. Ask questions.
Common Mac-Specific Issues (And Fixes)
“xcrun: error: invalid active developer path”
Your Mac needs Xcode Command Line Tools.
xcode-select --install
“Permission denied” when running npm install
sudo chown -R $(whoami) ~/.npm sudo chown -R $(whoami) /opt/homebrew # M1/M2/M3 Macs sudo chown -R $(whoami) /usr/local # Intel Macs
“node: command not found” after installing Node
Fix (M1/M2/M3 Macs):
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zprofile source ~/.zprofile
Fix (Intel Macs):
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zprofile source ~/.zprofile
“Port 3000 is already in use”
Edit your .env file:
PORT=3001
Restart OpenClaw, access at http://localhost:3001.
OpenClaw crashes on Apple Silicon
Some npm packages aren’t ARM-compatible yet. Run Terminal in Rosetta mode: Quit Terminal → Applications → Utilities → right-click Terminal → Get Info → check “Open using Rosetta” → reopen and reinstall.
Intel vs. Apple Silicon: Does It Matter?
Short answer: not really. OpenClaw runs on both. Performance is slightly better on Apple Silicon, but the difference is negligible for typical AI agent workloads. The only gotcha: some npm packages have better x86 support than ARM. The Rosetta workaround above usually fixes it.
The Mac App vs. Manual Install: An Honest Comparison
What you gained from manual install
- ●Understanding of how OpenClaw works under the hood
- ●Full control over configuration
- ●Ability to customize and modify the source code
- ●Useful Mac developer skills
- ●No recurring costs
What you gave up
- ●30 minutes of your life
- ●Automatic updates (you’ll need to git pull and npm install manually)
- ●Easy troubleshooting
- ●Native Mac integration (menu bar, notifications)
Which is better?
- ●A developer who likes tinkering → Manual install
- ●A power user who wants control → Manual install
- ●A normal person who wants things to work → PaioClaw app
- ●A team that needs reliability → PaioClaw app
Security Considerations for Self-Hosted OpenClaw
1. Skills are on you
Any skill you install has access to whatever data you’ve connected. Random skills from GitHub could exfiltrate emails, steal API keys, or execute malicious code. Stick to official skills until you understand what you’re installing.
2. API keys are stored in plain text
Your .env file contains your OpenAI/Anthropic keys in plain text. Mitigation: don’t share your Mac login, set chmod 600 .env, use environment-specific keys.
3. Local web server is exposed
By default, OpenClaw runs on localhost:3000 — only your Mac can access it. If you expose it to your network, you need to add authentication.
The Bottom Line
You’ve successfully installed OpenClaw on your Mac the manual way. You learned Homebrew, Node.js, npm, environment variables, and how to run a local web server — genuinely useful skills beyond just OpenClaw.
But the truth is: most people don’t need to know this. The PaioClaw Mac app exists specifically so you can skip this guide and have a working AI agent in 2 minutes instead of 30. Ask yourself: do I want to run an AI agent, or do I want to use one?