FAQ: Einrichtung beim ersten Start

Verwenden Sie einen lokalen KI-Agenten, der Ihren Rechner einsehen kann. In den meisten Fällen, in denen Sie nicht weiterkommen, liegen lokale Konfigurations- oder Umgebungsprobleme vor, die eine Remote-Hilfskraft nicht untersuchen kann. Dies ist daher effektiver, als in Discord nachzufragen.

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

Stellen Sie dem Agenten über die anpassbare Installation (git) den vollständigen Quellcode-Checkout bereit, damit er Code und Dokumentation lesen und die von Ihnen ausgeführte Version genau analysieren kann:

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

Bitten Sie den Agenten, die Behebung schrittweise zu planen und zu überwachen und anschließend nur die erforderlichen Befehle auszuführen – kleinere Diffs lassen sich leichter prüfen.

Geben Sie bei einer Supportanfrage (in Discord oder einem GitHub-Issue) die Ausgaben dieser Befehle an:

Haben Sie einen echten Fehler oder eine Korrektur gefunden? Erstellen Sie ein Issue oder senden Sie einen PR: Issues / Pull Requests.

Schnelle Debugging-Schleife: Die ersten 60 Sekunden, wenn etwas nicht funktioniert. Installationsdokumentation: Installation, Installationsprogramm-Flags, Aktualisierung.

Im Aufgabenmodus werden Fälligkeitszeitstempel erst nach Abschluss eines tatsächlichen Heartbeat-Laufs weitergesetzt. Übersprungene Läufe markieren Aufgaben nicht als abgeschlossen.

Dokumentation: Heartbeat, Automatisierung.

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bashopenclaw onboard --install-daemon

Aus dem Quellcode (Mitwirkende/Entwicklung):

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm buildpnpm ui:buildopenclaw onboard

Noch keine globale Installation? Führen Sie stattdessen pnpm openclaw onboard aus. Wenn die Assets der Control UI fehlen, versucht das Onboarding, sie selbst zu erstellen, und greift andernfalls auf pnpm ui:build zurück.

Das Onboarding öffnet unmittelbar nach der Einrichtung Ihren Browser mit einer sauberen (nicht tokenisierten) Dashboard-URL und gibt den Link in der Zusammenfassung aus. Lassen Sie diesen Tab geöffnet. Falls er nicht geöffnet wurde, kopieren Sie die ausgegebene URL auf demselben Rechner und fügen Sie sie dort ein.

Localhost (derselbe Rechner):

• Öffnen Sie http://127.0.0.1:18789/.
• Wenn eine Authentifizierung mit einem gemeinsamen Geheimnis verlangt wird, fügen Sie das konfigurierte Token oder Passwort in die Einstellungen der Control UI ein.
• Token-Quelle: gateway.auth.token (oder OPENCLAW_GATEWAY_TOKEN).
• Passwortquelle: gateway.auth.password (oder OPENCLAW_GATEWAY_PASSWORD).
• Noch kein gemeinsames Geheimnis konfiguriert? Führen Sie openclaw doctor --generate-gateway-token (oder openclaw doctor --fix --generate-gateway-token) aus.

Nicht auf localhost:

• Tailscale Serve (empfohlen): Belassen Sie die Bindung auf Loopback, führen Sie openclaw gateway --tailscale serve aus und öffnen Sie https://<magicdns>/. Bei gateway.auth.allowTailscale: true erfüllen Identitätsheader die Authentifizierung für Control UI/WebSocket (kein Einfügen eines gemeinsamen Geheimnisses erforderlich; ein vertrauenswürdiger Gateway-Host wird vorausgesetzt). HTTP-APIs benötigen weiterhin eine Authentifizierung mit einem gemeinsamen Geheimnis, sofern Sie nicht bewusst none für privaten Ingress oder die HTTP-Authentifizierung über einen vertrauenswürdigen Proxy verwenden. Gleichzeitige fehlgeschlagene Serve-Authentifizierungsversuche desselben Clients werden serialisiert, bevor der Begrenzer für fehlgeschlagene Authentifizierungen sie erfasst. Daher kann bereits beim zweiten fehlgeschlagenen Versuch retry later angezeigt werden.
• Tailnet-Bindung: Führen Sie openclaw gateway --bind tailnet --token "<token>" aus (oder konfigurieren Sie die Passwortauthentifizierung), öffnen Sie http://<tailscale-ip>:18789/ und fügen Sie das passende gemeinsame Geheimnis in die Dashboard-Einstellungen ein.
• Identitätsbewusster Reverse-Proxy: Belassen Sie das Gateway hinter einem vertrauenswürdigen Proxy, setzen Sie gateway.auth.mode: "trusted-proxy" und öffnen Sie die Proxy-URL. Loopback-Proxys auf demselben Host benötigen ausdrücklich gateway.auth.trustedProxy.allowLoopback: true.
• SSH-Tunnel: ssh -N -L 18789:127.0.0.1:18789 user@gateway-host; öffnen Sie anschließend http://127.0.0.1:18789/. Die Authentifizierung mit einem gemeinsamen Geheimnis gilt weiterhin über den Tunnel. Fügen Sie bei Aufforderung das konfigurierte Token oder Passwort ein.

