OpenClaw installieren: Schnelle Einrichtung in 5 Minuten

Ich hänge fest – was ist der schnellste Weg zur Lösung?

Nutze einen lokalen AI-Agenten, der deinen Rechner sehen kann. Das ist viel effektiver, als in Discord zu fragen, da die meisten Probleme durch lokale Konfigurations- oder Umgebungsfehler entstehen, die Helfer aus der Ferne nicht prüfen können.

• Claude Code: https://www.anthropic.com/claude-code/
• OpenAI Codex: https://openai.com/codex/

Diese Tools können das Repo lesen, Befehle ausführen, Logs prüfen und dir bei der Einrichtung auf Systemebene helfen (PATH, Services, Berechtigungen, Auth-Dateien). Gib ihnen den vollen Source-Checkout über die (git) Installation:

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

Starte mit diesen Befehlen (teile die Ergebnisse, wenn du um Hilfe bittest):

openclaw status
openclaw models status
openclaw doctor

Was ist der empfohlene Weg, um OpenClaw zu installieren und einzurichten?

Das Repo empfiehlt, direkt aus dem Quellcode zu starten und den Onboarding-Wizard zu nutzen:

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

Der Wizard kann UI-Assets automatisch bauen. Nach dem Onboarding läuft das Gateway normalerweise auf Port 18789.

Aus dem Quellcode (Contributors/Dev):

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

Wie öffne ich das Dashboard nach dem Onboarding?

Der Wizard öffnet deinen Browser direkt nach dem Onboarding mit einer URL inklusive Token und gibt den vollständigen Link (mit Token) in der Zusammenfassung aus. Lass diesen Tab offen. Falls er nicht automatisch startet, kopiere die angezeigte URL auf demselben Rechner.

Wie authentifiziere ich das Dashboard (Token) lokal vs. remote?

Localhost (gleicher Rechner):

• Öffne http://127.0.0.1:18789/
• Wenn nach einer Authentifizierung gefragt wird, führe openclaw dashboard aus und nutze den Link mit dem Token (?token=...)

Nicht auf Localhost:

• Tailscale Serve (empfohlen): Behalte den Loopback-Bind bei und führe openclaw gateway --tailscale serve aus.
• Tailnet bind: Führe openclaw gateway --bind tailnet --token "<token>" aus.
• SSH-Tunnel: ssh -N -L 18789:127.0.0.1:18789 user@host

Welche Runtime brauche ich?

Node >= 22 ist erforderlich. pnpm wird empfohlen. Bun wird für das Gateway nicht empfohlen.

---

Läuft es auf einem Raspberry Pi?

Ja. Das Gateway ist leichtgewichtig – die Dokumentation nennt 512 MB - 1 GB RAM, 1 Core, etwa 500 MB Speicherplatz und ein 64-Bit-Betriebssystem als ausreichend für den persönlichen Gebrauch. Ein Raspberry Pi 4 kann es ausführen.

Wenn du zusätzlichen Spielraum für Logs, Medien oder andere Dienste benötigst, sind 2 GB empfehlenswert.

Tipp: Ein kleiner Pi oder VPS kann das Gateway hosten. Du kannst dann Nodes auf deinem Laptop oder Smartphone für lokale Funktionen wie Kamera oder Canvas koppeln.

---

Tipps für die Installation auf dem Raspberry Pi?

• Nutze ein 64-Bit Betriebssystem und achte darauf, dass Node >= 22 installiert ist.
• Bevorzuge die hackbare (git) Installation, damit du Logs einsehen und Updates schnell durchführen kannst.
• Starte zunächst ohne Channels oder Skills und füge diese erst später einzeln hinzu.
• Falls du auf seltsame Binary-Probleme stößt, liegt das meist an der ARM-Kompatibilität.

---

Es hängt bei „wake up my friend“ / das Onboarding startet nicht. Was nun?

Dieser Bildschirm setzt voraus, dass das Gateway erreichbar und authentifiziert ist.

