OpenClaw DACH
Alle Guides

OpenClaw auf deinem Mac einrichten

Anfänger15-20 Minuten

Voraussetzung: Node.js Check

Bevor wir anfangen, müssen wir prüfen ob Node.js auf deinem Mac installiert ist.

Wenn dieser Abschnitt für dich zu technisch klingt — kein Problem! Folge einfach jedem Schritt. Am Ende funktioniert alles.

Schritt 0.1: Terminal öffnen

Das Terminal ist ein schwarzes Fenster auf deinem Mac, wo du Befehle eingeben kannst. Keine Angst — wir machen jetzt zusammen!

So öffnest du das Terminal:

  1. Drücke Cmd + Leertaste auf deiner Tastatur
  2. Es öffnet sich die Spotlight-Suche (oben rechts auf dem Mac)
  3. Tippe das Wort Terminal ein
  4. Drücke Enter
  5. Ein schwarzes Fenster öffnet sich — das ist das Terminal!

Wie sieht Terminal aus?

Markus@MacBook-Pro ~ %

Diese Zeile ist die "Eingabeaufforderung". Du kannst hier Befehle eintippen.

Schritt 0.2: Prüfe ob Node.js installiert ist

Jetzt tippe folgenden Befehl ins Terminal ein:

node --version
  1. Klick ins schwarze Terminal-Fenster
  2. Tippe exakt ein: node --version
  3. Drücke Enter

Was passiert jetzt?

SZENARIO A: Node.js IST installiert

Du siehst eine Versionsnummer wie:

v22.11.0

Super! Das bedeutet Node.js läuft auf deinem Mac. Du kannst direkt zu Schritt 1 springen.

SZENARIO B: Node.js ist NICHT installiert

Du siehst einen Fehler wie:

zsh: command not found: node

Das ist normal! Es heißt nur: Node.js ist noch nicht installiert. Wir machen das jetzt.

Node.js installieren (Wenn du Szenario B hattest)

Node.js ist ein "System", das OpenClaw benötigt um zu laufen.

Schritt A: Homebrew installieren (einfach, einmalig)

Homebrew ist ein "Paket-Manager" — das ist ein Programm, das andere Programme installiert. Sehr praktisch.

Im Terminal, kopiere diesen Befehl und drücke Enter:

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

Was passiert:

  1. Der Befehl lädt die Homebrew-Installationsdatei herunter
  2. Es fragt dich nach deinem Mac-Passwort (das Passwort, mit dem du dich anmeldest)
  3. Du tippst dein Passwort ein und drückst Enter
  4. Homebrew wird installiert — das dauert 5-10 Minuten
  5. Am Ende siehst du: Installation successful!

WICHTIG beim Passwort eingeben: Es erscheint NICHTS auf dem Bildschirm — das ist normal (Sicherheit). Tippe trotzdem dein Passwort ein und drücke Enter.

Schritt B: Node.js mit Homebrew installieren

Jetzt ist es einfach. Im Terminal:

brew install node

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

Schritt C: Prüfe ob Node.js funktioniert

node --version

Du solltest sehen: v22.11.0 oder eine ähnliche Nummer. Perfekt!

Wenn du immer noch eine Fehlermeldung siehst: Schließe das Terminal komplett und öffne es erneut.

Schritt 1: OpenClaw installieren

Jetzt geht's los!

Du bist jetzt im Terminal. Kopiere diesen Befehl:

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

So machst du es:

  1. Klick auf den "Kopieren"-Button rechts oben am Befehl
  2. Klick ins Terminal
  3. Drücke Cmd + V um einzufügen
  4. Drücke Enter

Was passiert:

Der Computer lädt OpenClaw herunter und installiert es. Das dauert 2-3 Minuten.

Du siehst Zeile für Zeile Text (grün oder weiß). Das ist normal.

Am Ende solltest du sehen:

Installation complete!

