OpenClaw installieren und mit OmniProxy konfigurieren

OpenClaw ist ein KI-Assistent, der auf deinem eigenen Computer installiert wird. Du kannst direkt über Telegram, Discord, WhatsApp oder Feishu mit ihm sprechen, ohne ständig ein weiteres Chatfenster geöffnet zu halten. Unterhaltungen und Aufzeichnungen bleiben auf diesem Computer, und der Assistent kann dort auch die nächsten Schritte ausführen.

Vorbereitung der Installation

OpenClaw benötigt Node 24.16 oder höher. Alternativ kannst du Node 26.1 oder höher verwenden; empfohlen wird Node 26. Node stellt die grundlegende Laufzeitumgebung für OpenClaw bereit.

Die Installation ist unter macOS, Linux und Windows möglich. Falls auf dem Computer keine geeignete Node-Version vorhanden ist, richtet das Installationsskript sie selbst ein: unter macOS Node 26 und unter Linux Node 24 LTS. pnpm wird nur benötigt, wenn du OpenClaw aus dem Quellcode erstellst.

Wenn auf dem Computer bereits eine ältere Node-Version installiert ist, musst du sie nicht sofort deinstallieren. Beim Test am 2026-10-09 war auf dem Computer systemweit Node 24.2.0 installiert, also eine ältere Version als die erforderliche Version 24.16. Das nicht interaktive Installationsskript richtete selbstständig Node 24.21.0 ein.

Mit Benutzeroberfläche

Desktop-Begleiter

Unter Windows das Hub-Installationspaket
Unter macOS das DMG von GitHub
Beim ersten Start kann ein lokales Gateway installiert werden

Offiziell empfohlen

Installationsskript

macOS Linux WSL2
Unter Windows PowerShell verwenden
Optional --no-onboard hinzufügen

Node bereits vorhanden

Paketmanager

npm pnpm oder bun
Danach onboard ausführen
Node-Version siehe Installationsseite

Für eine Benutzeroberfläche lädst du die Desktop-Begleit-App herunter. Wenn du OpenClaw nur im Terminal verwenden möchtest, führst du das offizielle Installationsskript aus.

Installation und erster Start

Du kannst die Desktop-Begleit-App mit Benutzeroberfläche installieren oder OpenClaw direkt über das Terminal einrichten. Der Gateway ist ein lokaler Dienst, der Nachrichten empfängt, Modelle aufruft und die Ergebnisse zurücksendet. Beim ersten Öffnen der Desktop-Begleit-App kannst du ihn direkt einrichten.

Mit Benutzeroberfläche

Windows: Lade OpenClawCompanion-Setup-x64.exe oder OpenClawCompanion-Setup-arm64.exe herunter und führe die Datei aus. Das Installationspaket ist signiert und enthält Einstellungen, Taskleistenstatus, Chat und den node-Modus.
macOS: Lade über die GitHub-Releases von OpenClaw die .dmg für OpenClaw herunter. Verwende bevorzugt die dmg-Datei; alternativ ist auch die .zip möglich. Öffne nach der Installation OpenClaw.app. Falls für diese Version keine macOS-Datei vorhanden ist, folge den Angaben auf der Seite zur macOS-App.

Beim ersten Öffnen kannst du OpenClaw den Gateway auf diesem Computer einrichten lassen oder eine Verbindung zu einem bereits vorhandenen entfernten Gateway herstellen.

Installation über das Terminal

Verwende unter macOS, Linux und WSL2:

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

Verwende unter Windows PowerShell:

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

Das Skript erkennt das aktuelle Betriebssystem, installiert bei Bedarf Node, installiert anschließend OpenClaw und startet die Ersteinrichtung. Der Assistent führt dich durch die erstmalige Konfiguration.

Wenn du die Ersteinrichtung vorerst überspringen möchtest, verwende unter macOS, Linux und WSL2 stattdessen:

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

Verwende unter Windows die offizielle Option -NoOnboard:

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

Wenn du Node bereits selbst verwaltest, kannst du auch npm, pnpm oder bun verwenden. Führe mit npm 12 sowie npm 11.16 oder höher Folgendes aus:

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

Bei npm 11.15 und älter musst du --allow-scripts=openclaw weglassen. Bei der Verwendung von pnpm musst du --allow-build=openclaw hinzufügen. Einzelheiten zu den Unterschieden findest du auf der Installationsseite.

Führe nach Abschluss der Installation nacheinander diese drei Befehle aus:

openclaw --version
openclaw doctor
openclaw gateway status