1. Starte das Gateway neu:

   openclaw gateway restart

2. Prüfe den Status und die Authentifizierung:

   openclaw status
   openclaw models status
   openclaw logs --follow

3. Wenn es immer noch hakt, führe diesen Befehl aus:

   openclaw doctor

AI Setup Assistant

Kann ich mein Setup auf einen neuen Rechner (Mac mini) übertragen, ohne das Onboarding erneut zu machen?

Ja. Kopiere das state directory und den workspace, und führe dann einmal Doctor aus:

1. Installiere OpenClaw auf dem neuen Rechner
2. Kopiere $OPENCLAW_STATE_DIR (Standard: ~/.openclaw) vom alten Rechner
3. Kopiere deinen workspace (Standard: ~/.openclaw/workspace)
4. Führe openclaw doctor aus und starte den Gateway Service neu

Das übernimmt deine Konfiguration, Auth-Profile, WhatsApp-Credentials, Sessions und das Memory.

Wo sehe ich, was in der neuesten Version neu ist?

Schau in den GitHub Changelog: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

Was ist der Unterschied zwischen Stable und Beta?

Stable und beta sind npm dist-tags, keine getrennten Code-Zweige:

• latest = stable
• beta = früher Build zum Testen

Wir veröffentlichen Builds zuerst als beta, testen sie und sobald sie stabil laufen, befördern wir genau diese Version zu latest.

Wie installiere ich die Beta-Version?

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

Für eine modifizierbare (git) Installation:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Wie lange dauern Installation und Onboarding normalerweise?

• Installation: 2-5 Minuten
• Onboarding: 5-15 Minuten, je nachdem, wie viele Channels und Modelle du konfigurierst.

---

Installer hängt? Wie bekomme ich mehr Feedback?

Starte den Installer einfach noch einmal mit verbose output:

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

---

Windows-Installation meldet “git not found” oder “openclaw not recognized”

1) npm error spawn git / git not found

• Installiere Git for Windows und stelle sicher, dass git in deinem PATH hinterlegt ist.
• Schließe PowerShell, öffne es neu und starte den Installer erneut.

2) openclaw wird nach der Installation nicht erkannt

• Dein globaler npm-bin-Ordner ist nicht im PATH.
• Prüfe den Pfad mit: npm config get prefix
• Stelle sicher, dass <prefix>\bin im PATH enthalten ist.

Wenn du das flüssigste Windows-Setup suchst, empfehle ich dir WSL2 anstelle von nativem Windows.

---

Wie installiere ich OpenClaw auf Linux?

Folge dem Linux-Guide und starte danach den Onboarding-Wizard:

• Linux Quick Path + Service-Installation: Linux
• Komplette Anleitung: Getting Started

Wie installiere ich OpenClaw auf einem VPS?

Jeder Linux-VPS funktioniert. Installiere OpenClaw auf dem Server und nutze SSH oder Tailscale, um das Gateway zu erreichen.

Guides: Hetzner, Fly.io, exe.dev

---

Kann ich OpenClaw bitten, sich selbst zu aktualisieren?

Kurze Antwort: möglich, aber nicht empfohlen. Der Update-Prozess kann das Gateway neu starten (was die aktive Session abbricht), einen sauberen git checkout erfordern, nach Bestätigungen fragen oder den Vorgang unterbrechen. Sicherer ist es, Updates als Operator direkt über eine Shell auszuführen.

openclaw update
openclaw update status
openclaw update --channel stable|beta|dev

---

Was macht der Onboarding-Wizard eigentlich?

openclaw onboard führt dich durch diese Schritte:

• Model/auth setup (Anthropic setup-token, OpenAI Codex OAuth, API keys, local models)
• Workspace Speicherort + bootstrap files
• Gateway settings (bind/port/auth/tailscale)
• Providers (WhatsApp, Telegram, Discord, Signal, iMessage)
• Daemon install (LaunchAgent auf macOS; systemd user unit auf Linux/WSL2)
• Health checks und die Auswahl der skills

