OpenClaw auf dem Mac einrichten: Der komplette Guide

Überblick: Warum Mac?

Ein Mac als KI-Server? Klingt ungewöhnlich, ist aber eine der smartesten Optionen für OpenClaw. Kein monatliches Server-Abo, keine Linux-Kenntnisse, keine SSH-Fummelei — und dank Apple Silicon genug Power für lokale KI-Modelle.

Du suchst die VPS-Variante? Dann lies unseren OpenClaw auf dem Server einrichten Guide.

Vorteile von OpenClaw auf dem Mac

• Keine Cloud-Kosten: Kein VPS-Abo, kein Hetzner, kein DigitalOcean. Dein Mac steht schon da.
• Apple Silicon Power: M4-Chips sind brutal schnell für KI-Workloads. Die Neural Engine beschleunigt lokale Modelle.
• Lokale Modelle möglich: Mit Ollama laufen Llama 3, Mistral und Co. direkt auf deinem Mac — komplett offline, DSGVO-safe.
• Alles auf einer Maschine: Kein SSH, kein Remote-Server-Management. Terminal öffnen, fertig.
• Energieeffizient: Ein Mac Mini M4 verbraucht im Betrieb nur 5-8 Watt — das sind ~€25/Jahr Strom.

Vergleich: Mac Mini vs VPS vs Mac Studio

Voraussetzungen

Bevor es losgeht: Prüfe ob dein Mac die Anforderungen erfüllt. Die gute Nachricht — fast jeder halbwegs aktuelle Mac reicht aus.

Systemanforderungen

• macOS 14 (Sonoma) oder neuer — Prüfe unter → Über diesen Mac
• Terminal.app — Vorinstalliert (Finder → Programme → Dienstprogramme)
• Internetverbindung — Für Installation und API-Zugriff
• Admin-Rechte — Du musst Software installieren können

Welcher Mac reicht?

Schritt 1: Homebrew & Node.js installieren

Homebrew ist der Paketmanager für macOS — so installierst du Software übers Terminal. Node.js ist die Laufzeitumgebung, die OpenClaw braucht. Beides ist in 5 Minuten erledigt.

Homebrew installieren

Öffne Terminal.app (Spotlight: ⌘ + Leertaste → "Terminal") und füge diesen Befehl ein:

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

Folge den Anweisungen im Terminal. Am Ende zeigt Homebrew dir "Next steps" — führe diese Befehle aus!

# Diese Befehle zeigt Homebrew dir nach der Installation:
echo >> ~/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

# Prüfen ob Homebrew funktioniert:
brew --version

Node.js installieren

# Node.js installieren (LTS-Version)
brew install node

# Prüfen
node --version   # sollte v22.x.x oder neuer zeigen
npm --version    # sollte 10.x.x oder neuer zeigen

Schritt 2: OpenClaw installieren

Jetzt kommt der einfache Teil: OpenClaw selbst installieren. Ein Befehl, 30 Sekunden, fertig.

# OpenClaw global installieren
npm install -g openclaw

# Prüfen ob es funktioniert
openclaw --version

# npm-Berechtigungen fixen (einmalig)
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules

# Dann nochmal:
npm install -g openclaw

Schritt 3: API-Key einrichten

OpenClaw braucht einen API-Key, um mit KI-Modellen zu kommunizieren. Wir empfehlen Claude von Anthropic — Stand 2026 das beste Modell für agentenbasierte Aufgaben.

Anthropic API-Key erstellen

1. Gehe auf console.anthropic.com
2. Erstelle einen Account (E-Mail + Verifizierung)
3. Klicke auf API Keys → Create Key
4. Kopiere den Key — er wird nur einmal angezeigt!
5. Hinterlege eine Zahlungsmethode (Kreditkarte)
6. Setze ein Budget-Limit (z.B. €30/Monat) unter Billing → Limits

Alternative: OpenAI (GPT-4)

Wenn du lieber GPT-4 nutzen willst:

1. Gehe auf platform.openai.com
2. Erstelle einen Account und hinterlege eine Zahlungsmethode
3. Unter API Keys → Create new secret key
4. Kopiere den Key

Schritt 4: Konfiguration

Die config.yaml ist das Herzstück deiner OpenClaw-Installation. Hier legst du fest, welches KI-Modell genutzt wird, welche Messaging-Kanäle aktiv sind und wie sich dein Assistent verhält.

# Konfiguration öffnen
openclaw config edit

# Oder direkt die Datei bearbeiten:
nano ~/.openclaw/config.yaml

Minimale Konfiguration

# ~/.openclaw/config.yaml

# KI-Modell
ai:
  provider: anthropic
  model: claude-sonnet-4-20250514
  apiKey: sk-ant-DEIN_API_KEY_HIER

# Gateway
gateway:
  token: DEIN_SICHERES_TOKEN    # Wähle ein langes, zufälliges Passwort

# Messaging (WhatsApp Beispiel)
channels:
  whatsapp:
    enabled: true

Schritt 5: WhatsApp / Telegram anbinden

Jetzt verbindest du deinen Assistenten mit einem Messaging-Kanal. Die Kurzversion hier — für alle Details siehe unsere ausführlichen Guides.

WhatsApp (schnellste Option)

1. Starte OpenClaw: openclaw gateway start
2. OpenClaw zeigt einen QR-Code im Terminal
3. Öffne WhatsApp auf dem Smartphone → Verknüpfte Geräte → Gerät verknüpfen
4. Scanne den QR-Code
5. Schreib dir selbst eine Nachricht — dein Assistent antwortet!

Ausführlicher Guide: KI-Assistent auf WhatsApp

Telegram (stabilere Option)

1. Öffne Telegram und suche nach @BotFather
2. Schreibe /newbot und folge den Anweisungen
3. Du bekommst einen Bot-Token
4. Füge den Token in die config.yaml ein

channels:
  telegram:
    enabled: true
    token: "DEIN_BOT_TOKEN"
    allowFrom:
      - DEINE_TELEGRAM_USER_ID

Ausführlicher Guide: OpenClaw mit Telegram

Schritt 6: Mac als 24/7 Server konfigurieren

Das ist der wichtigste Mac-spezifische Schritt. macOS ist darauf ausgelegt, Energie zu sparen — aber dein KI-Assistent soll rund um die Uhr laufen. Hier zeigen wir dir, wie du deinen Mac zum zuverlässigen Server machst.

1. Schlafmodus deaktivieren (GUI)

Der einfachste Weg — über die Systemeinstellungen:

1. Öffne Systemeinstellungen (⌘ + Leertaste → "Systemeinstellungen")
2. Gehe zu Energie (oder "Energie sparen" bei älteren macOS-Versionen)
3. Aktiviere "Automatischen Ruhezustand des Bildschirms bei Netzbetrieb verhindern"
4. Setze "Ruhezustand des Computers" auf "Nie"

2. Schlafmodus deaktivieren (Terminal — zuverlässiger)

Für absolute Sicherheit nutze pmset — das macOS Power Management Tool:

# Schlafmodus komplett deaktivieren
sudo pmset -a sleep 0
sudo pmset -a disablesleep 1

# Display-Sleep erlauben (spart Strom, Mac bleibt wach)
sudo pmset -a displaysleep 10

# Festplatten nicht schlafen legen
sudo pmset -a disksleep 0

# Aktuelle Einstellungen anzeigen:
pmset -g

3. Automatischer Neustart nach Stromausfall

# Mac startet automatisch nach Stromausfall
sudo pmset -a autorestart 1

# Wake on LAN aktivieren (optional, für Remote-Zugriff)
sudo pmset -a womp 1

4. OpenClaw als Launch Agent einrichten

Damit OpenClaw automatisch bei jedem Login startet — auch nach einem Neustart:

Manueller Weg (falls du mehr Kontrolle willst):