Mit openclaw --version prüfst du die Version, mit openclaw doctor häufige Umgebungsprobleme und mit openclaw gateway status, ob der Gateway ausgeführt wird. Die grundlegende Installation ist erst abgeschlossen, wenn alle drei Befehle eine normale Ausgabe liefern.

Wenn das Terminal meldet, dass openclaw nicht gefunden wurde, befindet sich das globale bin-Verzeichnis von npm normalerweise nicht in PATH. PATH ist die Liste der Verzeichnisse, in denen das Terminal nach Programmen sucht. Vergleiche die Ausgaben von node -v, npm prefix -g und echo "$PATH", füge das entsprechende bin-Verzeichnis zu PATH hinzu und öffne anschließend das Terminal erneut.

Wenn unter ~/.openclaw bereits eine verwendete Konfiguration vorhanden ist, nutzt das standardmäßige Installationsskript dieses Verzeichnis. Möchtest du eine separate Installation erstellen, ohne die vorhandene Konfiguration zu verändern, führe das nicht interaktive Skript aus und gib 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 2026-10-09 wurde mit diesem Befehl OpenClaw 2026.9.9 installiert. Nach der Installation musst du die Datei openclaw aus dem Unterverzeichnis bin dieses Verzeichnisses ausführen.

Verbindungsparameter aus OmniProxy abrufen

Vergewissere dich zunächst, dass OmniProxy ausgeführt wird. Öffne danach die Modellliste und halte die folgenden drei Angaben bereit:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: Vollständige ID aus der aktuellen OmniProxy-Modellliste kopieren

baseUrl ist die Adresse, an die OpenClaw Modellanfragen sendet. Sie muss mit /v1 enden. Für die Anbindung von OmniProxy verwendest du für api den Wert openai-completions. Ändere ihn nur dann zu openai-responses, wenn dieses Modell tatsächlich über /v1/responses funktioniert.

Die Model ID ist die vollständige Kennung des Modells in der Liste. Kopiere sie unverändert aus der Liste und behalte auch alle darin enthaltenen Schrägstriche bei. Die folgenden beiden Namen dienen lediglich als Referenz aus der Anbieterdokumentation vom 2026-10-09. Verwende sie nicht, wenn sie nicht in der Liste enthalten sind: claude-sonnet-5-5, gpt-6-luna.

Auch wenn der Gateway den Schlüssel nicht überprüft, muss apiKey einen Wert enthalten. Du kannst dafür eine Platzhalterzeichenfolge verwenden, die nur auf diesem Computer genutzt wird. Übertrage echte Schlüssel nicht in ein Repository.

Tool-Konfiguration eintragen

Ein Provider ist eine Gruppe von Verbindungseinstellungen, über die OpenClaw den Modelldienst findet. Hier erhält der Provider den Namen omniproxy.

Führe im Terminal den folgenden Befehl aus und ersetze Adresse, Schlüssel und die beiden Modell-IDs durch deine 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. Nach erfolgreicher Ausführung musst du den Gateway nicht neu starten.

Lege anschließend das Standardmodell fest. Die Modellreferenz setzt sich aus omniproxy/ und der Model ID zusammen. Alle bereits in der ID enthaltenen Schrägstriche müssen erhalten bleiben. Wenn die ID in der Modellliste länger als der unten verwendete Kurzname ist, verwende den vollständigen Inhalt 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 weggelassen werden. Wenn du diese Werte nicht angibst, werden Textmodelle gemäß den Standardeinstellungen verarbeitet.

Du kannst dieselben Einstellungen auch direkt in die Konfigurationsdatei schreiben. Der Provider befindet sich in der Hauptkonfiguration unter models.providers. Jeder agent kann außerdem eine eigene models.json besitzen. Ein agent ist eine Assistenteninstanz, die Aufgaben entgegennimmt und das Modell aufruft. Die Datei befindet sich unter ~/.openclaw/agents/ im Verzeichnis des jeweiligen agent unter agent/models.json.

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

Installation prüfen

Drei Befehle

openclaw --version
openclaw doctor
gateway status

Konfiguration

models.providers

baseUrl endet mit /v1
Für api completions verwenden
Beim Modell mindestens id angeben

Auswahl

provider/Modell

Diese Referenz für primary verwenden
Für den Schlüssel vorzugsweise eine Umgebungsvariable verwenden
Die Gateway-Liste ist maßgeblich

Prüfe zuerst, ob der Befehl gefunden wird, und trage danach Adresse und Modell ein. Die Modellreferenz muss den Namen des Providers enthalten.

Eine echte Aufgabe überprüfen

Wechsle in ein gewöhnliches Projektverzeichnis und sende eine sehr kurze Nachricht. Ersetze die Modellreferenz im Befehl durch deine vollständige Model ID:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Antworte mit einem Wort."

