OpenClaw: Was es ist, wie man es installiert und mit Telegram verbindet

OpenClaw tauchte letzten Winter in meinem Feed auf, als das Projekt innerhalb einer Woche zweimal seinen Namen änderte und auf GitHub Hunderttausende Stars gewann. Seitdem suchen immer mehr Menschen nach „openclaw installation“ und „openclaw telegram“.

Im Folgenden gehe ich die offizielle Dokumentation durch: was dieses Ding ist, worin es sich von Claude Code unterscheidet, wie man es unter Windows, macOS oder Linux installiert, ein Modell auswählt und einen Telegram-Bot verbindet. Auf Sicherheit gehe ich gesondert ein, denn OpenClaw war an einigen öffentlichkeitswirksamen Vorfällen beteiligt.

Erfahre, wie du mit dem Dienst arbeitest, in der Ailoot-Dokumentation.

Was ist OpenClaw in einfachen Worten?#

OpenClaw verbindet ein KI-Modell mit deinem Telegram-Bot. Mit eingerichteten Tools und Berechtigungen kann es Nachrichten zusammenfassen oder eine Erinnerung planen. Gateway-Prozess und lokale Konfiguration laufen auf deinem Computer oder Server. Damit bleibt nicht jede Unterhaltung lokal: Wählst du ein Cloud-Modell, werden Anfrage und relevanter Gesprächskontext an dessen Anbieter gesendet. Bei einer Verbindung über Ailoot läuft die Anfrage über Ailoot zum ausgewählten Modellanbieter. Lokale Inferenz setzt ein lokales Modell ohne Cloud-Fallback voraus; Telegram-Nachrichten laufen weiterhin über Telegram, und aktivierte Tools können weitere Dienste kontaktieren.

Das Projekt wird von der Open-Source-Community von OpenClaw entwickelt. Das GitHub-Repository wurde am 24. November 2025 erstellt und hat am 22. August 2026 387.000 Stars und 81.000 Forks – eines der am schnellsten wachsenden Open-Source-Projekte des Jahres. Die Programmiersprache ist TypeScript.

Das Projekt hat eine amüsante Namensgeschichte, die man kennen sollte, damit ältere Artikel nicht verwirren. Es begann als Warelay, ein Gateway für WhatsApp. Dann hieß es Clawdbot. Im Januar 2026 bat Anthropic wegen einer Marke um eine Namensänderung, und das Projekt hieß ein paar Tage lang Moltbot. Am 30. Januar 2026 erhielt es seinen endgültigen Namen: OpenClaw. Wenn du also auf Anleitungen zu „Clawdbot“ oder „Moltbot“ stößt, geht es um dasselbe Projekt; die Artikel wurden lediglich vor der Umbenennung geschrieben.

Das Maskottchen des Projekts ist Molty, der Hummer, und „Häuten“ (den Panzer wechseln) wurde zur offiziellen Metapher für jede Umbenennung.

Wie unterscheidet sich OpenClaw von Claude Code und Hermes Agent?#

Zu diesem Unterschied werde ich ständig gefragt, weil sie von außen alle wie „KI-Agenten“ aussehen. Hier ist eine Vergleichstabelle:

So liest du die Tabelle: Ich nutze Claude Code für die Entwicklung; es ist besonders stark, wenn du ein leistungsfähiges Modell brauchst und mit Code arbeitest. OpenClaw und Hermes sind für etwas anderes gedacht: einen Agenten, der ständig läuft, in Telegram abhängt, sich an das Gespräch von gestern erinnert und Aufgaben nach einem Zeitplan erledigt. Die Wahl zwischen OpenClaw und Hermes ist subtiler; es gibt bereits eine Hermes-Anleitung mit Installation und Einrichtung.

Wenn du gerade ein Werkzeug auswählst, fang mit dem Überblick an: Womit Menschen 2026 programmieren und Welche Aufgaben man an einen KI-Agenten delegieren kann. Außerdem habe ich einen separaten Artikel zur Installation von Claude Code.

Was brauchst du vor der Installation von OpenClaw?#

Prüfe deine Node-Version vorher – das ist die einzige strenge Voraussetzung:

node --version

Die Versionen 22.22.3+, 24.15+ und 25.9+ werden unterstützt; Node 26 wird empfohlen. Wenn der Befehl „command not found“ zurückgibt oder die Version veraltet ist, keine Sorge: Das offizielle Installationsprogramm lädt eine aktuelle Node-Version für dich herunter, du musst also nichts manuell installieren.