---

Brauche ich ein Claude- oder OpenAI-Abo, um das zu nutzen?

Nein. Du kannst OpenClaw mit API keys (Anthropic/OpenAI/andere) oder mit local-only models betreiben, damit deine Daten auf deinem Gerät bleiben. Abos sind lediglich optionale Wege, um diese Provider zu authentifizieren.

AI Setup Assistant

Kann ich das Claude Max Abonnement ohne einen API key nutzen?

Ja. Du kannst dich mit einem setup-token anstelle eines API key authentifizieren. Das ist der Weg über das Abonnement.

---

Wie funktioniert die Anthropic setup-token Authentifizierung?

claude setup-token generiert einen token string über das Claude Code CLI (nicht in der Web-Konsole verfügbar). Du kannst das auf jedem Rechner ausführen. Wähle Anthropic token (paste setup-token) im Wizard aus oder füge ihn hiermit ein:

openclaw models auth paste-token --provider anthropic

---

Wo finde ich einen Anthropic setup-token?

Du findest ihn nicht in der Anthropic Console. Der setup-token wird vom Claude Code CLI generiert:

claude setup-token

Kopiere den ausgegebenen Token und wähle dann Anthropic token (paste setup-token) im Wizard.

---

Warum sehe ich HTTP 429: rate_limit_error von Anthropic?

Dein Anthropic quota/rate limit ist für das aktuelle Zeitfenster erschöpft. Wenn du ein Claude subscription nutzt, warte, bis das Fenster zurückgesetzt wird, oder upgrade deinen Plan. Wenn du einen Anthropic API key verwendest, prüfe die Anthropic Console auf Nutzung und Abrechnung.

Tipp: Richte ein fallback model ein, damit OpenClaw weiter antworten kann, während ein Provider im rate-limit ist.

AI Setup Assistant

Wird AWS Bedrock unterstützt?

Ja – über den Amazon Bedrock (Converse) Provider von pi-ai mit manual config. Du musst AWS Credentials und die Region auf dem Gateway Host bereitstellen und einen Bedrock Provider-Eintrag in deiner Models Config hinzufügen.

Wie funktioniert die Codex-Authentifizierung?

OpenClaw unterstützt OpenAI Code (Codex) via OAuth (ChatGPT Login). Der Wizard kann den OAuth Flow ausführen und setzt das Default Model auf openai-codex/gpt-5.2, wenn es angebracht ist.

Wie richte ich Gemini CLI OAuth ein?

Gemini CLI nutzt einen plugin auth flow:

openclaw plugins enable google-gemini-cli-auth
openclaw models auth login --provider google-gemini-cli --set-default

Ist ein lokales Modell für lockere Chats geeignet?

Meistens nein. OpenClaw braucht einen großen Context und starke Safety; kleine Karten schneiden Inhalte ab und verursachen Leaks. Wenn es sein muss, nutze den größten MiniMax M2.1 Build, den du lokal (LM Studio) ausführen kannst.

Wichtige Warnung: Kleinere oder quantisierte Modelle erhöhen das Risiko für Prompt-Injection.

AI Setup Assistant

Muss ich einen Mac Mini kaufen, um das zu installieren?

Nein. OpenClaw läuft auf macOS oder Linux (Windows über WSL2). Ein Mac Mini ist optional – manche kaufen einen als Always-on-Host, aber ein kleiner VPS, Home-Server oder eine Box in der Raspberry Pi-Klasse funktioniert auch.

Du brauchst einen Mac nur für macOS-exklusive Tools. Für iMessage solltest du BlueBubbles verwenden (empfohlen).

Brauche ich einen Mac Mini für iMessage-Support?

Du brauchst irgendein macOS-Gerät, das bei Messages angemeldet ist. Es muss kein Mac Mini sein – jeder Mac funktioniert. Nutze BlueBubbles (empfohlen) für iMessage.

Kann ich Bun verwenden?