Super! OpenClaw ist installiert.

Schritt 2: OpenClaw einrichten (Onboard)

Der nächste Schritt führt dich durch einen "Assistenten" — eine Art Frage-Antwort Dialog.

Im Terminal, tippe:

openclaw onboard --install-daemon

Drücke Enter.

Der Assistent stellt dir Fragen. Du antwortest mit Pfeiltasten und Enter.

Frage 1: Welcher KI-Anbieter?

Du siehst Optionen wie:

Welcher KI-Anbieter möchtest du nutzen?

  > Anthropic (Claude)
    OpenAI (ChatGPT)
    Google (Gemini)
    OpenRouter
  • Anthropic (Claude): Beste Wahl wenn du ein Claude-Abo hast
  • OpenAI: Wenn du ChatGPT nutzt
  • Google: Kostenlose Option (Google Gemini)
  • OpenRouter: Mehrere Modelle auf einmal

Wie wählst du?

  1. Drücke die Pfeiltaste nach oben oder unten um eine Option zu markieren
  2. Drücke Enter um die Option zu wählen

Empfehlung: Wenn du kein Abo hast, wähle Google (Gemini) — das ist kostenlos. Wenn du ein Claude-Abo hast, wähle Anthropic (Claude).

Frage 2: API-Key eingeben

Je nachdem was du gewählt hast, fragt der Assistent nach deinem API-Key.

Was ist ein API-Key? Das ist ein Passwort/Code, das dem Assistenten erlaubt, Claude oder ChatGPT zu nutzen.

Für Anthropic (Claude):

  1. Öffne deinen Browser
  2. Geh auf console.anthropic.com
  3. Melde dich an (oder registriere dich)
  4. Klick auf "API Keys" links
  5. Klick auf "Create Key"
  6. Kopiere den langen Code
  7. Füg ihn ins Terminal ein (Cmd + V)
  8. Drücke Enter

Für OpenAI (ChatGPT):

  1. Geh auf platform.openai.com/account/api-keys
  2. Melde dich an
  3. Klick auf "Create new secret key"
  4. Kopiere den Code
  5. Füg ihn ins Terminal ein (Cmd + V)
  6. Drücke Enter

Für Google (Gemini) — kostenlos:

  1. Der Assistent führt dich durch OAuth
  2. Du wirst zu Google weitergeleitet
  3. Du meldest dich an (wie bei Gmail)
  4. Du gibst OpenClaw Erlaubnis
  5. Fertig — kein API-Key nötig

Frage 3: Berechtigungen für macOS

macOS fragt jetzt: "Darf OpenClaw das tun?"

  • Automation — Ja, erlaube das (damit OpenClaw Apps steuern kann)
  • Benachrichtigungen — Ja, erlaube das (damit du Nachrichten bekommst)
  • Bildschirmaufnahme (optional) — Nur wenn du willst
  • Mikrofon (optional) — Nur wenn du willst

Bei jedem Pop-up: Klick auf "Erlauben" oder "Allow".

Frage 4: Messaging-Kanäle (WhatsApp, Telegram, etc.)

Der Assistent fragt: "Welche Chat-Apps willst du nutzen?"

Du siehst Optionen wie WhatsApp, Telegram, Discord, iMessage, Signal.

Empfehlung für Anfänger: Starte mit WhatsApp — das ist am einfachsten. Drücke Pfeiltaste, um WhatsApp zu markieren, und drücke Leertaste um es einzuschalten.

Frage 5: Gateway starten?

Der Assistent fragt: "Gateway als Daemon starten?"

Antwort: JA. Das bedeutet: OpenClaw läuft automatisch im Hintergrund, auch nach einem Neustart.

Installation fertig!

Du siehst am Ende:

OpenClaw Gateway installed successfully!
Daemon configured
Ready to go!

Schritt 3: Dashboard öffnen

Das Dashboard ist das "Kontrollzentrum" von OpenClaw.