--local führt diese agent-Aufgabe lokal auf dem Computer aus, --model legt das für diesen Aufruf verwendete Modell fest und --timeout 300 begrenzt die Wartezeit auf höchstens 300 Sekunden.

Im Terminal muss tatsächlich eine Antwort des Modells erscheinen. Am 2026-10-09 wurde mit OpenClaw 2026.9.9 und diesem Befehl eine Antwort empfangen. Der erste Aufruf kann ein bis zwei Minuten dauern.

Wenn die ursprüngliche Fehlermeldung Request timed out before a response was generated erscheint, erhöhe zunächst --timeout und sende die Anfrage erneut. Das bedeutet normalerweise, dass die Wartezeit nicht ausgereicht hat, und nicht zwingend, dass die Adresse falsch ist.

Nachdem die kurze Antwort erfolgreich war, lasse den Assistenten eine von dir angegebene lokale Datei lesen. Öffne anschließend die Aufrufprotokolle von OmniProxy und überprüfe dort die Quelle sowie die Model ID. Eine Ausgabe der Versionsnummer oder von doctor allein reicht nicht aus, um zu bestätigen, dass die Modellverbindung vollständig konfiguriert ist.

Installation

Befehl antwortet

Versionsnummer wird ausgegeben
doctor meldet keine Blockierung
Gateway-Status ist lesbar

Aufgabe

Eine kleine Aufgabe wurde erledigt

Zum Beispiel eine lokale Datei lesen
Antwort ist keine Fehlermeldung
Modellreferenz ist korrekt

Protokoll

Im Gateway sichtbar

Quelle ist OpenClaw
Modell-ID stimmt überein
Schlüssel ist nicht im Repository gelandet

Nach der Ausgabe des Versionsbefehls musst du zusätzlich eine echte Antwort empfangen.

Häufige Fehler

openclaw wird nicht gefunden: Füge das globale bin-Verzeichnis von npm zu PATH hinzu und öffne das Terminal erneut. Wenn du in ein bestimmtes Verzeichnis installiert hast, führe das Programm aus dessen Unterverzeichnis bin aus.
node -v ist niedriger als 24.16: Du musst die ältere Version nicht zuerst deinstallieren. Prüfe die vom Installationsskript eingerichtete Node-Version oder verwende gemäß der Installationsseite Version 24.16+, 26.1+ beziehungsweise höher. Empfohlen wird Node 26.
Das Modell erscheint nicht: Das Modell muss im Array models unter models.providers eingetragen sein und mindestens dieselbe id besitzen. Ein Eintrag nur unter agents.defaults.models registriert kein neues Modell.
Es wird ein 400-Fehler zurückgegeben, der die developer-Rolle erwähnt: Wenn der Host der Adresse nicht api.openai.com ist, behalte die Standardeinstellung bei und setze supportsDeveloperRole nicht auf true. Auch ein Wert von true wird überschrieben.
Sehr schnelles Zeitlimit: Erhöhe --timeout zunächst auf mehr als 300 Sekunden und ändere die Adresse vorerst nicht.
Tool-Aufrufe schlagen nach Auswahl von gpt-6-luna fehl: Das Modell unterstützt Chat Completions. Funktionsaufrufe werden in Chat Completions nur unterstützt, wenn reasoning_effort auf none gesetzt ist. Wenn die ID in der Liste davon abweicht, gilt die ID aus der Liste.
Die Adresse ist nicht erreichbar: Vergewissere dich, dass OmniProxy ausgeführt wird, baseUrl mit /v1 endet und die in der Konfiguration eingetragene Adresse erreichbar ist. Andere private Netzwerkadressen müssen separat freigegeben werden.
Trotz korrekter Konfiguration wird eine andere Adresse verwendet: Prüfe, ob in der models.json dieses agent eine andere baseUrl eingetragen ist.

Offizielle Referenzen

Die Installationsschritte findest du unter OpenClaw install. Die Einrichtung eines benutzerdefinierten Providers wird unter Custom providers und Konfigurationsfelder beschrieben. Die im Beispiel verwendeten Modell-IDs kannst du mit der Claude-Modellübersicht und GPT-6 Luna vergleichen.

Ersetze jeden Platzhalter durch Werte aus deiner OmniProxy-Konfiguration. Veröffentliche niemals einen echten Schlüssel.

Ein gespeichertes Ergebnis oder HTTP 200 allein beweist keine vollständige Agenten-Kompatibilität. Prüfe Quelle und Modell im OmniProxy-Aufrufprotokoll.

Offizielle Quellen · OpenClaw ↗