OpenClaw zum ersten Mal installieren:
2026 Leitfaden von der Vorbereitung bis zum ersten Test

0 Was dieser Leitfaden erreicht

Am Ende sollten Sie vier Dinge bestätigen können: ① CLI und Gateway installiert; ② Modell-Provider und API-Key verbunden; ③ Control UI öffnet sich lokal im Browser; ④ eine risikoarme Lese-/Schreibaufgabe im Testordner funktioniert. Ziel ist nicht nur „installiert“, sondern „im kontrollierten Rahmen einsatzbereit — und bei Fehlern selbst debuggen können“.

1 Vor der Installation: Mac, Netzwerk und Testordner

Was / warum / Erfolg: Zuerst die Voraussetzungen bündeln, damit Sie nicht mitten im Ablauf debuggen müssen. Sie brauchen Terminal, die offizielle Installationsdokumentation und einen fertigen Testordner.

• System — macOS auf Apple Silicon oder Intel. OpenClaw erwartet Node 24 (empfohlen) oder Node 22.19+; das offizielle Installationsskript übernimmt Node automatisch — Homebrew ist optional, nicht Pflicht am Anfang.
• Netzwerk und Admin — Zugriff auf openclaw.ai und Ihren Modell-Anbieter; Config und LaunchAgent können das macOS-Administratorpasswort verlangen.
• Modellkonto — bei Anthropic, OpenAI, OpenRouter o. Ä. registrieren und einen API-Key anlegen (Zugangsdaten zum Modellservice — wie ein Passwort; nie in Git committen).
• Testordner — z. B. ~/openclaw-test mit einer notes.txt darin. Der Arbeitsordner ist der Bereich, den OpenClaw bearbeiten darf — am Anfang nur dieser.

2 Installation: nur offizielle Quellen, Ausgabe speichern

CLI und Gateway ausschließlich über offizielle Quellen installieren — inoffizielle Pakete können manipuliert sein. Erfolg = openclaw --version zeigt eine Versionsnummer.

Auf dem Mac empfohlen (erkennt OS, installiert Node, startet Onboarding):

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

Wenn Sie Node selbst verwalten: npm install -g openclaw@latest, danach openclaw onboard --install-daemon für den LaunchAgent-Hintergrunddienst unter macOS.

Speichern Sie Version und vollständige Terminalausgabe (Screenshot oder Notizen) — hilfreich beim Troubleshooting. Prüfen mit:

openclaw --version · openclaw doctor · openclaw gateway status

3 Konfiguration: Provider, API-Key und Config-Datei

Kurz erklärt: Provider = Cloud-Dienst (Anthropic, OpenAI usw.); API-Key = Zugangsdaten; Umgebungsvariable = Shell-Einstellung (z. B. export ANTHROPIC_API_KEY=...); Config-Datei = dauerhafte Einstellungen in ~/.openclaw/openclaw.json. Lokale Modelle (Ollama) sind optional — für den Ersttest reicht ein Cloud-Key.

Onboarding-Assistent starten (Provider wählen, Key einfügen, Standardmodell setzen):

openclaw onboard --install-daemon

Erfolg: openclaw doctor ohne blockierende Fehler; „Hallo“ im Dashboard oder CLI erhält eine Modellantwort. Bei Blockade: Key erneut kopieren, Abrechnung/Limits prüfen, ob ein Proxy HTTPS blockiert.

4 Berechtigungen: zuerst nur den Testordner freigeben

Lese-/Schreibpfade begrenzen und macOS-Dialoge vorsichtig bestätigen — Vollzugriff auf die Festplatte übergibt den ganzen Mac an die Automatisierung. Erfolg = Dateien ändern sich nur in ~/openclaw-test.

Bezeichnungen unter Systemeinstellungen → Datenschutz & Sicherheit (Dateien und Ordner, Automatisierung, Bedienungshilfen usw.) variieren je nach macOS-Version — orientieren Sie sich am Bildschirm. Empfehlungen:

• Nur den Testordner freigeben — nicht „Gesamte Festplatte“ oder iCloud-Stammverzeichnis am ersten Tag.
• Kalender, Kontakte, Bildschirmaufnahme und Ähnliches ablehnen, solange Sie es für den Ersttest nicht brauchen.
• Gateway-Port nicht ins Internet stellen — nur lokal oder hinter VPN.

5 Dashboard öffnen: lokale URL und Remote-Mac

Control UI laden, um Gateway und Sitzungen zu prüfen. openclaw dashboard ausführen oder http://127.0.0.1:18789/ im Browser öffnen (nur localhost).

Logs sind Ihr Beweis — openclaw doctor mit der offiziellen Hilfe / Troubleshooting abgleichen, statt die Config zu raten.

6 Erster Lauf: risikoarme Testaufgabe

Schreiben Sie zwei Zeilen in ~/openclaw-test/notes.txt, z. B. „Projektcode: Alpha.“ Im Dashboard oder CLI senden:

Lies notes.txt im Ordner openclaw-test, fasse es in drei Sätzen zusammen und schreibe summary.md in denselben Ordner.

Es läuft, wenn: ① die Antwort zur Datei passt; ② summary.md im Ordner liegt; ③ openclaw doctor weiterhin OK ist; ④ die Logs die Anfrage zeigen (nicht leer). Schlägt das Schreiben fehl, zuerst macOS-Dateizugriff prüfen — nicht gleich das Modell beschuldigen.

7 Häufige Einsteigerfehler

8 OpenClaw auf dem Mac mini — einfacher im Dauerbetrieb

OpenClaw ist eine selbst gehostete Gateway-Lösung: Dauerbetrieb auf dem Alltags-MacBook konkurriert mit Ihrer Arbeit. Der Mac mini M4 bleibt leise bei etwa 4 W im Leerlauf, führt das offizielle Installationsskript und den LaunchAgent nativ aus und passt gut zu Gatekeeper, SIP und FileVault für ein abgeschottetes Agent-Konto. Zuerst den Testfall lokal validieren, dann auf einen dedizierten Mac mini migrieren — Optionen unten.