OpenClaw installieren und OmniProxy konfigurieren

OpenClaw ist ein KI-Assistent, der direkt auf Ihrem Computer läuft. Sie können mit ihm über Telegram, Discord, WhatsApp oder Feishu kommunizieren, ohne ein zusätzliches Chat-Fenster offen halten zu müssen. Unterhaltungen und Protokolle verbleiben lokal auf Ihrem Rechner, und das System kann Folgeaufgaben direkt vor Ort ausführen.

Vorbereitung

OpenClaw benötigt Node 24.16 oder neuer. Sie können auch Node 26.1 oder neuer verwenden; Node 26 wird empfohlen. Node stellt die für OpenClaw erforderliche Laufzeitumgebung bereit.

Die Installation ist unter macOS, Linux und Windows möglich. Falls auf dem Computer keine geeignete Node-Version vorhanden ist, bereitet das Installationsskript automatisch eine vor: Node 26 unter macOS und Node 24 LTS unter Linux. pnpm wird nur benötigt, wenn Sie OpenClaw aus dem Quellcode erstellen.

Wenn bereits eine ältere Node-Version installiert ist, müssen Sie diese nicht deinstallieren. Bei Tests am 09.10.2026 lag die System-Node-Version auf diesem Rechner bei 24.2.0, also unter den erforderlichen 24.16. Das nicht-interaktive Installationsskript hat daraufhin automatisch Node 24.21.0 bereitgestellt.

Möchten Sie ein Fenster?

Desktop-Begleiter

Hub-Installer unter Windows verwenden
GitHub-DMG unter macOS verwenden
Das lokale Gateway kann bei der Ersteinrichtung installiert werden

Offiziell empfohlen

Installationsskript

macOS Linux WSL2
PowerShell unter Windows verwenden
Sie können --no-onboard hinzufügen

Node bereits installiert

Paketmanager

npm pnpm oder bun
Anschließend onboard ausführen
Siehe Installationsseite für die Node-Version

Laden Sie den Desktop-Begleiter herunter, wenn Sie ein Fenster wünschen. Wenn Sie das Tool nur im Terminal nutzen möchten, führen Sie das offizielle Installationsskript aus.

Installation und erster Start

Sie können den Desktop-Begleiter mit grafischem Fenster installieren oder die Installation direkt über das Terminal vornehmen. Das Gateway ist der lokale Dienst, der Nachrichten empfängt, Modelle aufruft und die Ergebnisse zurückgibt. Sie können es beim ersten Öffnen des Desktop-Begleiters einrichten.

Wenn Sie ein Fenster wünschen

Windows: Laden Sie OpenClawCompanion-Setup-x64.exe oder OpenClawCompanion-Setup-arm64.exe herunter und führen Sie die Datei aus. Der Installer ist signiert und enthält Einstellungen, Tray-Status, Chat- und Node-Modi.
macOS: Laden Sie OpenClaw .dmg von den GitHub-Releases von OpenClaw herunter. Das DMG-Format wird bevorzugt, Sie können aber auch .zip verwenden. Öffnen Sie nach der Installation OpenClaw.app. Falls diese Version keine macOS-Datei enthält, folgen Sie den Anweisungen auf der macOS-App-Seite.

Beim ersten Öffnen können Sie OpenClaw das Gateway auf diesem Computer vorbereiten lassen oder eine Verbindung zu einem bestehenden Remote-Gateway herstellen.

Installation über das Terminal

Für macOS, Linux und WSL2 verwenden Sie:

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

Für Windows PowerShell verwenden Sie:

iwr -useb https://openclaw.ai/install.ps1 | iex

Das Skript erkennt das aktuelle System, installiert bei Bedarf Node, installiert OpenClaw und startet dann den Onboarding-Prozess. Der Onboarding-Ablauf führt Sie durch die Ersteinrichtung.

Wenn Sie das Onboarding noch nicht starten möchten, verwenden Sie stattdessen unter macOS, Linux und WSL2:

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

Unter Windows verwenden Sie die offizielle Option -NoOnboard:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Wenn Sie Node bereits selbst verwalten, können Sie auch npm, pnpm oder bun nutzen. Führen Sie bei npm 12 oder npm 11.16 und neuer aus:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Entfernen Sie bei npm 11.15 und älter --allow-scripts=openclaw. Fügen Sie bei Verwendung von pnpm --allow-build=openclaw hinzu. Einzelheiten entnehmen Sie bitte der Installationsseite.

Führen Sie nach der Installation diese drei Befehle nacheinander aus:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version zeigt die Version an, openclaw doctor prüft auf häufige Umgebungsprobleme und openclaw gateway status zeigt an, ob das Gateway läuft. Die grundlegende Installation ist erst abgeschlossen, wenn alle drei Befehle eine normale Ausgabe liefern.

Wenn das Terminal meldet, dass openclaw nicht gefunden werden kann, fehlt normalerweise das globale npm-Bin-Verzeichnis im PATH. PATH ist die Liste der Orte, an denen das Terminal nach Programmen sucht. Vergleichen Sie die Ausgabe von node -v, npm prefix -g und echo "$PATH", fügen Sie das entsprechende Bin-Verzeichnis zum PATH hinzu und starten Sie das Terminal neu.