Die verbleibende Frage betrifft das Modell. OpenClaw denkt nicht selbst: Es ruft das von dir gewählte Modell auf. Hier sind die Kostenoptionen: ein Schlüssel von Anthropic, OpenAI oder Google – du bezahlst dem Anbieter die tatsächliche Nutzung; oder ein lokales Modell über Ollama – kostenlos, aber anspruchsvoll an die Hardware. Auf beide Optionen gehe ich weiter unten in eigenen Abschnitten ein.

Wie installierst du OpenClaw unter macOS und Linux?#

Der empfohlene Weg ist das offizielle Installationsprogramm:

1. Installationsprogramm ausführen

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

   Das Skript erkennt dein Betriebssystem, prüft auf Node (und installiert es bei Bedarf), installiert OpenClaw und öffnet anschließend den Einrichtungsassistenten. Wenn du dich erst umsehen möchtest, bevor der Assistent startet, füge das Flag hinzu: bash -s -- --no-onboard.

2. Prüfen, ob alles installiert wurde

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   Der erste Befehl zeigt die Version, der zweite prüft die Konfiguration und der dritte bestätigt, dass das Gateway läuft und auf Port 18789 lauscht.

Wenn du npm verwendest und die Installation selbst verwalten möchtest:

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

Hier gibt es eine aktuelle Stolperfalle, die in einem eigenen Kapitel der Dokumentation behandelt wird. npm 12 blockiert Installationsskripte von Paketen standardmäßig, und ohne das Flag --allow-scripts=openclaw wird die Installation mit einer allowScripts-Meldung abgebrochen. Bei npm 11.15 und älter ist das Flag nicht nötig – diese Einschränkung gibt es dort noch nicht. Prüfe deine Version mit: npm --version.

Das Flag --install-daemon im zweiten Befehl richtet den automatischen Start ein: unter macOS einen LaunchAgent, unter Linux einen systemd-Dienst. Damit startet das Gateway nach Neustart oder Anmeldung, sofern die Bedingungen des Dienstmanagers erfüllt sind. Das verhindert keinen Ruhezustand und hält das Gateway bei ausgeschaltetem Rechner nicht am Leben. Telegram-Antworten brauchen einen wachen Host mit Netzwerkverbindung. Nutze einen dauerhaft laufenden Server, wenn dein Laptop schlafen oder ausgeschaltet sein soll.

Wie installierst du OpenClaw unter Windows?#

Die erste Option ist für alle, die lieber Windows als das Terminal verwenden. Windows Hub ist eine native OpenClaw-App für Windows 10 (20H2+) und Windows 11 und befindet sich derzeit in der Betaphase. Rufe die Seite mit den Windows-Hub-Versionen auf und lade das Installationsprogramm für deinen Prozessor herunter: OpenClawCompanion-Setup-x64.exe für gewöhnliche Computer oder arm64 für ARM. Nach der Installation erscheint OpenClaw Companion im Startmenü, mit einem Symbol im Infobereich, einem Chatfenster und Einstellungen.

Beim ersten Start bietet die App „Set up locally“ an – nimm das an. Sie erstellt eine dedizierte WSL-Umgebung namens OpenClawGateway, installiert darin das Gateway und verbindet sich damit. Deine bestehende Ubuntu-Installation bleibt unangetastet, falls du eine hast.

Die zweite Option führt über PowerShell:

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

Die erste Zeile installiert OpenClaw; die zweite richtet den automatischen Start über die Windows-Aufgabenplanung ein. Wenn die Richtlinie deines Computers das Erstellen von Aufgaben blockiert, wechselt OpenClaw selbstständig zu einer Ausweichlösung: einer Verknüpfung im Autostartordner, sodass das Gateway bei deiner Anmeldung startet.

Die dritte Option ist WSL2, das die Dokumentation als die kompatibelste Laufzeitumgebung unter Windows bezeichnet. Installiere Ubuntu, aktiviere systemd und folge dann den Linux-Anweisungen aus dem vorherigen Abschnitt:

wsl --install -d Ubuntu-24.04

Aktiviere systemd in WSL in /etc/wsl.conf (im Abschnitt [boot], mit der Zeile systemd=true), starte WSL neu, indem du in PowerShell wsl --shutdown ausführst, und installiere OpenClaw anschließend mit dem Linux-Befehl. Wenn dir „Distribution“ und „systemd“ nichts sagen, verwende Windows Hub; es erledigt all das für dich.

Wie wählst du ein Modell aus und schließt die Ersteinrichtung ab?#

Das Modell ist der Motor des Assistenten. Der Einrichtungsassistent zeigt eine Liste von Anbietern an; hier sind drei praktische Optionen:

Ein nettes Detail zu Anthropic: Wenn Claude Code bereits auf deinem Rechner installiert ist und du angemeldet bist, kann OpenClaw diese Anmeldung verwenden. Führe zuerst claude auth login auf dem Rechner aus und teile OpenClaw dann mit, dass es diese Anmeldung verwenden soll:

openclaw models auth login --provider anthropic --method cli --set-default

Wenn das Gateway als Hintergrunddienst läuft (wie mit --install-daemon), muss der Schlüssel dem Dienst zur Verfügung stehen. Lege ihn dafür in ~/.openclaw/.env ab – der Assistent erledigt das für dich, du musst die Datei also nicht manuell bearbeiten. Starte nach Änderungen neu und prüfe:

openclaw gateway restart
openclaw models status

Wenn Bezahlen schwierig ist, ist ein lokales Modell aus dem Ollama-Abschnitt die passende Lösung.

Wie verbindest du OpenClaw mit Telegram?#

Telegram ist der schnellste Kanal zum Verbinden: Du brauchst nur ein Bot-Token, keine Verifizierung eines Geschäftskontos. Laut Dokumentation ist dies der einfachste Einstieg, um von deinem Smartphone aus mit dem Assistenten zu chatten. Hier ist der vollständige Ablauf:

1. Mit BotFather einen Bot erstellen

   Öffne einen Telegram-Chat mit @BotFather (achte darauf, dass es genau dieser Benutzername ist – es gibt viele Fälschungen), sende /newbot und wähle einen Namen und einen Benutzernamen, der auf bot endet. Du erhältst als Antwort ein Token wie 123456789:ABCdef... – es ist der Schlüssel zu deinem Bot, also behandle es wie ein Passwort.

2. Das Token in OpenClaw eintragen

   Am einfachsten geht es über den Assistenten: Führe openclaw configure aus und wähle den Telegram-Kanal. Alternativ kannst du die Einstellung channels.telegram.botToken oder die Umgebungsvariable TELEGRAM_BOT_TOKEN verwenden. In der Dokumentation steht ausdrücklich, dass es den Befehl openclaw channels login telegram nicht gibt; Telegram wird ausschließlich über ein Token verbunden.

3. Gateway starten und dem Bot schreiben

   openclaw gateway
   

   Öffne deinen Bot in Telegram und schick ihm etwas. Er antwortet mit einem achtstelligen Kopplungscode. Das ist eine Schutzmaßnahme: Nachrichten werden erst verarbeitet, wenn du den Absender genehmigt hast.

4. Dich selbst genehmigen

   openclaw pairing list telegram
   openclaw pairing approve telegram CODE
   

   Der Code ist eine Stunde gültig, also warte nicht zu lange. Der erste genehmigte Absender wird automatisch zum Besitzer privilegierter Befehle.

Es gibt zwei knifflige Punkte, auf die man häufig stößt.

Der erste sind Gruppen. OpenClaw blockiert standardmäßig alle Gruppen: Du musst den Bot in den Einstellungen channels.telegram.groups ausdrücklich zulassen und den Modus requireMention: true in der Gruppe aktiviert lassen. Dann antwortet er nur, wenn er mit seinem Benutzernamen angesprochen wird, und mischt sich nicht ins allgemeine Gespräch ein. Telegram hat außerdem einen eigenen Datenschutzmodus für Bots: In einer Gruppe sieht ein Bot standardmäßig nur Befehle. Schalte ihn über @BotFather mit /setprivacy aus. Danach musst du den Bot aus der Gruppe entfernen und wieder hinzufügen; sonst übernimmt Telegram die Einstellung nicht.

Der zweite Punkt ist, den Zugang nicht für alle zu öffnen. Die Einstellungen enthalten den Modus dmPolicy: "open" mit einem Sternchen in der Zugriffsliste: Jeder, der den Bot über seinen Benutzernamen findet, kann ihn steuern. Bei einem persönlichen Assistenten bedeutet das, jemand anderem direkten Zugriff auf deinen Computer zu geben. Lass die Kopplung per Code aktiviert oder trage deine numerische ID in allowFrom ein.

Wie verwendest du OpenClaw mit einem lokalen Modell über Ollama?#

Mit einem lokalen Modell und deaktiviertem Cloud-Fallback kann die Modellverarbeitung auf deiner Hardware bleiben, ohne Tokenkosten bei einem Cloud-Anbieter. Telegram und aktivierte Online-Tools übertragen weiterhin Daten an ihre jeweiligen Dienste; „Local only“ macht die gesamte Unterhaltung nicht zu einer rein lokalen Verarbeitung.

1. Ollama installieren

   Lade das Installationsprogramm von ollama.com/download herunter – es gibt Versionen für macOS, Windows und Linux.

2. Ein Modell herunterladen

   ollama pull gemma4
   