Weitere Informationen zu Bindungsmodi und Authentifizierung finden Sie unter Dashboard und Weboberflächen.

Sie steuern unterschiedliche Ebenen:

• approvals.exec – leitet Genehmigungsaufforderungen an Chat-Ziele weiter.
• channels.<channel>.execApprovals – macht diesen Kanal zu einem nativen Genehmigungsclient für exec-Genehmigungen.

Die exec-Richtlinie des Hosts bleibt die eigentliche Genehmigungsschranke; die Chat-Konfiguration steuert lediglich, wo Aufforderungen angezeigt werden und wie Personen darauf antworten.

Sie benötigen nur selten beide:

• Wenn der Chat bereits Befehle und Antworten unterstützt, funktioniert /approve im selben Chat über den gemeinsamen Pfad.
• Wenn ein unterstützter nativer Kanal Genehmigende sicher ermitteln kann, aktiviert OpenClaw automatisch native Genehmigungen mit Vorrang für Direktnachrichten, wenn channels.<channel>.execApprovals.enabled nicht gesetzt ist oder den Wert "auto" hat.
• Wenn native Genehmigungskarten/-schaltflächen verfügbar sind, hat diese Benutzeroberfläche Vorrang; erwähnen Sie einen manuellen /approve-Befehl nur, wenn das Tool-Ergebnis angibt, dass Chat-Genehmigungen nicht verfügbar sind.
• Verwenden Sie approvals.exec nur, wenn Aufforderungen auch andere Chats oder explizite Betriebsräume erreichen müssen.
• Verwenden Sie channels.<channel>.execApprovals.target: "channel" oder "both" nur, wenn Genehmigungsaufforderungen zurück in den ursprünglichen Raum bzw. das ursprüngliche Thema gesendet werden sollen.
• Plugin-Genehmigungen werden separat behandelt: standardmäßig mit /approve im selben Chat, optionaler Weiterleitung über approvals.plugin, und nur einige native Kanäle behalten auch dafür die native Verarbeitung bei.

Kurz gesagt: Die Weiterleitung dient der Zustellung, die native Client-Konfiguration einer umfangreicheren kanalspezifischen Benutzererfahrung. Siehe Ausführungsgenehmigungen.

Node 22.19+ ist erforderlich (Node 24 wird empfohlen). pnpm ist der Paketmanager des Repositorys. Bun wird für den Gateway nicht empfohlen.

Ja, prüfen Sie jedoch zuerst den RAM: Pi 5 und Pi 4 (2 GB+) sind ideal; Pi 3B+ (1 GB) funktioniert, ist aber langsam; Pi Zero 2 W (512 MB) wird nicht empfohlen.

Absolutes Minimum: 1 GB RAM, 1 Kern, 500 MB freier Speicherplatz, 64-Bit-Betriebssystem. Da auf dem Pi nur der Gateway läuft (Modelle rufen Cloud-APIs auf), bewältigt selbst ein einfacher Pi die Last.

Ein kleiner Pi/VPS kann auch nur den Gateway hosten, während Sie Nodes auf Ihrem Laptop/Telefon für lokalen Bildschirm-/Kamera-/Canvas-Zugriff oder die Befehlsausführung koppeln. Siehe Nodes.

Vollständige Einrichtungsanleitung: Raspberry Pi.

• Verwenden Sie ein 64-Bit-Betriebssystem; verwenden Sie nicht die 32-Bit-Version von Raspberry Pi OS.
• Fügen Sie bei Boards mit 2 GB oder weniger Swap hinzu.
• Bevorzugen Sie für Leistung und Lebensdauer eine USB-SSD gegenüber einer SD-Karte.
• Bevorzugen Sie die anpassbare Installation über git, damit Sie Protokolle einsehen und schnell aktualisieren können.
• Beginnen Sie ohne Kanäle/Skills und fügen Sie sie einzeln hinzu.
• Ungewöhnliche Binärdateifehler („exec format error“) werden normalerweise durch einen fehlenden ARM64-Build für ein optionales Skill-Tool verursacht.

Vollständige Anleitung: Raspberry Pi. Siehe auch Linux.

Dieser Bildschirm setzt voraus, dass der Gateway erreichbar und authentifiziert ist. Die TUI sendet außerdem beim ersten Start automatisch „Wake up, my friend!“, wenn ein Modell-Provider konfiguriert ist. Wenn Sie die Modell-/Authentifizierungseinrichtung übersprungen haben, zeigt das Onboarding den Hinweis „Model auth missing“ an und öffnet die TUI, ohne etwas zu senden — fügen Sie mit openclaw configure --section model einen Provider hinzu. Wenn Sie die Aufweckzeile ohne Antwort sehen und die Token-Anzahl bei 0 bleibt, wurde der Agent nie ausgeführt.

1. Starten Sie den Gateway neu:

openclaw gateway restart

2. Prüfen Sie Status und Authentifizierung:

openclaw statusopenclaw models statusopenclaw logs --follow

3. Hängt es weiterhin? Führen Sie Folgendes aus:

openclaw doctor

Wenn der Gateway entfernt ausgeführt wird, vergewissern Sie sich, dass die Tunnel-/Tailscale-Verbindung aktiv ist und die Benutzeroberfläche auf den richtigen Gateway verweist. Siehe Fernzugriff.