Wenn ~/.openclaw bereits eine aktuell verwendete Konfiguration enthält, verwendet das Standard-Installationsskript dieses Verzeichnis. Um eine separate Kopie zu installieren, ohne die bestehende Konfiguration zu ändern, führen Sie das nicht-interaktive Skript aus und geben Sie ein neues Verzeichnis an:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix "$HOME/openclaw-omniproxy" --no-onboard

--no-onboard ist das Standardverhalten dieses Skripts. Am 09.10.2026 installierte dieser Befehl OpenClaw 2026.9.9. Führen Sie nach der Installation die ausführbare Datei openclaw aus dem bin-Ordner des Verzeichnisses aus.

Verbindungswerte von OmniProxy abrufen

Stellen Sie zunächst sicher, dass OmniProxy läuft, öffnen Sie dann die Modellliste und halten Sie die folgenden drei Werte bereit:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: copy the full value from the current OmniProxy model list

baseUrl ist die Adresse, an die OpenClaw Modellanfragen sendet; sie muss auf /v1 enden. Verwenden Sie bei der Verbindung mit OmniProxy openai-completions für api. Ändern Sie dies nur dann in openai-responses, wenn das Modell tatsächlich über /v1/responses funktioniert.

Die Modell-ID ist die vollständige Kennung des Modells in der Liste. Kopieren Sie diese exakt wie angezeigt, einschließlich aller Schrägstriche. Die folgenden zwei Namen sind lediglich Referenzen aus der Anbieterdokumentation vom 09.10.2026; verwenden Sie diese nicht, falls sie nicht in der Liste erscheinen: claude-sonnet-5-5, gpt-6-luna.

Auch wenn das Gateway den Schlüssel nicht validiert, muss apiKey einen Wert enthalten. Sie können einen Platzhalter-String verwenden, der nur auf diesem Computer genutzt wird. Übertragen Sie niemals einen echten Schlüssel in ein Repository.

Tool-Konfiguration eingeben

Ein Provider kann als eine Reihe von Verbindungseinstellungen verstanden werden, die OpenClaw verwendet, um einen Modelldienst zu finden. Hier wird der Provider als omniproxy bezeichnet.

Führen Sie den folgenden Befehl im Terminal aus und ersetzen Sie Adresse, Schlüssel und die beiden Modell-IDs durch Ihre eigenen Werte:

openclaw config set models.providers.omniproxy '{"baseUrl":"https://your-omniproxy-origin.example/v1","apiKey":"<YOUR_OMNIPROXY_API_KEY>","api":"openai-completions","models":[{"id":"claude-sonnet-5-5","name":"Claude Sonnet 5.5"},{"id":"gpt-6-luna","name":"GPT-6 Luna"}]}' --strict-json --merge

Dieser Befehl schreibt den Provider und die Modellliste in die Konfiguration. Sie müssen das Gateway nach erfolgreichem Abschluss des Befehls nicht neu starten.

Geben Sie als Nächstes das Standardmodell an. Die Modellreferenz besteht aus omniproxy/ gefolgt von der Modell-ID. Behalten Sie alle im ID-String vorhandenen Schrägstriche bei. Wenn die ID in der Modellliste länger ist als der unten stehende Kurzname, verwenden Sie den vollständigen Wert aus der Liste:

openclaw config set agents.defaults.model.primary '"omniproxy/claude-sonnet-5-5"' --strict-json

reasoning, input, cost, contextWindow und maxTokens können alle weggelassen werden. Wenn sie nicht angegeben sind, werden Textmodelle mit den Standardwerten verarbeitet.

Sie können dieselben Einstellungen auch direkt in die Konfigurationsdatei schreiben. In der Hauptkonfiguration befindet sich der Provider unter models.providers. Jeder Agent kann auch eine eigene models.json haben; ein Agent ist eine Assistenteninstanz, die Aufgaben empfängt und Modelle aufruft. Die Datei befindet sich unter agent/models.json innerhalb des entsprechenden Agentenverzeichnisses unter ~/.openclaw/agents/.

Wenn diese models.json eine nicht leere baseUrl enthält, überschreibt sie die Adresse in der Hauptkonfiguration.

Installation prüfen

Drei Befehle

openclaw --version
openclaw doctor
gateway status

Konfiguration

models.providers

baseUrl endet mit /v1
api auf completions setzen
Mindestens die Modell-ID angeben

Auswählen

provider/model

Diese Referenz für primäre Nutzung verwenden
Umgebungsvariable für den Schlüssel bevorzugen
Gateway-Liste als Quelle der Wahrheit verwenden

Stellen Sie zunächst sicher, dass der Befehl gefunden werden kann, geben Sie dann die Adresse und das Modell ein. Die Modellreferenz muss den Provider-Namen enthalten.

Echte Aufgabe verifizieren

