OpenClaw auf deinem Mac einrichten

Zielgruppe: Absolute Anfänger — kein Terminal-Wissen nötig

Dauer: 20 Minuten (+ optional 30-60 Min Skills)

Schwierigkeit: Anfänger

Getestet auf: macOS 12+, M1/Intel

Version: v3 (endgültig validiert)

⚠️ Sicherheitshinweis: OpenClaw hat Zugriff auf Dateien und kann Befehle ausführen. Diese Anleitung funktioniert auf deinem Mac/PC — wir empfehlen aber die Installation auf einem VPS oder einem separaten Gerät durchzuführen.

Voraussetzung: Node.js prüfen

Bevor wir starten: Hat dein Mac Node.js?

Terminal öffnen

1. Drücke Cmd + Leertaste
2. Tippe: terminal
3. Drücke Enter

Schwarz-weißes Fenster öffnet sich — das ist Terminal.

Node.js-Check

Im Terminal, tippe:

node --version

Drücke Enter.

Was siehst du?

Nummer wie v22.x.x oder v20.x.x?

Super! Geh zu Schritt 1

"command not found: node"?

Kein Problem! Fahre mit Schritt 0.1 fort (siehe unten)

Schritt 0.1: Node.js installieren (Falls nötig)

Falls Node.js fehlt:

Homebrew installieren

Im Terminal:

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

Drücke Enter. Es fragt nach deinem Mac-Passwort (wird nicht angezeigt — normal).

Tippe es ein und drücke Enter. Das dauert 5-10 Minuten.

Node.js mit Homebrew installieren

Im Terminal:

brew install node

Drücke Enter. Das dauert 2-3 Minuten.

Überprüfe Node.js

node --version

Du solltest sehen: v22.x.x oder ähnlich.

Perfekt!

Schritt 1: OpenClaw installieren

Im Terminal:

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

Drücke Enter.

Installation läuft 3-5 Minuten. Am Ende siehst du:

Installation complete!

Schritt 2: Konfigurieren

Das ist der wichtigste Schritt! Ein Konfigurations-Wizard mit mehreren Fenstern (nicht "Fragen").

Im Terminal:

openclaw onboard

Drücke Enter.

Hinweis: openclaw onboard ist der vollständige Ersteinrichtungs-Assistent. Wenn du nur bestimmte Einstellungen ändern möchtest (z.B. Channels oder Model), kannst du auch openclaw configure verwenden.

FENSTER 1: Gateway-Ort

Where will the Gateway run?
● Local (this machine)
○ Remote (info-only)

Local ist schon markiert (= ausgewählt).

Drücke Enter.

FENSTER 2: Was möchtest du konfigurieren?

Select sections to configure

● Workspace
○ Model
○ Web tools
○ Gateway
○ Daemon
○ Channels (Link WhatsApp/Telegram/etc)
○ Skills
○ Health check
○ Continue

Der Cursor (●) steht auf Workspace. Navigiere mit der Pfeiltaste (↓) nach unten zu Model und drücke Enter.

FENSTER 3: KI-Anbieter wählen

Du siehst viele Optionen:

Model/auth provider

○ OpenAI (ChatGPT)
○ Anthropic (Claude)
○ Google (Gemini)
○ vLLM (Local)
... (viele mehr)

Wichtig: OAuth vs API-Key verstehen:

OAuth (empfohlen für Anfänger) — KOSTENLOS mit bestehendem Abo

• OpenAI (ChatGPT): Du brauchst ChatGPT Pro Abo (€20/Monat)

- OpenClaw nutzt dein bestehendes Abo — kein extra API-Key nötig

- Du zahlst NICHT extra

API-Key — KOSTENPFLICHTIG, Pay-as-you-go

• Google Gemini: Kostet pro API-Call (ca. €0.01-0.10 pro Anfrage)

- Brauchst Kreditkarte

- Weniger zuverlässig als Abo-basiert

• Andere: Alle kosten Geld

Anfänger-Empfehlung:

Wenn du ChatGPT Pro hast: Wähle OpenAI → OAuth-Login, kein API-Key nötig

Wenn du nichts hast: Einfachste Option ist Google Gemini (kostenloser API-Key via Google AI Studio)

Markiere deine Wahl mit Pfeiltaste und drücke Enter.

FENSTER 4: Login (OAuth)

Dein Browser öffnet sich automatisch.

Für OpenAI:

1. Melde dich mit deinem ChatGPT-Konto an
2. Gib OpenClaw Erlaubnis
3. Browser schließt automatisch
4. Terminal zeigt: "Auth successful"

Für Anthropic:

1. Melde dich mit deinem Claude-Konto an
2. Gib OpenClaw Erlaubnis
3. Fertig!