Bun wird nicht empfohlen. Wir sehen Runtime-Bugs, besonders bei WhatsApp und Telegram. Nutze Node für stabile Gateways.

Telegram: Was kommt in allowFrom?

channels.telegram.allowFrom ist die Telegram-User-ID des menschlichen Absenders (numerisch, empfohlen) oder der @username. Es ist nicht der Bot-Username.

So findest du deine ID:

• Schicke deinem Bot eine DM, führe dann openclaw logs --follow aus und lies from.id aus
• Rufe https://api.telegram.org/bot<bot_token>/getUpdates auf und lies message.from.id aus

Können mehrere Personen eine WhatsApp-Nummer mit verschiedenen OpenClaw-Instanzen nutzen?

Ja, das geht über multi-agent routing. Verknüpfe die WhatsApp DM jedes Absenders mit einer anderen agentId, damit jede Person ihren eigenen Workspace und Session-Speicher erhält.

Kann ich einen “Fast Chat”-Agent und einen “Opus for Coding”-Agent betreiben?

Ja. Nutze multi-agent routing: Gib jedem Agent sein eigenes Standard-Model und verknüpfe dann die eingehenden Routes mit dem jeweiligen Agent.

Was ist der Unterschied zwischen der Hackable- (git) und der npm-Installation?

• Hackable (git) install: Vollständiger Source-Checkout, editierbar und am besten für Contributors geeignet. Du führst Builds lokal aus und kannst Code oder Docs patchen.
• npm install: Globale CLI-Installation ohne Repository, ideal, wenn du es einfach nur nutzen willst. Updates kommen über npm dist-tags.

Kann ich später zwischen npm- und git-Installationen wechseln?

Ja. Installiere die andere Variante und führe dann Doctor aus, damit der Gateway-Service auf den neuen Entrypoint zeigt. Das löscht deine Daten nicht – es ändert lediglich die OpenClaw Code-Installation.

AI Setup Assistant

Sollte ich das Gateway auf meinem Laptop oder einem VPS betreiben?

Wenn du Zuverlässigkeit rund um die Uhr willst, nimm einen VPS. Wenn du so wenig Aufwand wie möglich haben willst und kein Problem mit Standby-Modus oder Neustarts hast, lass es lokal laufen.

Laptop (lokales Gateway)

• Vorteile: keine Serverkosten, direkter Zugriff auf lokale Dateien
• Nachteile: Standby oder Netzwerkabbrüche sorgen für Disconnects, OS-Updates und Reboots unterbrechen den Betrieb

VPS / Cloud

• Vorteile: immer online, stabiles Netzwerk
• Nachteile: oft “headless” Betrieb (nutze Screenshots), nur Remote-Dateizugriff

---

Wie wichtig ist es, OpenClaw auf einem dedizierten Rechner zu betreiben?

Es ist nicht zwingend erforderlich, aber für Zuverlässigkeit und Isolation empfohlen.

• Dedizierter Host (VPS/Mac mini/Pi): immer an, weniger Unterbrechungen
• Geteilter Laptop/Desktop: völlig okay für Tests und aktive Nutzung

---

Was sind die Mindestanforderungen für einen VPS und das empfohlene OS?

OpenClaw ist leichtgewichtig:

• Absolutes Minimum: 1 vCPU, 1GB RAM
• Empfohlen: 1-2 vCPU, 2GB RAM oder mehr

OS: Nutze Ubuntu LTS (oder jedes aktuelle Debian/Ubuntu).

---

Kann ich OpenClaw in einer VM betreiben und was sind die Anforderungen?

Ja. Behandle eine VM genau wie einen VPS: Sie muss immer an und erreichbar sein sowie genug RAM für das Gateway und alle aktivierten Channels haben.

• Absolutes Minimum: 1 vCPU, 1GB RAM
• Empfohlen: 2GB RAM oder mehr

Wenn du Windows nutzt, ist WSL2 das einfachste Setup im VM-Stil.

AI Setup Assistant