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 |
| 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:
- Bestätige die macOS-Sicherheitswarnung beim ersten Start
- Erlaube die Berechtigung "Find Local Networks"
- Wähle Lokal vs. Remote — wähle "This Mac" für ein rein lokales Gateway
- Gewähre Berechtigungen — die App kann je nach Anwendungsfall Automation, Notifications, Accessibility und andere TCC-Berechtigungen anfordern
- Installiere die CLI (optional) — die App kann die globale
openclaw-CLI über npm installieren, damit Terminal-Workflows parallel zur App funktionieren - 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:
- Stelle sicher, dass das Gateway erreichbar ist:
openclaw status - Rufe den Token ab:
openclaw config get gateway.auth.token - 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
Weiterlesen
Vector Lakebase: End the AI Data Silo
Learn how Vector Lakebase unifies vector search, data lakes, and AI data operations so teams can serve RAG and agents without copy-and-sync pipelines.
Why Not All VectorDBs Are Agent-Ready
Explore why choosing the right vector database is critical for scaling AI agents, and why traditional solutions fall short in production.
Introducing DeepSearcher: A Local Open Source Deep Research
In contrast to OpenAI’s Deep Research, this example ran locally, using only open-source models and tools like Milvus and LangChain.