FENSTER 2 (zurück): Weitere Konfiguration?

Du siehst wieder:

Select sections to configure

● Workspace
○ Model (fertig)
○ Web tools
○ Gateway
○ Daemon
○ Channels (WhatsApp/Telegram/etc)
○ Skills
○ Health check
○ Continue

Optionen:

Option A: Nur Dashboard (schnell)

• Markiere Continue und drücke Enter
• OpenClaw läuft sofort
• WhatsApp/Telegram kannst du später einrichten

Option B: WhatsApp jetzt verbinden (10 Min mehr)

• Markiere Channels und drücke Enter
• Folge FENSTER 3-5 unten

Option C: Skills installieren (30-60+ Min, optional)

• Markiere Skills und drücke Enter
• Warnung: Dauert sehr lange! (besonders auf älteren Macs)
• Viele Skills können fehlschlagen — das ist NORMAL

(Optional) WhatsApp verbinden

Falls du Channels wählst:

FENSTER 3: Channel-Status

Du siehst:

Channel status

Telegram: needs token
WhatsApp (default): not linked
Discord: needs token
...

Markiere WhatsApp und drücke Enter.

FENSTER 4: WhatsApp Setup

Channels
● Configure/link (Add/update channels)
○ Remove channel config

Configure ist schon markiert. Drücke Enter.

FENSTER 5: WhatsApp-Kanal wählen

Select a channel

○ Telegram (Bot API)
● WhatsApp (QR link)
○ Discord (Bot API)
...

WhatsApp ist schon markiert. Drücke Enter.

FENSTER 6: QR-Code

WhatsApp linking

Scan the QR with WhatsApp on your phone.
Credentials are stored under ~/.openclaw/credentials/whatsapp/

Waiting for WhatsApp connection...
Scan this QR in WhatsApp (Linked Devices):

[großer QR-Code]

So funktioniert's:

1. Öffne WhatsApp auf deinem Handy
2. Geh zu Einstellungen (unten rechts, drei Punkte)
3. Klick Verknüpfte Geräte
4. Klick Gerät hinzufügen
5. Öffne Kamera-App
6. Halte über den QR-Code im Terminal
7. WhatsApp öffnet sich und verknüpft
8. Zurück im Terminal siehst du: Linked

FENSTER 7: Deine Nummer

WhatsApp phone setup

● This is my personal phone number
○ Separate phone just for OpenClaw

Your personal WhatsApp number (the phone you will message from)
+43XXXXXXXXXX

Tippe deine WhatsApp-Nummer ein (mit +43-Vorwahl).

Drücke Enter.

FENSTER 2 (zurück): Weiter?

Select sections to configure

● Workspace
○ Model (fertig)
○ Web tools
○ Gateway
○ Daemon
○ Channels (WhatsApp konfiguriert)
○ Skills
○ Health check
○ Continue

Markiere Continue und drücke Enter.

FENSTER 8: Fertig!

Control UI

Web UI: http://127.0.0.1:18789/
Gateway WS: ws://127.0.0.1:18789

Configure complete.

Perfekt!

Schritt 3: Dashboard öffnen

Im Terminal:

openclaw dashboard

Drücke Enter.

Dein Browser öffnet sich mit:

http://127.0.0.1:18789/

Du siehst ein Chat-Fenster — das ist dein KI-Assistent!

Schritt 4: Test-Nachricht

1. Klick ins Chat-Fenster
2. Tippe: "Hallo! Wer bist du?"
3. Drücke Enter

Du solltest eine Antwort bekommen!

Schritt 5: Updates

Im Dashboard siehst du manchmal:

Update available: v2026.3.13

Klick drauf. OpenClaw wird aktualisiert (30 Sekunden).

Schritt 6: WhatsApp nutzen

Falls du WhatsApp verbunden hast:

Öffne WhatsApp auf deinem Handy und schreib eine Nachricht:

"Was kannst du tun?"

OpenClaw antwortet direkt in WhatsApp!

Schritt 7: Telegram nutzen (optional)

Falls du Telegram verbunden hast, gibt es einen wichtigen Extra-Schritt: OpenClaw muss bestätigen, dass es dir vertraut.

Wenn du dein Telegram-Bot zum ersten Mal anschreibst, bekommst du im Terminal (oder Dashboard) eine Nachricht mit einem Pairing-Code.

Diesen Code musst du im Terminal bestätigen:

openclaw pairing approved telegram <CODE>

Ersetze <CODE> durch den Code den du bekommen hast.

Ab dann antwortet OpenClaw auf deine Telegram-Nachrichten ohne weitere Bestätigung.