Wechseln Sie in ein reguläres Projektverzeichnis und senden Sie eine sehr kurze Nachricht. Ersetzen Sie die Modellreferenz im Befehl durch Ihre vollständige Modell-ID:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Reply with one word."

--local führt diese Agentenaufgabe lokal aus, --model gibt das für diesen Durchlauf zu verwendende Modell an und --timeout 300 setzt die maximale Wartezeit auf 300 Sekunden.

Eine tatsächliche Modellantwort muss im Terminal erscheinen. Am 09.10.2026 erhielt OpenClaw 2026.9.9 eine Antwort mit diesem Befehl. Der erste Aufruf kann ein oder zwei Minuten dauern.

Wenn der ursprüngliche Fehler Request timed out before a response was generated auftritt, erhöhen Sie --timeout und senden Sie die Anfrage erneut. Dies bedeutet normalerweise, dass die Wartezeit nicht ausreichte, und deutet nicht zwingend darauf hin, dass die Adresse falsch ist.

Nachdem die kurze Antwort erfolgreich war, bitten Sie das Tool, eine von Ihnen angegebene lokale Datei zu lesen. Öffnen Sie dann die Anfrageprotokolle von OmniProxy und bestätigen Sie die Quelle und die Modell-ID, die im Protokoll angezeigt werden. Eine Ausgabe nur vom Versionsbefehl oder dem Doctor bedeutet nicht, dass die Modellverbindung vollständig konfiguriert ist.

Installation

Der Befehl antwortet

Die Versionsnummer wird angezeigt
Doctor meldet keine Blockaden
Gateway-Status ist lesbar

Aufgabe

Kleine Aufgabe wurde abgeschlossen

Zum Beispiel eine lokale Datei lesen
Die Antwort ist kein Fehler
Die Modellreferenz ist korrekt

Protokolle

Im Gateway sichtbar

Quelle ist OpenClaw
Modell-ID stimmt überein
Der Schlüssel wurde nicht zum Repository hinzugefügt

Nachdem der Versionsbefehl eine Ausgabe erzeugt hat, müssen Sie auch eine echte Antwort erhalten.

Häufige Fehler

openclaw kann nicht gefunden werden: Fügen Sie das globale npm-Bin-Verzeichnis zum PATH hinzu und starten Sie das Terminal neu. Wenn Sie in ein bestimmtes Verzeichnis installiert haben, führen Sie die ausführbare Datei aus dem bin-Ordner dieses Verzeichnisses aus.
node -v liegt unter 24.16: Sie müssen die alte Version nicht zuerst deinstallieren. Überprüfen Sie die vom Installationsskript vorbereitete Node-Version oder verwenden Sie 24.16+ bzw. 26.1+ wie auf der Installationsseite beschrieben. Node 26 wird empfohlen.
Das Modell erscheint nicht: Das Modell muss im models-Array unter models.providers enthalten sein und mindestens dieselbe id aufweisen. Das Setzen von nur agents.defaults.models registriert nicht von sich aus ein neues Modell.
Eine 400-Antwort erwähnt die Entwicklerrolle: Wenn der Adress-Host nicht api.openai.com ist, behalten Sie den Standard bei und setzen Sie supportsDeveloperRole nicht auf true. Selbst wenn es auf true gesetzt ist, wird es dennoch überschrieben.
Zeitüberschreitung erfolgt zu schnell: Erhöhen Sie --timeout auf mehr als 300 Sekunden, bevor Sie die Adresse ändern.
Tool-Aufrufe schlagen nach Auswahl von gpt-6-luna fehl: Es werden Chat Completions unterstützt; Funktionsaufrufe in Chat Completions werden nur unterstützt, wenn reasoning_effort auf none gesetzt ist. Wenn die ID in der Liste von dieser abweicht, verwenden Sie die in der Liste angezeigte ID.
Die Adresse ist nicht erreichbar: Bestätigen Sie, dass OmniProxy läuft, dass baseUrl auf /v1 endet und dass die in die Konfiguration geschriebene Adresse zugänglich ist. Andere Adressen im privaten Netzwerk müssen separat zugelassen werden.
Anfragen gehen nach der Konfiguration immer noch an eine andere Adresse: Überprüfen Sie, ob die models.json des jeweiligen Agenten eine andere baseUrl enthält.

Offizielle Referenzen

Für Installationsschritte siehe OpenClaw install. Für benutzerdefinierte Provider-Konfiguration siehe Custom providers und configuration fields. Für die in den Beispielen verwendeten Modell-IDs vergleichen Sie bitte mit Claude model overview und GPT-6 Luna.

Ersetzen Sie jeden Platzhalter mit Werten aus Ihrer eigenen OmniProxy-Konfiguration. Veröffentlichen Sie niemals einen echten Schlüssel.

Ein gespeicherter HTTP 200 allein beweist keine vollständige Agenten-Kompatibilität. Überprüfen Sie die Quelle und das Modell im Aufrufprotokoll von OmniProxy.

Offizielle Quellen · OpenClaw ↗