Ja. Kopieren Sie das Statusverzeichnis und den Arbeitsbereich und führen Sie anschließend einmal Doctor aus:

1. Installieren Sie OpenClaw auf dem neuen Rechner.
2. Kopieren Sie $OPENCLAW_STATE_DIR (Standard: ~/.openclaw) vom alten Rechner.
3. Kopieren Sie Ihren Arbeitsbereich (Standard: ~/.openclaw/workspace).
4. Führen Sie openclaw doctor aus und starten Sie den Gateway-Dienst neu.

Dadurch bleiben Konfiguration, Authentifizierungsprofile, WhatsApp-Anmeldedaten, Sitzungen und Speicher erhalten – Ihr Bot bleibt exakt gleich, sofern Sie beide Speicherorte kopieren. Im Remote-Modus verwaltet der Gateway-Host den Sitzungsspeicher und den Arbeitsbereich.

Wichtig: Wenn Sie nur Ihren Arbeitsbereich in GitHub committen/pushen, sichern Sie Speicher und Bootstrap-Dateien, jedoch weder den Sitzungsverlauf noch die Authentifizierung. Diese befinden sich unter ~/.openclaw/ (zum Beispiel ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite).

Weitere Informationen: Migration, Speicherorte auf dem Datenträger, Agent-Arbeitsbereich, Doctor, Remote-Modus.

Prüfen Sie das Änderungsprotokoll auf GitHub: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

Die neuesten Einträge stehen ganz oben. Wenn der oberste Abschnitt Unveröffentlicht lautet, ist der nächste datierte Abschnitt die neueste veröffentlichte Version. Die Einträge sind unter Highlights, Änderungen und Fehlerbehebungen gruppiert (sowie bei Bedarf unter Dokumentation/weiteren Abschnitten).

Einige Comcast-/Xfinity-Verbindungen blockieren docs.openclaw.ai fälschlicherweise über Xfinity Advanced Security. Deaktivieren Sie diese Funktion oder setzen Sie docs.openclaw.ai auf die Zulassungsliste und versuchen Sie es erneut. Helfen Sie uns, die Blockierung aufzuheben: https://spa.xfinity.com/check_url_status.

Immer noch blockiert? Die Dokumentation wird auf GitHub gespiegelt: https://github.com/openclaw/openclaw/tree/main/docs

Stable und Beta sind npm-dist-tags, keine separaten Codezweige:

• latest = Stable
• beta = früher Build zum Testen (fällt auf latest zurück, wenn die Beta-Version fehlt oder älter als das aktuelle Stable-Release ist)

Ein Stable-Release wird normalerweise zuerst unter Beta veröffentlicht. Anschließend verschiebt ein ausdrücklicher Hochstufungsschritt dieselbe Version nach latest, ohne die Versionsnummer zu ändern. Maintainer können auch direkt unter latest veröffentlichen. Deshalb können Beta und Stable nach der Hochstufung auf dieselbe Version verweisen.

Änderungen anzeigen: CHANGELOG.md.

Einzeiler für die Installation und den Unterschied zwischen Beta und Dev finden Sie im nächsten Akkordeon.

Beta ist das npm-dist-tag beta (kann nach der Hochstufung mit latest übereinstimmen). Dev ist der sich fortlaufend ändernde Stand von main (Git); bei einer Veröffentlichung auf npm verwendet er das dist-tag dev.

Einzeiler (macOS/Linux):

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

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

Windows-Installationsprogramm (PowerShell): iwr -useb https://openclaw.ai/install.ps1 | iex

Weitere Details: Entwicklungskanäle und Installationsprogramm-Flags.

Zwei Optionen:

1. Dev-Kanal (bestehende Installation):

openclaw update --channel dev

Dadurch wird zu einem Git-Checkout von main gewechselt, dieser auf den Upstream-Stand rebasiert, gebaut und die CLI aus diesem Checkout installiert.

2. Anpassbare Git-Installation (neuer Rechner):

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

Bevorzugen Sie einen manuellen Klon:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm build

Dokumentation: Aktualisieren, Entwicklungskanäle, Installation.

Grobe Orientierung:

• Installation: 2-5 Minuten.
• QuickStart-Onboarding: wenige Minuten (Loopback-Gateway, automatisches Token, Standard-Workspace).
• Erweitertes/vollständiges Onboarding: länger, wenn Provider-Anmeldung, Kanalkopplung, Daemon-Installation, Netzwerkdownloads oder Skills zusätzliche Einrichtung erfordern.

Der Assistent zeigt diesen Zeitrahmen vorab an. Überspringen Sie optionale Schritte und kehren Sie später mit openclaw configure zurück.

Hängt der Vorgang? Siehe oben Ich komme nicht weiter.

Führen Sie es erneut mit --verbose aus:

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

install.ps1 hat keinen eigenen Schalter für ausführliche Ausgaben; umschließen Sie es stattdessen mit Set-PSDebug -Trace 1 / -Trace 0. Vollständige Flag-Referenz: Installationsprogramm-Flags.

Zwei häufige Windows-Probleme:

1) npm-Fehler „spawn git“ / Git nicht gefunden

• Installieren Sie Git for Windows und stellen Sie sicher, dass git im PATH enthalten ist.
• Schließen und öffnen Sie PowerShell erneut und führen Sie dann das Installationsprogramm nochmals aus.

