So installieren und starten Sie OpenClaw (früher Clawdbot/Moltbot) auf dem Mac

OpenClaw ist ein Open-Source-, selbst gehostetes Gateway, das deine alltäglichen Messaging-Apps mit KI-Coding-Agenten verbindet. Anstatt zwischen Tabs, Apps und Oberflächen zu wechseln, sendest du eine Nachricht von WhatsApp oder Telegram und erhältst eine KI-gestützte Antwort direkt in deiner Tasche. Es ist MIT-lizenziert, läuft auf deiner Hardware und gibt dir die volle Kontrolle über deine Daten.

In diesem Tutorial gehen wir alles durch, was du brauchst, um OpenClaw auf macOS zu installieren und auszuführen — von den Voraussetzungen bis zu deinem ersten funktionierenden Chat.

Was du brauchst

Bevor du beginnst, stelle sicher, dass du Folgendes hast:

• macOS (eine beliebige aktuelle Version)
• Node.js 22 oder neuer — das Installationsskript übernimmt das für dich, falls es noch nicht installiert ist, aber es ist gut, es zu überprüfen
• Einen API-Schlüssel — Anthropic wird vom OpenClaw-Team empfohlen
• Etwa 5 Minuten deiner Zeit

Um deine aktuelle Node-Version zu prüfen, öffne Terminal und führe aus:

node --version

Wenn du v22.x.x oder höher siehst, bist du startklar. Falls nicht, keine Sorge — der Installer kümmert sich darum.

Schritt 1: OpenClaw über das Installationsskript installieren (empfohlen)

Der schnellste Weg, OpenClaw auf macOS zu installieren, ist das einzeilige Installationsskript. Es übernimmt die Node-Erkennung, die CLI-Installation und startet den Onboarding-Assistenten — alles in einem Schritt.

Öffne Terminal und führe aus:

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

Das war's. Das Skript lädt die CLI herunter, installiert sie global über npm und startet automatisch den Onboarding-Assistenten.

Alternative: Direkt über npm installieren

Wenn du bereits Node 22+ hast und manuelle Kontrolle bevorzugst, kannst du OpenClaw mit npm installieren:

npm install -g openclaw@latest
openclaw onboard --install-daemon

Alternative: Über pnpm installieren

Wenn pnpm dein bevorzugter Paketmanager ist:

pnpm add -g openclaw@latest
pnpm approve-builds -g   # approve openclaw, node-llama-cpp, sharp, etc.
openclaw onboard --install-daemon

Hinweis: pnpm erfordert eine ausdrückliche Genehmigung für Pakete mit Build-Skripten. Nachdem bei der ersten Installation die Warnung "Ignored build scripts" angezeigt wird, führe pnpm approve-builds -g aus und wähle die aufgeführten Pakete aus.

Fehlerbehebung: sharp-Build-Fehler

Wenn du libvips global installiert hast (unter macOS häufig über Homebrew) und sharp während der Installation fehlschlägt, erzwinge vorgefertigte Binärdateien:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Wenn du den Fehler sharp: Please add node-gyp to your dependencies siehst, installiere entweder die Build-Werkzeuge (Xcode Command Line Tools + npm install -g node-gyp) oder verwende die obige Umgebungsvariable.

Schritt 2: Den Onboarding-Assistenten ausführen

Wenn das Installationsskript ihn nicht automatisch gestartet hat, starte den Onboarding-Assistenten manuell:

openclaw onboard --install-daemon

Der Assistent führt dich durch die Konfiguration von Authentifizierung, Gateway-Einstellungen und optionalen Channel-Verbindungen. Er installiert OpenClaw außerdem als Hintergrunddienst (Daemon), sodass das Gateway auch dann weiterläuft, wenn du Terminal schließt.

Was der Assistent konfiguriert

• Authentifizierung — generiert ein Token für das Gateway, damit lokale und entfernte Clients sich authentifizieren müssen
• Gateway-Einstellungen — Port, Bind-Adresse und Dienstinstallation
• Channel-Verbindungen — optionale Einrichtung für WhatsApp, Telegram, Discord und mehr