Tipp: Falls du kein Pairing-Request siehst, schau im Dashboard unter Pairing oder starte mit openclaw pairing um offene Anfragen anzuzeigen.

Häufige Fehler & Lösungen

Fehler 1: "command not found: openclaw"

Problem: Nach Installation funktioniert openclaw nicht

Lösung:

• Schließ Terminal komplett (Cmd + Q)
• Öffne es neu
• Versuche nochmal

Fehler 2: "Gateway not running" oder "localhost:18789 funktioniert nicht"

Problem: Dashboard lädt nicht

Lösung:

openclaw gateway restart

Warte 5 Sekunden, versuche nochmal.

Fehler 3: "WhatsApp (QR link) not found" oder "Unknown channel"

Problem: Beim Channels-Setup funktioniert WhatsApp nicht

Lösung:

• Das ist normal bei älteren Konfigurationen
• Tippe nochmal: openclaw configure
• Wähle wieder Channels
• WhatsApp sollte dann sichtbar sein

Fehler 4: "No API key found"

Problem: Dashboard zeigt: "Agent failed before reply: No API key found"

Lösung:

• Das heißt: OAuth-Login hat nicht geklappt
• Tippe: openclaw configure
• Wähle Model
• Login nochmal versuchen

Fehler 5: Skills-Installation dauert ewig

Problem: Bei Skills-Installation: 45+ Minuten, dein Mac wird heiß

Das ist NORMAL! Besonders auf älteren Macs.

Lösung:

• Warten (dauert halt)
• Falls du abbrichst: Strg + C drücken
• Dann openclaw configure und skip Skills

Fehler 6: "Skills installation failed"

Problem: Fehler wie "apple-notes — requires macOS Sonoma"

Das ist NORMAL! Vor allem auf älteren Macs.

OpenClaw funktioniert trotzdem perfekt.

Nützliche Terminal-Befehle

Gateway \& Status

openclaw dashboard              # Dashboard im Browser öffnen
openclaw gateway status         # Ist OpenClaw gestartet?
openclaw gateway restart        # Neu starten (löst die meisten Probleme)
openclaw gateway stop           # Stoppen
openclaw gateway start          # Starten
openclaw gateway run            # Im Vordergrund starten (mit Live-Logs)
openclaw status                 # Channel-Status und letzte Sessions anzeigen
openclaw health                 # Gateway-Gesundheit abrufen
openclaw --help                 # Alle verfügbaren Befehle

Diagnose \& Fehlersuche

openclaw doctor                 # Gesundheitscheck — prüft alles und zeigt Probleme
openclaw doctor --repair        # Wie doctor, versucht Probleme automatisch zu beheben
openclaw logs --follow          # Live-Logs anschauen (Strg+C zum Stoppen)
openclaw logs --follow --json   # Logs im JSON-Format (für Entwickler)
openclaw tui                    # Terminal-UI — Chat direkt im Terminal

Exec Approvals (Tool-Berechtigungen)

openclaw approvals get                               # Aktuelle Berechtigungen anzeigen
openclaw approvals allowlist add "/bin/bash"         # Bash freigeben
openclaw approvals allowlist add "/usr/bin/python3"  # Python freigeben

Hinweis: Wenn dein Assistent keine Terminal-Befehle ausführen kann, liegt es meist an fehlenden Exec Approvals. Starte mit openclaw approvals get und openclaw doctor.

Channels (WhatsApp, Telegram, Discord)

openclaw channels status        # Verbindungsstatus aller Channels
openclaw channels logs          # Channel-Logs anzeigen
openclaw configure              # Channels neu einrichten oder verbinden

Sessions \& Agents

openclaw sessions list          # Gespeicherte Sessions anzeigen
openclaw agents list            # Alle konfigurierten Agenten anzeigen

Skills \& Updates

openclaw skills list            # Installierte Skills anzeigen
openclaw skills search <name>   # Neuen Skill suchen
openclaw update                 # OpenClaw aktualisieren

Sicherheit \& Backup

openclaw security audit         # Sicherheits-Audit durchführen
openclaw backup create          # Backup erstellen
openclaw backup verify          # Backup prüfen

Nützliches für Fortgeschrittene

openclaw memory search <query>  # In Memory-Dateien suchen
openclaw models list            # Verfügbare KI-Modelle anzeigen
openclaw message send --target +43... --message "Test"  # Nachricht senden
openclaw docs                   # Dokumentation durchsuchen

Glückwunsch!

Du hast jetzt einen eigenen KI-Assistenten auf deinem Mac!

• Lokal auf deinem Gerät (deine Daten bleiben privat)
• Im Browser erreichbar: http://127.0.0.1:18789/
• Optional per WhatsApp/Telegram
• Mit regelmäßigen Auto-Updates