March 4, 2026 • 15 min read • 🚀 Beginner Friendly

Mac Mini OpenClaw Setup: Complete Self-Hosting Guide 2026

Turn your Mac Mini into a powerful AI agent server. Use our automated QuickStart installer ($10) or follow the free manual guide — either way, you'll be running in under 30 minutes.

There's something magical about having your own AI agent running on hardware you control. No cloud subscriptions. No data leaving your home. Just you, your Mac Mini, and an intelligent assistant that works 24/7.

In this guide, I'll walk you through deploying OpenClaw on a Mac Mini — whether you have an M1, M2, or the latest M4. By the end, you'll have a fully functional AI agent that can browse the web, send messages, and automate tasks while you sleep.

A Mac Mini M2 uses only ~7 watts at idle. Running OpenClaw 24/7 costs about $2/month in electricity — compared to $20-200/month for cloud AI services.

What You'll Need

                    🍎 Hardware Requirements
                    Mac Mini: M1, M2, M2 Pro, or M4 (M4 Pro recommended for heavy use)
RAM: 8GB minimum, 16GB recommended
Storage: 256GB minimum (OpenClaw + models need space)
Internet: Broadband connection (25 Mbps+ recommended)

                

                    📋 Before You Start
                    macOS Sonoma 14.0 or later
Admin access to your Mac
Telegram or WhatsApp account (for agent communication)
About 30 minutes of uninterrupted time

                

Quick Setup (Recommended)

🚀 OpenClaw QuickStart — $10

Skip the manual setup. Our automated installer configures everything in 15 minutes — Docker, GitHub integration, and your first agent.

✅ One-click automated setup
✅ Works on Mac & Linux
✅ 30-day email support
✅ 30-day money-back guarantee

Get QuickStart — $10 →

Manual Setup (Free)

Prefer to set up everything yourself? Follow these steps:

Install Homebrew

Homebrew is the package manager that makes installing everything else easy. Open Terminal (Cmd + Space, type "Terminal") and paste this command:

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

Follow the prompts. When it asks for your password, type it (you won't see characters appear — that's normal).

Install Docker Desktop

Docker lets OpenClaw run in a container — think of it as a neat little box with everything the agent needs. Run this in Terminal:

brew install --cask docker

Once installed, open Docker Desktop from your Applications folder. You'll see a whale icon in your menu bar when it's running. Wait for it to show "Docker Desktop is running" before continuing.

Download OpenClaw

Create a folder for your agent and download the latest OpenClaw release:

mkdir -p ~/openclaw && cd ~/openclaw
curl -L https://github.com/openclaw/openclaw/archive/refs/tags/v1.2.0.tar.gz | tar xz --strip-components=1

Configure Your Agent

OpenClaw needs to know a few things about you. Copy the example config and edit it:

cp config.example.json config.json
open -e config.json

This opens the config in TextEdit. You'll need to add:

Your Telegram Bot Token (get one from @BotFather)
Your OpenAI API key (optional, for GPT-4 access)
Your preferred model (Claude, GPT-4, or local models)

Launch OpenClaw

Time for the magic moment. In Terminal, run:

docker-compose up -d

The -d flag means "run in background." You'll see Docker downloading and starting containers. This takes 2-5 minutes the first time.

When you see "Started" messages, your agent is live! 🎉

Connect and Chat

Open Telegram and find your bot (the one you created with BotFather). Send your first message:

Hello! Can you browse startwithopenclaw.com and tell me what it's about?

Your agent will respond within seconds. Welcome to your new AI assistant! 🦞

Making It Permanent

By default, OpenClaw stops when you restart your Mac. Let's make it start automatically:

# Create a LaunchAgent plist
mkdir -p ~/Library/LaunchAgents
cat > ~/Library/LaunchAgents/com.openclaw.agent.plist << 'EOF'




    Label
    com.openclaw.agent
    ProgramArguments
    
        /usr/local/bin/docker-compose
        -f
        /Users/YOUR_USERNAME/openclaw/docker-compose.yml
        up
        -d
    
    RunAtLoad
    
    KeepAlive
    


EOF

# Load it
launchctl load ~/Library/LaunchAgents/com.openclaw.agent.plist

Replace YOUR_USERNAME with your actual Mac username.

Common Issues & Fixes

🔴 "Docker daemon not running"

Open Docker Desktop from Applications and wait for the whale icon to appear in your menu bar. Then try again.

🔴 "Permission denied" errors

Run this in Terminal to fix permissions:

sudo chown -R $(whoami) ~/openclaw

🔴 Agent not responding in Telegram

Check your bot token is correct in config.json. Then restart:

cd ~/openclaw && docker-compose restart

What's Next?

Your agent is running, but that's just the beginning. Here are some fun things to try:

Set up cron jobs: Morning briefings, weekly planning, price monitoring
Connect more services: Gmail, Calendar, Notion, GitHub
Create specialized agents: One for travel, one for work, one for daily life
Join the community: OpenClaw Discord for tips and tricks

🎓 Want the Full Course?

Master OpenClaw with our free 10-module course. From beginner to power user in one weekend.

Start the Free Course →

Questions? Check our troubleshooting guide or join the Discord community. Happy self-hosting! 🦞

Self-Host in 30 Minutes