2) OpenClaw wird nach der Installation nicht erkannt

• Ihr globaler npm-bin-Ordner ist nicht im PATH enthalten.
• Prüfen Sie ihn mit: npm config get prefix.
• Fügen Sie dieses Verzeichnis Ihrem Benutzer-PATH hinzu (kein Suffix \bin erforderlich; auf den meisten Systemen lautet es %AppData%\npm).
• Schließen und öffnen Sie PowerShell erneut.

Bevorzugen Sie eine Desktop-App? Verwenden Sie Windows Hub. Für eine reine Terminal-Einrichtung werden sowohl das PowerShell-Installationsprogramm als auch WSL2-Gateway-Pfade unterstützt. Dokumentation: Windows.

Meist liegt eine nicht übereinstimmende Konsolen-Codepage in nativen Windows-Shells vor.

Symptome: Die Ausgabe von system.run/exec stellt Chinesisch als Zeichensalat dar; derselbe Befehl sieht in einem anderen Terminalprofil korrekt aus.

Problemumgehung in PowerShell:

chcp 65001[Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)$OutputEncoding = [System.Text.UTF8Encoding]::new($false)

Starten Sie anschließend das Gateway neu und versuchen Sie es erneut:

openclaw gateway restart

Tritt dies mit der neuesten OpenClaw-Version weiterhin auf? Verfolgen/melden Sie es hier: Issue #30640.

Verwenden Sie die anpassbare Git-Installation, damit Ihnen der vollständige Quellcode und die Dokumentation lokal vorliegen. Fragen Sie dann Ihren Bot (oder Claude/Codex) aus diesem Ordner heraus, damit er das Repository lesen und präzise antworten kann.

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

Weitere Details: Installation und Installationsprogramm-Flags.

• Schnelleinrichtung für Linux und Dienstinstallation: Linux.
• Vollständige Anleitung: Erste Schritte.
• Installationsprogramm und Aktualisierungen: Installation und Aktualisierungen.

Jeder Linux-VPS ist geeignet. Installieren Sie OpenClaw auf dem Server und greifen Sie anschließend über SSH/Tailscale auf das Gateway zu.

Anleitungen: exe.dev, Hetzner, Fly.io. Remotezugriff: Gateway-Remotezugriff.

Hosting-Übersicht mit gängigen Providern:

• VPS-Hosting (alle Provider an einem Ort)
• Fly.io
• Hetzner
• exe.dev

In der Cloud läuft das Gateway auf dem Server, und Sie greifen von Ihrem Laptop/Telefon über die Control UI (oder Tailscale/SSH) darauf zu. Ihr Zustand und Workspace befinden sich auf dem Server. Behandeln Sie den Host daher als maßgebliche Datenquelle und sichern Sie ihn.

Koppeln Sie Nodes (Mac/iOS/Android/headless) mit diesem Cloud-Gateway, um Bildschirm, Kamera oder Canvas lokal zu verwenden oder Befehle auf Ihrem Laptop auszuführen, während das Gateway in der Cloud verbleibt.

Übersicht: Plattformen. Remotezugriff: Gateway-Remotezugriff. Nodes: Nodes, Nodes-CLI.

Möglich, aber nicht empfohlen. Der Aktualisierungsvorgang kann das Gateway neu starten und dadurch die aktive Sitzung trennen, einen sauberen Git-Checkout erfordern und eine Bestätigungsabfrage anzeigen. Sicherer ist es, Aktualisierungen als Betreiber über eine Shell auszuführen.

openclaw updateopenclaw update statusopenclaw update --channel stable|extended-stable|beta|devopenclaw update --tag <dist-tag|version>openclaw update --no-restart

Automatisierung durch einen Agenten:

openclaw update --yes --no-restartopenclaw gateway restart

Dokumentation: Aktualisieren, Aktualisierung.

openclaw onboard ist der empfohlene Einrichtungsweg. Im lokalen Modus führt es Sie durch:

1. Modell/Authentifizierung – Provider-OAuth, API-Schlüssel oder manuelle Authentifizierung (einschließlich lokaler Optionen wie LM Studio); wählen Sie ein Standardmodell aus.
2. Workspace – Speicherort und Bootstrap-Dateien.
3. Gateway – Port, Bind-Adresse, Authentifizierungsmodus, Tailscale-Freigabe.
4. Kanäle – integrierte und offizielle Plugin-Chatkanäle: iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp und weitere.
5. Daemon – LaunchAgent (macOS), systemd-Benutzereinheit (Linux/WSL2) oder native geplante Windows-Aufgabe.
6. Integritätsprüfung – startet das Gateway und prüft, ob es ausgeführt wird.
7. Skills – installiert empfohlene Skills und optionale Abhängigkeiten.

Es informiert Sie vorab über die erwartete Dauer und warnt, wenn Ihr konfiguriertes Modell unbekannt ist oder die Authentifizierung fehlt. Vollständige Übersicht: Onboarding (CLI).

Nein. Führen Sie OpenClaw mit API-Schlüsseln (Anthropic/OpenAI/andere) oder ausschließlich lokalen Modellen aus, damit Ihre Daten auf Ihrem Gerät verbleiben. Abonnements (Claude Pro/Max, ChatGPT/Codex) sind optionale Möglichkeiten zur Authentifizierung bei diesen Providern.