Schritt 3: Überprüfen, ob das Gateway läuft

Sobald das Onboarding abgeschlossen ist, prüfe, ob das Gateway aktiv ist:

openclaw gateway status

Du solltest eine Bestätigung sehen, dass das Gateway läuft. Wenn du es zum Debuggen oder für schnelle Tests im Vordergrund ausführen möchtest, verwende:

openclaw gateway --port 18789

Für einen vollständigen Health Check:

openclaw health

Schritt 4: Die Control UI (Dashboard) öffnen

Der schnellste Weg, mit OpenClaw zu chatten, ist über die browserbasierte Control UI — keine Channel-Einrichtung erforderlich.

Führe aus:

openclaw dashboard

Dies kopiert die Dashboard-URL, öffnet nach Möglichkeit deinen Browser und zeigt den Link an. Standardmäßig wird die Control UI bereitgestellt unter:

http://127.0.0.1:18789/

Wenn das Dashboard zur Authentifizierung auffordert, füge das Token aus deiner Gateway-Konfiguration ein. Du kannst es abrufen mit:

openclaw config get gateway.auth.token

Sicherheitshinweis: Die Control UI ist eine Admin-Oberfläche — sie bietet Zugriff auf Chat, Konfiguration und Ausführungsgenehmigungen. Stelle sie nicht öffentlich bereit. Bleibe bei localhost, Tailscale Serve oder einem SSH-Tunnel.

Schritt 5: Einen Chat-Kanal verbinden (Optional)

Während dir die Control UI sofortigen Zugriff auf den Chat gibt, liegt die eigentliche Stärke von OpenClaw darin, deinem KI-Agenten Nachrichten aus den Apps zu senden, die du bereits nutzt. Hier ist ein kurzer Überblick über unterstützte Kanäle:

Kanal	Einrichtungsaufwand	Hinweise
Telegram	Am einfachsten	Einfaches Bot-Token
WhatsApp	Einfach	QR-Kopplung erforderlich; speichert mehr Zustand auf der Festplatte
Discord	Mittel	Bot API + Gateway
iMessage	Mittel	Empfohlen über BlueBubbles macOS server
IRC	Gering	Klassisches IRC; Kanäle + DMs
Slack	Mittel	Bolt SDK; Workspace-Apps
Signal	Mittel	Datenschutzorientiert; verwendet signal-cli

Mehrere Kanäle können gleichzeitig laufen — konfiguriere so viele, wie du möchtest, und OpenClaw leitet Nachrichten pro Chat weiter.

Sieh dir diesen Beitrag an für: OpenClaw Tutorial: Connect to Slack for Local AI Assistant - Milvus Blog

Kurzes Beispiel: WhatsApp koppeln

Um WhatsApp zu verbinden, führe aus:

openclaw channels login

Folge dem QR-Kopplungsablauf, und du kannst deinem KI-Agenten direkt aus WhatsApp Nachrichten senden.

Schritt 6: Eine Testnachricht senden

Mit einem konfigurierten Kanal sendest du eine Testnachricht über die CLI:

openclaw message send --target +15555550123 --message "Hello from OpenClaw"

Ersetze die Telefonnummer durch deine eigene. Wenn alles korrekt verbunden ist, siehst du, wie die Nachricht in deiner Messaging-App ankommt — und der KI-Agent von OpenClaw wird antworten.

Optional: Aus dem Quellcode bauen

Für Mitwirkende oder alle, die aus einem lokalen Checkout heraus arbeiten möchten:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

Verknüpfe die CLI global:

pnpm link --global

Führe dann das Onboarding aus:

openclaw onboard --install-daemon

Für Hot-Reload während der Entwicklung verwende pnpm gateway:watch anstelle des standardmäßigen Gateway-Befehls.

Optional: macOS-App-Onboarding

OpenClaw bietet außerdem eine native macOS-App (Menüleiste) mit eigenem Onboarding-Ablauf. Wenn du die App verwendest:

1. Bestätige die macOS-Sicherheitswarnung beim ersten Start
2. Erlaube die Berechtigung "Find Local Networks"
3. Wähle Lokal vs. Remote — wähle "This Mac" für ein rein lokales Gateway
4. Gewähre Berechtigungen — die App kann je nach Anwendungsfall Automation, Notifications, Accessibility und andere TCC-Berechtigungen anfordern
5. Installiere die CLI (optional) — die App kann die globale openclaw-CLI über npm installieren, damit Terminal-Workflows parallel zur App funktionieren
6. Chatte in der Onboarding-Sitzung — die App öffnet einen eigenen Chat, damit sich der Agent vorstellen kann

Der von den OpenClaw-Dokumenten empfohlene stabile Workflow: OpenClaw.app installieren und starten, die Onboarding-Checkliste abschließen und anschließend deine Kanäle mit openclaw channels login verknüpfen.

Grundlagen der Konfiguration

OpenClaw speichert seine Konfiguration unter ~/.openclaw/openclaw.json. Standardmäßig verwendet es die gebündelte Pi-Binärdatei im RPC-Modus mit Sitzungen pro Absender — keine Konfiguration erforderlich.

Wenn du einschränken möchtest, wer deinem Agenten Nachrichten senden kann, füge eine allowFrom-Regel hinzu:

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+15555550123"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  },
  "messages": {
    "groupChat": {
      "mentionPatterns": ["@openclaw"]
    }
  }
}

Wichtige Dateispeicherorte unter macOS

Pfad	Zweck
~/.openclaw/openclaw.json	Hauptkonfigurationsdatei
~/.openclaw/workspace/	Skills, Prompts, Erinnerungen
~/.openclaw/credentials/	Channel-Zugangsdaten
~/.openclaw/agents/<agentId>/sessions/	Agent-Sitzungsdaten
/tmp/openclaw/	Protokolle

Nützliche Umgebungsvariablen

Variable	Zweck
OPENCLAW_HOME	Home-Verzeichnis für die interne Pfadauflösung überschreiben
OPENCLAW_STATE_DIR	State-Verzeichnis überschreiben
OPENCLAW_CONFIG_PATH	Pfad zur Konfigurationsdatei überschreiben

Fehlerbehebung: openclaw nicht gefunden

Wenn deine Shell den Befehl openclaw nach der Installation nicht finden kann, ist das Problem fast immer ein fehlender PATH-Eintrag.

Schnelldiagnose:

node -v
npm -v
npm prefix -g
echo "$PATH"

Wenn die Ausgabe von npm prefix -g plus /bin nicht in deinem $PATH enthalten ist, füge sie deiner Shell-Startdatei hinzu (~/.zshrc für modernes macOS):

export PATH="$(npm prefix -g)/bin:$PATH"

Öffne dann ein neues Terminalfenster oder führe source ~/.zshrc aus.

Fehlerbehebung: „Unauthorized“ / 1008-Fehler im Dashboard

Wenn die Control UI einen Unauthorized-Fehler anzeigt:

1. Stelle sicher, dass das Gateway erreichbar ist: openclaw status
2. Rufe den Token ab: openclaw config get gateway.auth.token
3. Füge den Token in den Dashboard-Einstellungen in das Auth-Feld ein und verbinde dich erneut

Wenn du einen neuen Token generieren musst:

openclaw doctor --generate-gateway-token

Was du jetzt hast

Nach Abschluss dieses Tutorials hast du:

• Ein laufendes Gateway auf deinem Mac
• Authentifizierung konfiguriert für sicheren Zugriff
• Control-UI-Zugriff für browserbasierten Chat
• Optional einen oder mehrere verbundene Messaging-Channels (WhatsApp, Telegram, Discord usw.)

Von hier aus kannst du Multi-Agent-Routing, Workspace-Isolation, Medienunterstützung und den vollen Funktionsumfang von OpenClaw erkunden.

Ressourcen

• Wir haben das Speichersystem von OpenClaw extrahiert und Open Source gemacht (memsearch)

• Was ist OpenClaw? Vollständiger Leitfaden zum Open-Source-KI-Agenten

• Clawdbot-ähnliche KI-Agenten mit LangGraph & Milvus erstellen

• Wie Claude Code lokalen Speicher für KI-Agenten verwaltet