Im Terminal, tippe:

openclaw dashboard

Drücke Enter.

Dein Browser öffnet sich automatisch. Du siehst die OpenClaw-Interface — das ist dein neues Kontrollzentrum!

Falls der Browser sich NICHT öffnet:

Öffne deinen Browser manuell und geh auf:

http://localhost:18789

Schritt 4: Erste Test-Nachricht

Jetzt testen wir, ob alles funktioniert!

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

OpenClaw sollte dir antworten! Wenn das funktioniert: Herzlichen Glückwunsch! OpenClaw läuft!

Schritt 5: WhatsApp verbinden (Optional)

Du kannst OpenClaw auch per WhatsApp steuern — sehr praktisch!

Im Terminal, tippe:

openclaw channels login --channel whatsapp

Drücke Enter. Im Terminal erscheint ein QR-Code.

QR-Code mit Handy scannen:

  1. Öffne WhatsApp auf deinem Handy
  2. Geh zu Einstellungen (unten rechts)
  3. Klick auf "Verknüpfte Geräte"
  4. Klick auf "Gerät hinzufügen"
  5. Halte die Kamera über den QR-Code im Terminal
  6. WhatsApp verknüpft sich automatisch

Test: Schreib in WhatsApp: "Was kannst du tun?" — OpenClaw sollte antworten!

Häufige Fehler und Lösungen

"command not found: openclaw"

Lösung: Schließe das Terminal komplett (Cmd + Q) und öffne es erneut. Dann versuche nochmal.

"curl: command not found"

Lösung: Probiere:

/bin/bash -c "$(curl -fsSL https://openclaw.ai/install.sh)"

Falls immer noch nicht: Installiere Xcode Command Line Tools:

xcode-select --install

"macOS blockiert die App"

Lösung:

  1. Geh zu Systemeinstellungen
  2. Klick auf "Datenschutz & Sicherheit"
  3. Scroll nach unten
  4. Klick auf "Trotzdem öffnen"
  5. Bestätige mit deinem Passwort

"QR-Code für WhatsApp erscheint nicht"

Lösung: Prüfe ob Gateway läuft:

openclaw gateway status

Falls nicht, starte es:

openclaw gateway restart

Warte 5 Sekunden und versuche WhatsApp-Login nochmal.

"KI antwortet nicht / Timeout"

Lösung:

  1. Prüfe deinen API-Key:
openclaw models list
  1. Starte Gateway neu:
openclaw gateway restart

"Cannot find module 'xyz'"

Lösung: Reinstalliere:

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

Nützliche Befehle

Dashboard öffnen

openclaw dashboard

Status prüfen

openclaw gateway status

Neu starten

openclaw gateway restart

Stoppen

openclaw gateway stop

Verbundene Kanäle anzeigen

openclaw channels status

Konfigurierte KI-Modelle anzeigen

openclaw models list

Selbst-Diagnose

openclaw doctor

Alles funktioniert?

Herzlichen Glückwunsch! Du hast OpenClaw erfolgreich installiert!

Nächste Schritte:

  1. Erkunde das Dashboard — schau dich um
  2. Verbinde mehr Kanäle — Telegram, Discord, etc.
  3. Installiere Skills — das sind Erweiterungen
  4. Testen und Spaß haben — nutze deine neue KI!

Immer noch Probleme?

Selbst-Hilfe: Schließ Terminal und öffne erneut. Starte deinen Mac neu.

Support: Schreib an support@markusstoeger.com — beschreib was nicht funktioniert und kopier die Fehler-Nachricht aus dem Terminal.

Managed Hosting: Keine Lust auf Terminal? Wir richten alles für dich ein. €19/Monat, 7 Tage kostenlos.

Zu kompliziert? Wir machen das für dich.

Managed Hosting: In 60 Sekunden fertig. 7 Tage kostenlos.

7 Tage kostenlos testen