Bei Anthropic ermöglicht ein API-Schlüssel die standardmäßige nutzungsabhängige Abrechnung; die Claude CLI verwendet eine vorhandene Claude-Code-Anmeldung auf demselben Host wieder. Anthropic behandelt den nicht interaktiven claude -p-Pfad der Claude CLI derzeit als Agent-SDK-/programmatische Nutzung, die weiterhin auf die Limits Ihres Abonnementtarifs angerechnet wird. Prüfen Sie die aktuellen Abrechnungsinformationen von Anthropic, bevor Sie sich auf das Abonnementverhalten verlassen. Für langlebige Gateway-Hosts und gemeinsam genutzte Automatisierungen ist ein Anthropic-API-Schlüssel die besser vorhersehbare Wahl.

OpenAI-Codex-OAuth (ChatGPT/Codex-Abonnement) wird für Agentenmodelle vollständig unterstützt. OpenClaw unterstützt außerdem gehostete abonnementbasierte Optionen, darunter Qwen Cloud Coding Plan, MiniMax Coding Plan und Z.AI / GLM Coding Plan.

Dokumentation: Anthropic, OpenAI, Qwen Cloud, MiniMax, Z.AI (GLM), Lokale Modelle, Modelle.

Ja. OpenClaw unterstützt die Wiederverwendung der Claude CLI für Pro-/Max-/Team-/ Enterprise-Tarife. Anthropic behandelt den von OpenClaw verwendeten claude -p-Pfad derzeit als Nutzung im Rahmen des Abonnementtarifs und damit unter den Limits Ihres Tarifs, nicht als separates kostenloses Kontingent. Aktuelle Abrechnungsdetails und Links zu den Supportartikeln von Anthropic finden Sie unter Anthropic. Verwenden Sie für eine möglichst gut vorhersehbare serverseitige Einrichtung stattdessen einen Anthropic-API-Schlüssel.

Ja, über die Wiederverwendung der Claude CLI. Die Abrechnungsweise von Anthropic für die Nutzung von claude -p/Agent SDK hat sich im Laufe der Zeit geändert. Den aktuellen Stand und datierte Links zu den Supportartikeln von Anthropic finden Sie unter Anthropic, bevor Sie sich auf ein bestimmtes Abrechnungsverhalten verlassen.

Die Authentifizierung mit einem Anthropic-Einrichtungstoken wird ebenfalls weiterhin als Token-Pfad unterstützt, OpenClaw bevorzugt jedoch die Wiederverwendung der Claude CLI und claude -p, sofern verfügbar. Für Produktions- oder Mehrbenutzer-Workloads bleibt ein Anthropic-API-Schlüssel die sicherere und besser vorhersehbare Wahl. Weitere gehostete abonnementbasierte Optionen: OpenAI, Qwen Cloud, MiniMax, Z.AI (GLM).

Ihr Anthropic-Kontingent bzw. -Ratenlimit ist für das aktuelle Zeitfenster ausgeschöpft. Warten Sie bei der Claude CLI, bis das Zeitfenster zurückgesetzt wird, oder führen Sie ein Upgrade Ihres Tarifs durch. Prüfen Sie bei einem Anthropic-API-Schlüssel die Nutzung und Abrechnung in der Anthropic Console und erhöhen Sie die Limits nach Bedarf.

Wenn die Meldung ausdrücklich Extra usage is required for long context requests lautet, versucht die Anfrage, das 1M-Kontextfenster von Anthropic zu verwenden (ein allgemein verfügbares 1M-fähiges Claude-4.x- Modell oder die veraltete Konfiguration params.context1m: true), und Ihre aktuellen Anmeldedaten sind nicht für die Abrechnung langer Kontexte berechtigt.

Legen Sie ein Fallback-Modell fest, damit OpenClaw weiterhin antwortet, während für einen Provider ein Ratenlimit gilt. Siehe Modelle, OAuth und Anthropic 429: Zusätzliche Nutzung für langen Kontext erforderlich.

Ja. OpenClaw verfügt über einen gebündelten **Amazon-Bedrock-(Converse-)**Provider. Wenn AWS-Umgebungs- marker vorhanden sind (AWS_ACCESS_KEY_ID, AWS_PROFILE, AWS_BEARER_TOKEN_BEDROCK), aktiviert OpenClaw den impliziten Bedrock-Provider für die Modellerkennung automatisch; legen Sie andernfalls plugins.entries.amazon-bedrock.config.discovery.enabled: true fest oder fügen Sie einen manuellen Provider-Eintrag hinzu. Siehe Amazon Bedrock und Modell-Provider. Ein OpenAI-kompatibler Proxy vor Bedrock ist weiterhin eine gültige Option, wenn Sie einen verwalteten Schlüsselfluss bevorzugen.