3. Ollama mit OpenClaw verbinden

   openclaw onboard
   

   Wähle den Ollama-Anbieter und einen Modus: Local only (deine eigenen Modelle), Cloud only (Modelle von ollama.com) oder Cloud + Local. Der Assistent findet den lokalen Server und zeigt die installierten Modelle an.

4. Prüfen

   openclaw models list --provider ollama
   

Hier ist der ehrliche Vorbehalt, ohne den dieser Abschnitt wie Werbung klingen würde. Laut OpenClaw-Dokumentation braucht man für eine komfortable Nutzung von Agenten mit einem lokalen Modell Hardware auf dem Niveau von zwei voll ausgestatteten Mac Studios, während eine Grafikkarte mit 24 GB nur leichte Anfragen mit Verzögerungen bewältigt. Kleine und stark komprimierte Modelle kürzen den Kontext ab und sind weniger resistent gegen bösartige Anweisungen, die in fremden Texten versteckt sind. Im Alltag reicht ein lokales Modell auf einem guten Laptop zum „Ausprobieren und Verstehen, worum es geht“, aber ein Cloud-Modell ist für die tägliche Arbeit mit einem Agenten, der Tools nutzt, nach wie vor deutlich zuverlässiger.

Noch eine Warnung aus der Dokumentation für alle, die eine Kombination aus WSL2, Ollama und NVIDIA-GPU einrichten: Das offizielle Linux-Installationsprogramm von Ollama aktiviert den automatischen Start mit einer Neustartrichtlinie „always“. Unter WSL2 mit GPU kann das dazu führen, dass der Rechner in einer Neustartschleife landet. Die Lösung ist, den automatischen Start des Dienstes zu deaktivieren. Falls das passiert, findest du Hilfe im Abschnitt zur Fehlerbehebung auf der Ollama-Seite der Dokumentation.

Wie sicher ist es, OpenClaw auszuführen?#

Ich beginne mit dem wichtigsten Punkt, den nicht alle verstehen. OpenClaw hat Zugriff auf deinen Rechner: Dateien, Befehle und Browser. Die Dokumentation sagt es ganz offen: Das Projekt ist für einen vertrauenswürdigen Nutzer ausgelegt, und du solltest Außenstehenden keinen Zugriff auf deinen Bot geben. Wenn jemand deinem Agenten schreiben kann, kann die Person ihn dazu verwenden, auf deinem Computer zu handeln.

Das praktische Minimum:

1. Lass die Kopplung per Code aktiviert oder verwende eine Zugriffsliste – wie du das einrichtest, habe ich im Telegram-Abschnitt beschrieben.
2. Setze das Gateway nicht externen Netzwerken aus, sofern es nicht nötig ist. Standardmäßig lauscht es nur auf deinem Rechner; lass es dabei.
3. Führe nach jeder Konfigurationsänderung die integrierte Prüfung aus:

openclaw security audit

node -v
npm prefix -g
echo "$PATH"

Der Pfad aus dem zweiten Befehl sollte im dritten auftauchen. Falls nicht, füge ihn zu deinen Shell-Einstellungen hinzu oder schließe das Terminal und öffne es erneut: Manchmal erscheint der Node-Pfad nach der Installation erst in einer neuen Sitzung.

Das Gateway läuft, aber der Assistent schweigt. Das Symptom aus den häufig gestellten Fragen der Dokumentation: Auf die erste Nachricht kommt keine Antwort, und der Tokenzähler steht auf null. Das bedeutet, dass der Agent noch gar nicht gestartet ist – meistens ist das Modell nicht konfiguriert. Prüfe in dieser Reihenfolge:

openclaw gateway restart
openclaw status
openclaw models status

Wenn ein Modell konfiguriert ist und trotzdem keine Antwort kommt, zeigt openclaw logs --follow das Live-Protokoll und die Stelle, an der es hängt.

Der Telegram-Bot antwortet nicht. Prüfe in dieser Reihenfolge: Das Token gehört zu dem Bot, dem du schreibst; das Gateway läuft (openclaw gateway status); und deine Kopplung wurde genehmigt (openclaw pairing list telegram). Ein Kopplungscode ist eine Stunde gültig – wenn du dem Bot gestern geschrieben hast, schreib ihm einfach erneut und genehmige den neuen Code.

Wenn du völlig feststeckst, schlägt die Dokumentation etwas Unerwartetes, aber Sinnvolles vor: Gib die Diagnosedaten einem lokalen KI-Agenten, der deinen Rechner sehen kann. Claude Code oder Codex können mit der Ausgabe von openclaw status --all und openclaw doctor die Konfiguration schneller verstehen als ein Support-Chat. Der Kreis schließt sich – KI repariert KI.

Was fragen Menschen sonst noch zu OpenClaw?#

Lerne Ailoot kennen.