# Launch Agent Datei erstellen
cat > ~/Library/LaunchAgents/com.openclaw.gateway.plist << 'EOF'
<?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.openclaw.gateway</string>
  <key>ProgramArguments</key>
  <array>
    <string>/opt/homebrew/bin/node</string>
    <string>/opt/homebrew/bin/openclaw</string>
    <string>gateway</string>
    <string>start</string>
    <string>--foreground</string>
  </array>
  <key>RunAtLoad</key>
  <true/>
  <key>KeepAlive</key>
  <true/>
  <key>StandardOutPath</key>
  <string>/tmp/openclaw.log</string>
  <key>StandardErrorPath</key>
  <string>/tmp/openclaw-error.log</string>
  <key>WorkingDirectory</key>
  <string>/Users/DEIN_USERNAME</string>
</dict>
</plist>
EOF

# DEIN_USERNAME ersetzen!
# Dann laden:
launchctl load ~/Library/LaunchAgents/com.openclaw.gateway.plist

# Status prüfen:
launchctl list | grep openclaw

5. Automatischer Login (optional)

Damit dein Mac nach einem Neustart automatisch einloggt und den Launch Agent startet:

1. Systemeinstellungen → Benutzer & Gruppen
2. Klicke auf Automatischer Login
3. Wähle deinen Benutzer und gib das Passwort ein

Schritt 7: Lokale Modelle mit Ollama (Optional)

Das ist der Gamechanger auf dem Mac: Mit Ollama laufen KI-Modelle komplett lokal auf deiner Hardware. Keine API-Kosten, keine Daten die dein Gerät verlassen, DSGVO-safe by Design.

Ollama installieren

# Ollama über Homebrew installieren
brew install ollama

# Ollama starten
ollama serve

# In einem neuen Terminal-Fenster: Modell herunterladen
ollama pull llama3        # 8B Modell, ~4.7 GB Download
ollama pull mistral       # Alternative, ebenfalls gut

# Testen
ollama run llama3 "Hallo, wie geht es dir?"

OpenClaw für Ollama konfigurieren

# In config.yaml — Ollama als Backend:
ai:
  provider: ollama
  model: llama3
  baseUrl: http://localhost:11434    # Standard Ollama-Port

Vor- und Nachteile lokaler Modelle

Schritt 8: Skills aktivieren

Skills erweitern deinen Assistenten um konkrete Fähigkeiten. Die Basis-Skills (Web-Suche, Dateisystem, Code-Ausführung) sind sofort verfügbar. Erweiterte Skills wie Gmail oder Google Calendar brauchen eine zusätzliche Konfiguration.

Eine vollständige Übersicht aller Skills findest du in unserem Guide: OpenClaw Skills: Was dein KI-Assistent alles kann.

# Skills werden in der config.yaml aktiviert:
skills:
  web_search:
    enabled: true
    braveApiKey: "DEIN_BRAVE_API_KEY"    # Kostenlos bei brave.com/search/api
  gmail:
    enabled: true
    # OAuth-Setup über: openclaw skill setup gmail

Profi-Tipps

OpenClaw läuft? Hier sind Mac-spezifische Tipps, um das Maximum rauszuholen.

🖥️ Mac Mini als Headless Server

Du brauchst keinen Monitor am Mac Mini. So richtest du den Fernzugriff ein:

• Screen Sharing: Systemeinstellungen → Allgemein → Teilen → "Bildschirmfreigabe" aktivieren. Dann von einem anderen Mac: Finder → Gehe zu → Mit Server verbinden → vnc://MAC-IP
• SSH: Systemeinstellungen → Allgemein → Teilen → "Entfernte Anmeldung" aktivieren. Dann: ssh benutzer@MAC-IP
• HDMI-Dummy: Manche Apps brauchen eine "Display-Verbindung". Ein HDMI-Dummy-Stecker (~€5) löst das.

🔍 Spotlight-Indexierung deaktivieren

Spotlight indexiert alle Dateien — auch die OpenClaw Memory-Dateien. Das frisst CPU und ist unnötig:

# OpenClaw-Ordner von Spotlight ausschließen
# Systemeinstellungen → Spotlight → Datenschutz → ~/.openclaw hinzufügen

# Oder per Terminal:
sudo mdutil -i off ~/.openclaw

💾 Time Machine Backup

Dein Assistent hat ein Gedächtnis — sichere es:

• SOUL.md — Die Persönlichkeit deines Assistenten
• MEMORY.md — Das Langzeitgedächtnis
• memory/ — Tägliche Notizen und Kontext
• config.yaml — Deine gesamte Konfiguration

Time Machine sichert das alles automatisch. Alternativ: ~/.openclaw in ein Git-Repo packen.

🧠 Modell-Mix: Das Beste aus beiden Welten

Die clevere Strategie für Kostenersparnis ohne Qualitätsverlust:

• Ollama (lokal) für einfache Tasks: Erinnerungen, kurze Fragen, Formatierung — €0
• Claude Haiku (API) für Standardaufgaben: Web-Suche, Zusammenfassungen — günstig
• Claude Sonnet/Opus (API) für komplexe Aufgaben: Code, Analyse, Planung — teurer, aber top

Mac vs VPS: Wann was?

Beide Wege führen zum Ziel. Hier ist die ehrliche Gegenüberstellung:

* Remote-Zugriff außerhalb des Heimnetzes ist mit Tailscale oder WireGuard möglich.

VPS-Variante bevorzugt? Hier entlang: OpenClaw auf dem Server einrichten

Troubleshooting

Mac-spezifische Probleme und ihre Lösungen. Für allgemeine OpenClaw-Probleme siehe unseren Troubleshooting-Guide.

❌ "Permission denied" bei npm install

# npm-Verzeichnis-Berechtigungen fixen
sudo chown -R $(whoami) ~/.npm

# Auf Apple Silicon zusätzlich:
sudo chown -R $(whoami) /opt/homebrew/lib/node_modules

# Dann nochmal installieren:
npm install -g openclaw

❌ Mac geht trotzdem in den Schlafmodus

# Alle pmset-Einstellungen prüfen:
pmset -g

# Schlafmodus aggressiv deaktivieren:
sudo pmset -a sleep 0
sudo pmset -a disablesleep 1
sudo pmset -a hibernatemode 0
sudo pmset -a standby 0
sudo pmset -a autopoweroff 0

❌ WhatsApp disconnected nach Schlafmodus

Wenn dein Mac doch kurz einschläft, verliert WhatsApp die Verbindung. Lösungen:

• Amphetamine (kostenlos im App Store) — hält den Mac wach
• Caffeine — simples Menüleisten-Tool, gleicher Zweck
• pmset-Befehle oben ausführen — die zuverlässigste Lösung
• Telegram statt WhatsApp — Telegram reconnected automatisch, ohne QR-Code-Scan

❌ Homebrew PATH-Probleme auf Apple Silicon

# Problem: "command not found: brew" oder "command not found: openclaw"
# Ursache: Apple Silicon nutzt /opt/homebrew statt /usr/local

# Fix: PATH in .zprofile setzen
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
source ~/.zprofile

# Prüfen:
which brew       # sollte /opt/homebrew/bin/brew zeigen
which openclaw   # sollte einen Pfad zeigen

❌ Ollama läuft langsam

• Zu wenig RAM: 8B Modelle brauchen ~5 GB freien RAM. Schließe andere Apps.
• Swap-Nutzung: Prüfe in Aktivitätsanzeige → Speicher ob "Swap verwendet" hoch ist. Wenn ja: kleineres Modell wählen oder RAM upgraden.
• Kleineres Modell: ollama pull phi3 — schneller, braucht weniger RAM.

Alternative: GermanClaw — sofort einsatzbereit

Kein Bock auf Terminal-Befehle und pmset-Konfiguration? GermanClaw ist der Managed OpenClaw Service für den DACH-Raum: Wir übernehmen Setup, Hosting, Sicherheit, Updates und Support — du chattest einfach los.

Häufige Fragen (FAQ)