OpenClaw unterstützt OpenAI Codex über OAuth (ChatGPT-Anmeldung). Eine neue Einrichtung ohne primäres Modell verwendet exakt openai/gpt-5.6-sol für die ChatGPT-/Codex-Abonnementauthentifizierung sowie die native Ausführung über den Codex-App-Server. Bei einer erneuten Authentifizierung bleibt ein vorhandenes explizites Modell erhalten, einschließlich openai/gpt-5.5. Wenn der Codex-Arbeitsbereich GPT-5.6 nicht bereitstellt, wählen Sie ausdrücklich openai/gpt-5.5; OpenClaw führt kein stilles Downgrade durch. Veraltete Modellreferenzen mit Codex-Präfix sind veraltete Konfigurationen, die durch openclaw doctor --fix repariert werden. Der direkte Zugriff per OpenAI-API-Schlüssel bleibt für OpenAI- API-Oberflächen außerhalb von Agenten sowie über ein geordnetes openai-API-Schlüsselprofil auch für Agenten- modelle verfügbar. Siehe Modell-Provider und Einrichtung (CLI).

openai ist die aktuelle Provider- und Authentifizierungsprofil-ID sowohl für OpenAI-API-Schlüssel als auch für ChatGPT-/Codex-OAuth – OpenAI Codex ist darin aufgegangen. In älteren Konfigurationen und Migrationswarnungen sehen Sie möglicherweise weiterhin das veraltete Präfix openai-codex:

• openai/gpt-5.6-sol = neue ChatGPT-/Codex-Abonnementeinrichtung mit der nativen Codex-Laufzeit für Agentendurchläufe.
• openai/gpt-5.5 = ausdrücklich unterstützte Auswahl für bestehende Konfigurationen oder Konten ohne Zugriff auf GPT-5.6.
• Veraltete openai-codex/*-Modellreferenzen = veraltete Route, die durch openclaw doctor --fix repariert wird.
• openai/gpt-5.5 plus ein geordnetes openai-API-Schlüsselprofil = API-Schlüsselauthentifizierung für ein OpenAI-Agentenmodell.
• Veraltete openai-codex-Authentifizierungsprofil-IDs = veraltete IDs, die durch openclaw doctor --fix migriert werden.

Möchten Sie direkt über die OpenAI Platform abrechnen? Legen Sie OPENAI_API_KEY fest. Möchten Sie die ChatGPT-/Codex- Abonnementauthentifizierung verwenden? Führen Sie openclaw models auth login --provider openai aus. Verwenden Sie Modellreferenzen unter dem kanonischen Provider openai/*. Eine neue Abonnement- einrichtung verwendet exakt openai/gpt-5.6-sol; Doctor repariert veraltete Modellreferenzen mit Codex-Präfix, ohne eine explizite Auswahl von openai/gpt-5.5 zu aktualisieren.

Codex OAuth verwendet von OpenAI verwaltete, tarifabhängige Kontingentzeitfenster, die sich selbst beim selben Konto von der Nutzung auf der ChatGPT-Website bzw. in der App unterscheiden können.

openclaw models status zeigt die derzeit sichtbaren Nutzungs- und Kontingentzeitfenster des Providers an, erfindet oder überträgt jedoch keine Berechtigungen aus ChatGPT-Web in einen direkten API-Zugriff. Verwenden Sie für den direkten Abrechnungs- und Limitpfad der OpenAI Platform openai/* mit einem API-Schlüssel.

Ja, vollständig. OpenAI erlaubt ausdrücklich die Verwendung von Abonnement-OAuth in externen Tools und Arbeitsabläufen wie OpenClaw. Die Einrichtung kann den OAuth-Ablauf für Sie ausführen.

Siehe OAuth, Modell-Provider und Einrichtung (CLI).

Die Gemini CLI verwendet einen Plugin-Authentifizierungsablauf, keine Client-ID und kein Geheimnis in openclaw.json.

1. Installieren Sie die Gemini CLI lokal, sodass gemini in PATH verfügbar ist:
   • Homebrew: brew install gemini-cli
   • npm: npm install -g @google/gemini-cli
2. Aktivieren Sie das Plugin: openclaw plugins enable google
3. Melden Sie sich an: openclaw models auth login --provider google-gemini-cli --set-default
4. Standardmodell nach der Anmeldung: google/gemini-3.1-pro-preview (Laufzeit google-gemini-cli)
5. Schlagen Anfragen nach der Anmeldung fehl? Legen Sie GOOGLE_CLOUD_PROJECT oder GOOGLE_CLOUD_PROJECT_ID auf dem Gateway-Host fest und versuchen Sie es erneut.

OAuth-Token werden in Authentifizierungsprofilen auf dem Gateway-Host gespeichert. Details: Google, Modell-Provider.

Normalerweise nicht. OpenClaw benötigt einen großen Kontext und robuste Sicherheitsmechanismen; kleine Grafikkarten beschneiden den Kontext und umgehen providerseitige Sicherheitsfilter. Falls es dennoch erforderlich ist, führen Sie lokal den größten möglichen Modell-Build aus (LM Studio) – siehe Lokale Modelle. Kleinere bzw. quantisierte Modelle erhöhen das Risiko von Prompt-Injection – siehe Sicherheit.

Wählen Sie regional gebundene Endpunkte. OpenRouter bietet in den USA gehostete Optionen für MiniMax, Kimi und GLM; wählen Sie die in den USA gehostete Variante, damit die Daten in der Region verbleiben. Sie können weiterhin Anthropic/OpenAI daneben mit models.mode: "merge" aufführen, sodass Fallbacks verfügbar bleiben und zugleich der ausgewählte regionale Provider berücksichtigt wird.

Nein. OpenClaw läuft unter macOS oder Linux (Windows über WSL2). Ein Mac mini ist eine beliebte Wahl für einen dauerhaft laufenden Host, aber ein kleiner VPS, Heimserver oder ein Gerät der Raspberry-Pi-Klasse funktioniert ebenfalls.

Sie benötigen einen Mac nur für Tools, die ausschließlich unter macOS verfügbar sind. Verwenden Sie für iMessage iMessage mit imsg auf einem beliebigen Mac, der bei Messages angemeldet ist. Wenn der Gateway unter Linux oder anderswo läuft, legen Sie channels.imessage.cliPath auf einen SSH-Wrapper fest, der imsg auf diesem Mac ausführt. Führen Sie für andere ausschließlich unter macOS verfügbare Tools den Gateway auf einem Mac aus oder koppeln Sie eine macOS-Node.

Dokumentation: iMessage, Nodes, Mac-Remotemodus.

Sie benötigen ein beliebiges macOS-Gerät, das bei Messages angemeldet ist – nicht unbedingt einen Mac mini; jeder Mac funktioniert. Verwenden Sie iMessage mit imsg; der Gateway kann auf diesem Mac oder mit einem SSH-Wrapper unter cliPath an anderer Stelle ausgeführt werden.

Übliche Einrichtungen:

• Gateway unter Linux/VPS, wobei channels.imessage.cliPath auf einen SSH-Wrapper gesetzt ist, der imsg auf einem Mac ausführt, der bei Messages angemeldet ist.
• Alles auf einem einzigen Mac für die einfachste Einrichtung auf einem einzelnen Rechner.

Dokumentation: iMessage, Nodes, Mac-Remote-Modus.

Ja. Auf dem Mac mini kann der Gateway ausgeführt werden, und Ihr MacBook Pro stellt als Node (Begleitgerät) eine Verbindung her. Nodes führen den Gateway nicht aus, sondern fügen Funktionen wie Bildschirm/Kamera/Canvas und system.run auf diesem Gerät hinzu.

Gängiges Muster: Der Gateway läuft auf dem ständig eingeschalteten Mac mini; auf dem MacBook Pro läuft die macOS-App oder ein Node-Host, der mit dem Gateway gekoppelt wird. Prüfen Sie dies mit openclaw nodes status / openclaw nodes list.

Dokumentation: Nodes, Nodes-CLI.

Nicht empfohlen – Bun weist Laufzeitfehler auf, insbesondere bei WhatsApp und Telegram. Verwenden Sie Node für stabile Gateways. Wenn Sie dennoch experimentieren möchten, tun Sie dies auf einem nicht produktiv genutzten Gateway ohne WhatsApp/Telegram.

channels.telegram.allowFrom ist die Telegram-Benutzer-ID des menschlichen Absenders (numerisch), nicht der Benutzername des Bots. Die Einrichtung fragt ausschließlich nach numerischen Benutzer-IDs; openclaw doctor --fix kann versuchen, veraltete @username-Einträge aufzulösen.

Sicherer (kein Drittanbieter-Bot): Senden Sie Ihrem Bot eine Direktnachricht, führen Sie openclaw logs --follow aus und lesen Sie from.id ab.

Offizielle Bot API: Senden Sie Ihrem Bot eine Direktnachricht, rufen Sie https://api.telegram.org/bot<bot_token>/getUpdates auf und lesen Sie message.from.id ab.

Drittanbieter (weniger vertraulich): Senden Sie @userinfobot oder @getidsbot eine Direktnachricht.

Siehe Telegram-Zugriffssteuerung.

Ja, über Multi-Agent-Routing. Binden Sie die WhatsApp-Direktnachrichten jedes Absenders (peer: { kind: "direct", id: "+15551234567" }) an eine andere agentId, sodass jede Person einen eigenen Workspace und Sitzungsspeicher erhält. Antworten werden weiterhin über dasselbe WhatsApp-Konto gesendet; die Zugriffssteuerung für Direktnachrichten (channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom) gilt global pro Konto. Siehe Multi-Agent-Routing und WhatsApp.

Ja. Verwenden Sie Multi-Agent-Routing: Weisen Sie jedem Agenten ein eigenes Standardmodell zu und binden Sie anschließend eingehende Routen (Provider-Konto oder bestimmte Kommunikationspartner) an den jeweiligen Agenten. Beispielkonfiguration: Multi-Agent-Routing. Siehe auch Modelle und Konfiguration.

Ja, über Linuxbrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profileeval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"brew install <formula>

Wenn Sie OpenClaw über systemd ausführen, stellen Sie sicher, dass der PATH des Dienstes /home/linuxbrew/.linuxbrew/bin (oder Ihr brew-Präfix) enthält, damit mit brew installierte Tools in Nicht-Login-Shells gefunden werden. Neuere Builds stellen bei Linux-systemd-Diensten außerdem häufig verwendete benutzerspezifische Binärverzeichnisse voran (zum Beispiel ~/.local/bin, ~/.npm-global/bin, ~/.local/share/pnpm, ~/.bun/bin) und berücksichtigen PNPM_HOME, NPM_CONFIG_PREFIX, BUN_INSTALL, VOLTA_HOME, ASDF_DATA_DIR, NVM_DIR und FNM_DIR, sofern diese gesetzt sind.

• Anpassbare Git-Installation: vollständiger Quellcode-Checkout, bearbeitbar und am besten für Mitwirkende geeignet. Sie erstellen den Build lokal und können Code sowie Dokumentation ändern.
• npm-Installation: globale CLI-Installation ohne Repository, am besten für „einfach ausführen“. Aktualisierungen werden über npm-Dist-Tags bereitgestellt.

Dokumentation: Erste Schritte, Aktualisierung.

Ja, mit openclaw update --channel ... bei einer vorhandenen Installation. Dadurch werden Ihre Daten nicht gelöscht – nur die OpenClaw-Codeinstallation ändert sich. Statusdaten (~/.openclaw) und Workspace (~/.openclaw/workspace) bleiben unverändert.

Von npm zu Git:

openclaw update --channel dev

Von Git zu npm:

openclaw update --channel stable

Fügen Sie --dry-run hinzu, um den geplanten Moduswechsel zuerst in einer Vorschau anzuzeigen. Der Updater führt nachgelagerte Doctor-Schritte aus, aktualisiert die Plugin-Quellen für den Zielkanal und startet das Gateway neu, sofern Sie nicht --no-restart übergeben.

Der Installer kann ebenfalls einen der beiden Modi erzwingen:

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

Tipps zur Sicherung: Speicherorte auf dem Datenträger.

Möchten Sie Zuverlässigkeit rund um die Uhr? Verwenden Sie einen VPS. Möchten Sie möglichst wenig Aufwand und sind Standby/Neustarts für Sie in Ordnung? Führen Sie es lokal aus.

Laptop (lokales Gateway)

• Vorteile: keine Serverkosten, direkter Zugriff auf lokale Dateien, ein sichtbares Browserfenster.
• Nachteile: Standby und Netzwerkunterbrechungen trennen die Verbindung, Betriebssystemupdates und Neustarts unterbrechen den Betrieb, das Gerät muss aktiv bleiben.

VPS / Cloud

• Vorteile: dauerhaft verfügbar, stabiles Netzwerk, keine Standby-Probleme des Laptops, einfacher im Dauerbetrieb zu halten.
• Nachteile: häufig ohne grafische Oberfläche (verwenden Sie Screenshots), nur Remote-Dateizugriff, SSH für Updates erforderlich.

WhatsApp/Telegram/Slack/Mattermost/Discord funktionieren problemlos über einen VPS – der eigentliche Kompromiss besteht zwischen einem Browser ohne grafische Oberfläche und einem sichtbaren Fenster. Siehe Browser.

Standardempfehlung: Verwenden Sie einen VPS, wenn es bei Ihnen bereits zu Gateway-Verbindungsabbrüchen kam. Die lokale Ausführung eignet sich hervorragend, wenn Sie den Mac aktiv verwenden und lokalen Dateizugriff oder UI-Automatisierung mit sichtbarem Browser benötigen.

Es ist nicht erforderlich, wird jedoch für Zuverlässigkeit und Isolation empfohlen.

• Dedizierter Host (VPS/Mac mini/Raspberry Pi): dauerhaft verfügbar, weniger Unterbrechungen durch Standby oder Neustarts, klarere Berechtigungen, einfacher im Dauerbetrieb zu halten.
• Gemeinsam genutzter Laptop/Desktop-Rechner: für Tests und die aktive Nutzung geeignet, aber rechnen Sie mit Pausen, wenn das Gerät in den Standby-Modus wechselt oder Updates installiert.

Das Beste aus beiden Welten: Betreiben Sie das Gateway auf einem dedizierten Host und koppeln Sie Ihren Laptop als Node für lokale Bildschirm-, Kamera- und Ausführungswerkzeuge. Siehe Nodes und Sicherheit.

• Absolutes Minimum: 1 vCPU, 1 GB RAM, ~500 MB Speicherplatz.
• Empfohlen: 1-2 vCPU, 2 GB+ RAM als Reserve (Protokolle, Medien, mehrere Kanäle). Node-Werkzeuge und Browserautomatisierung können viele Ressourcen beanspruchen.

Betriebssystem: Ubuntu LTS (oder eine beliebige moderne Debian-/Ubuntu-Version) – der am besten getestete Installationsweg unter Linux.

Dokumentation: Linux, VPS-Hosting.

Ja. Behandeln Sie eine VM wie einen VPS: Sie muss dauerhaft eingeschaltet und erreichbar sein sowie über ausreichend RAM für das Gateway und alle aktivierten Kanäle verfügen.

• Absolutes Minimum: 1 vCPU, 1 GB RAM.
• Empfohlen: 2 GB+ RAM für mehrere Kanäle, Browserautomatisierung oder Medienwerkzeuge.
• Betriebssystem: Ubuntu LTS oder eine andere moderne Debian-/Ubuntu-Version.

Verwenden Sie unter Windows Windows Hub für die Desktop-Einrichtung oder WSL2 für eine Linux-ähnliche Gateway-VM mit umfassender Werkzeugkompatibilität. Siehe Windows, VPS-Hosting. macOS in einer VM ausführen: siehe macOS-VM.