Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
OpenClaw
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
OpenClaw ist ein freier KI-Assistent, der auf dem eigenen Rechner läuft und Aufgaben selbst erledigt: Er führt Befehle aus, bearbeitet Dateien und nutzt Werkzeuge und Erweiterungen („Skills“). Erreichbar ist er über eine Oberfläche im Terminal, eine Weboberfläche und über Messenger wie Telegram, Signal, WhatsApp, Discord oder Slack. Zentrale Stelle ist das Gateway, ein Hintergrunddienst, der Sitzungen, Werkzeuge und Verbindungen verwaltet.
Hinweis: nicht selbst getestet. Diese Anleitung beruht auf der offiziellen Dokumentation von OpenClaw (Stand 27. September 2026). Installation und Bedienung von OpenClaw wurden für dieses Buch nicht ausprobiert. Selbst geprüft wurden nur das Herunterladen des Installationsskripts und dessen Inhalt. Befehle und Ausgaben können daher von der Beschreibung abweichen.
Vorbemerkungen
- Verhältnis zu Hermes Agent: Hermes Agent ist ein ähnliches Projekt. Beide sind persönliche Agenten mit Gedächtnis, Skills und Messenger-Anbindung. OpenClaw ist in TypeScript geschrieben und stellt das Gateway mit Weboberfläche und vielen Messengern in den Mittelpunkt. Hermes setzt stärker auf das Terminal und auf selbst gelernte Skills. Beide können Einstellungen des jeweils anderen übernehmen.
- Was ein Agent darf: Werkzeuge laufen ohne weitere Einstellung direkt auf dem Rechner, mit deinen Rechten. Nachrichten, die über Messenger hereinkommen, sind als nicht vertrauenswürdig zu behandeln. Unbekannte Absender müssen erst gekoppelt werden (Schritt 15).
- Node.js 24 nötig: OpenClaw braucht Node.js 24.16 oder neuer. Ubuntu 26.04 liefert nur Node.js 22, das Paket
nodejsausaptreicht also nicht. Das empfohlene Skriptinstall.shwürde unter Linux das Paketarchiv NodeSource einrichten und damit dasnodejsvon Ubuntu ersetzen. Diese Anleitung verwendet deshalb das zweite offizielle Skriptinstall-cli.sh. Es braucht kein root und legt ein eigenes Node.js und OpenClaw nur in~/.openclawab. Das System bleibt unverändert. - Sprachmodell: Diese Anleitung verbindet OpenClaw mit einem lokalen Modell über Ollama. Dann verlassen keine Daten den Rechner und es fallen keine Kosten an. Kleine lokale Modelle wie
qwen3:4b-instructverstehen Aufgaben aber deutlich schlechter als große. Alternativ nutzt OpenClaw Anbieter wie Anthropic, OpenAI oder OpenRouter mit eigenem, meist kostenpflichtigem Zugang. - Was OpenClaw ins Netz sendet: Laut Hersteller nur eine tägliche Prüfung auf neue Versionen. Anonyme Nutzungsstatistiken sind ab Werk aus. Schritt 17 schaltet auch die Versionsprüfung ab.
- Träger: OpenClaw gehört der gemeinnützigen OpenClaw Foundation, steht unter der MIT-Lizenz und hat keine Bezahlversion.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. Voraussetzungen installieren
Das Installationsskript braucht curl und Git. Sind sie schon vorhanden, meldet apt das nur.
sudo apt install curl git
3. Installationsskript herunterladen
Speichert das Skript zuerst als Datei, statt es ungesehen aus dem Internet zu starten. --proto '=https' --tlsv1.2 erzwingt eine verschlüsselte Verbindung.
curl -fsSL --proto '=https' --tlsv1.2 -o ~/openclaw-install-cli.sh https://openclaw.ai/install-cli.sh
4. Skript ansehen (optional)
Zeigt das Skript seitenweise an, mit Q beendest du die Anzeige. Es lädt Node.js in einer festen Version nach ~/.openclaw/tools, prüft dessen Prüfsumme, installiert OpenClaw mit diesem Node.js nach ~/.openclaw und legt den Befehl ~/.openclaw/bin/openclaw an. sudo verwendet es nur, falls Git fehlt.
less ~/openclaw-install-cli.sh
5. Skript ausführen
Ohne weitere Angaben installiert das Skript die aktuelle Version und startet die Einrichtung noch nicht, die folgt in Schritt 10.
bash ~/openclaw-install-cli.sh
Prüfen: Gegen Ende steht eine Zeile OpenClaw installed (…) mit der Versionsnummer.
6. Skript löschen
Das Skript wird nicht mehr gebraucht.
rm ~/openclaw-install-cli.sh
7. Befehl in den Suchpfad aufnehmen
Das Skript legt den Befehl nach ~/.openclaw/bin, trägt diesen Ordner aber nicht in den Suchpfad ein.
nano ~/.bashrc
Springe mit Strg+Ende ans Ende der Datei und füge in einer eigenen Zeile an:
export PATH="$HOME/.openclaw/bin:$PATH"
Speichere mit Strg+O und Enter und beende nano mit Strg+X. Öffne danach ein neues Terminal.
Prüfen: Die Ausgabe nennt die Version von OpenClaw.
openclaw --version
Mit Ollama verbinden
8. Modell prüfen
OpenClaw braucht ein Modell, das Werkzeuge aufrufen kann und mindestens 16 000 Tokens Kontext hat. qwen3:4b-instruct aus der Ollama-Anleitung erfüllt beides. Unter Capabilities muss tools stehen.
ollama show qwen3:4b-instruct
9. Modell laden
Die automatische Suche der Einrichtung berücksichtigt vor allem Modelle, die Ollama gerade im Speicher hat. Dieser Aufruf lädt das Modell mit einer kurzen Frage. Ollama behält es danach fünf Minuten im Speicher.
ollama run qwen3:4b-instruct "Antworte nur mit: bereit"
10. Einrichtung starten
openclaw onboard führt durch die Einrichtung. Zuerst zeigt es einen Hinweis zur Sicherheit, den du bestätigen musst.
openclaw onboard
Wähle als Anbieter Ollama und als Betriebsart Local only. Gib als Adresse http://127.0.0.1:11434 ein und wähle das Modell qwen3:4b-instruct. OpenClaw schickt vor dem Speichern eine echte Testanfrage an das Modell und legt den Arbeitsordner ~/.openclaw/workspace an.
Prüfen: Die Liste enthält qwen3:4b-instruct.
openclaw models list --provider ollama
Gateway und Oberflächen
11. Gateway als Dienst einrichten
Das Gateway soll im Hintergrund laufen. Dieser Befehl legt dafür einen systemd-Dienst für deinen Benutzer an. sudo ist nicht nötig.
openclaw gateway install
12. Gateway prüfen
openclaw gateway status
Prüfen: Die Ausgabe meldet, dass das Gateway läuft.
13. Weboberfläche öffnen
Öffnet die Control UI im Browser. Dort siehst du Sitzungen, Einstellungen und ein Chatfenster. Schicke eine erste Nachricht, z. B. Welche Dateien liegen in deinem Arbeitsordner?.
openclaw dashboard
14. Terminal-Oberfläche verwenden
openclaw ohne weitere Angaben öffnet eine Chat-Oberfläche im Terminal, die mit dem Gateway verbunden ist.
openclaw
Sicherheit
15. Messenger nur mit Kopplung
Wer OpenClaw über einen Messenger erreichbar macht (openclaw configure → Kanäle), sollte wissen: Unbekannte Absender bekommen in Direktnachrichten zunächst einen Kopplungscode. Erst wenn du ihn bestätigst (hier am Beispiel des Kanals telegram und des Codes 123456), reagiert der Agent auf sie:
openclaw pairing approve telegram 123456
Bestätige nur Personen, denen du erlaubst, auf deinem Rechner Befehle auszulösen.
16. Sicherheitsprüfung
openclaw doctor prüft Einstellungen, Dienst und Laufzeitumgebung und nennt Probleme. openclaw doctor --fix behebt, was sich automatisch beheben lässt.
openclaw doctor
Bevor du andere Benutzer anbindest oder das Gateway aus dem Netz erreichbar machst, lies die Seiten zu Sicherheit und Sandbox in der Doku: Mit einer Sandbox laufen Werkzeuge abgeschottet statt direkt auf dem Rechner.
17. Versionsprüfung abschalten (optional)
Schaltet die tägliche Anfrage nach neuen Versionen ab. Die Einstellung landet in ~/.openclaw/openclaw.json.
openclaw config set update.checkOnStart false
Wie geht es weiter?
- Einstellungen:
openclaw configureändert später Modell, Gateway, Kanäle, Plugins oder Skills. Die Einstellungen stehen in~/.openclaw/openclaw.json. Das Gateway übernimmt Änderungen an der Datei selbst. - Skills und Plugins: Erweiterungen gibt es im Verzeichnis ClawHub (https://clawhub.ai). Prüfe fremde Skills vor der Installation, denn sie laufen mit denselben Rechten wie der Agent.
- Umzug von Hermes:
openclaw onboard --import-from hermesübernimmt Einstellungen aus Hermes Agent. - Dokumentation: https://docs.openclaw.ai
Aktualisieren
OpenClaw aktualisiert sich über seinen eigenen Befehl, nicht über apt. Er erneuert auch den Gateway-Dienst und meldet Erfolg erst, wenn das Gateway danach wieder läuft.
openclaw update
openclaw update --dry-run zeigt vorher, was geschehen würde. Scheitert ein Update, hilft laut Doku, das Installationsskript aus den Schritten 3 bis 6 erneut auszuführen.
Deinstallieren
1. Entfernen ansehen
--dry-run zeigt nur, was entfernt würde. --all wählt Dienst, Einstellungen, Arbeitsordner und Programm.
openclaw uninstall --dry-run --all
2. OpenClaw entfernen
Entfernt den Gateway-Dienst, alle Einstellungen, den Arbeitsordner mit den Dateien des Agenten und das Programm. Achtung: Alle Daten des Agenten gehen dabei verloren.
openclaw uninstall --all
3. Restliche Dateien entfernen
Löscht, was von ~/.openclaw noch übrig ist, etwa das mitgebrachte Node.js.
rm -rf ~/.openclaw
4. Suchpfad-Eintrag entfernen
nano ~/.bashrc
Lösche die Zeile export PATH="$HOME/.openclaw/bin:$PATH": Cursor in die Zeile setzen und Strg+K drücken. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
Prüfen: In einem neuen Terminal meldet die Shell, dass der Befehl openclaw nicht gefunden wurde.
openclaw --version
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.