OpenClaw einrichten: Dein KI-Assistent läuft direkt in Telegram
OpenClaw installieren, mit Telegram verbinden und KI-Modelle wie Claude oder GPT nutzen — komplett lokal, Open Source und in 15 Minuten einsatzbereit.
ChatGPT im Browser öffnen, Frage eintippen, Tab wechseln, Antwort lesen, zurück zur Arbeit. Das ist der Workflow, den die meisten kennen. OpenClaw ersetzt diesen Umweg: Du schreibst deinem KI-Assistenten direkt in Telegram — und bekommst die Antwort dort, wo du sowieso schon bist.
Dieser Guide führt dich durch die komplette Einrichtung: Installation, Telegram-Anbindung, Modellauswahl und die wichtigsten Anpassungen. Am Ende läuft dein eigener KI-Assistent lokal auf deinem Rechner.
Was ist OpenClaw?
OpenClaw ist ein selbst gehostetes Open-Source-Gateway (MIT-Lizenz), das deine Chat-Apps mit KI-Agenten verbindet. Statt über eine Web-Oberfläche kommunizierst du über Messenger — Telegram, WhatsApp, Discord, Slack, Signal, iMessage und mehr.
Der Ablauf ist simpel: Du sendest eine Nachricht in Telegram. OpenClaw empfängt sie, leitet sie an ein KI-Modell weiter und schickt die Antwort zurück in den Chat. Das Ganze läuft lokal auf deinem Rechner. Keine Daten auf fremden Servern, keine Abhängigkeit von einer einzelnen Plattform.
Was OpenClaw kann:
- Mehrere KI-Modelle nutzen (Claude, GPT, Gemini, lokale Modelle via Ollama)
- Dateien lesen und erstellen
- Terminal-Befehle ausführen
- Im Internet suchen und Webseiten auslesen
- Konversationen über Sessions hinweg merken
- Persönlichkeit und Verhalten anpassen
Was du brauchst:
- Node.js ab Version 22
- Einen Telegram-Account
- Einen API-Key von mindestens einem KI-Anbieter (Anthropic, OpenAI oder Google)
- 15–20 Minuten Zeit
Installation
OpenClaw läuft auf macOS, Linux und Windows (via WSL2 empfohlen). Öffne ein Terminal und führe die Installation durch.
Empfohlen — npm + Onboarding-Wizard:
npm install -g openclaw@latest
openclaw onboard --install-daemon
Der Wizard führt dich Schritt für Schritt durch Gateway, Workspace, Channels und Skills. Der --install-daemon-Flag installiert den Gateway-Dienst, damit er im Hintergrund weiterläuft.
Alternativ — One-Liner (nur CLI, ohne Wizard):
macOS / Linux:
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash
Windows (PowerShell):
iwr -useb https://openclaw.ai/install.ps1 | iex
Prüfe die Installation mit:
openclaw --version
Wenn eine Versionsnummer erscheint (z.B. 2025.6.15), hat alles funktioniert. Falls nicht: Terminal schließen, neu öffnen und nochmal versuchen.
Ein nützlicher Befehl für die Fehlersuche:
openclaw doctor
Das prüft, ob alle Abhängigkeiten korrekt eingerichtet sind.
Telegram-Bot erstellen und verbinden
Damit OpenClaw über Telegram erreichbar ist, brauchst du einen Telegram-Bot. Das dauert zwei Minuten.
Schritt 1 — Bot bei BotFather erstellen:
- Öffne Telegram und suche nach
@BotFather - Sende
/newbot - Wähle einen Namen (z.B. "Mein KI Assistent")
- Wähle einen Benutzernamen mit der Endung
bot(z.B.mein_ki_bot) - BotFather gibt dir einen Token — eine lange Zeichenkette wie
123456789:ABCDefGhIJKlMNoPQRstuVWxyz
Schritt 2 — Token in OpenClaw eintragen:
Öffne die Konfigurationsdatei ~/.openclaw/openclaw.json und trage den Telegram-Kanal ein:
{
"channels": {
"telegram": {
"enabled": true,
"token": "DEIN_BOTFATHER_TOKEN",
"dmPolicy": "pairing"
}
}
}
Die Einstellung dmPolicy: "pairing" bedeutet, dass neue Geräte erst genehmigt werden müssen — wichtig für die Sicherheit.
Schritt 3 — Gateway starten und Gerät koppeln:
openclaw gateway restart
openclaw pairing list telegram
openclaw pairing approve telegram DEIN_CODE
Jetzt kannst du deinem Bot in Telegram schreiben und bekommst Antworten vom KI-Modell.
KI-Modell auswählen
OpenClaw unterstützt mehrere Anbieter gleichzeitig. Die Modelle werden im Format anbieter/modellname angegeben.
Verfügbare Anbieter:
| Anbieter | Modelle | Stärke |
|---|---|---|
| Anthropic | Claude Sonnet, Claude Opus | Analyse, Programmierung, komplexe Aufgaben |
| OpenAI | GPT-4o, GPT-5 | Allgemeine Texte, Konversation |
| Gemini | Informationssuche, Recherche | |
| OpenRouter | Zugang zu vielen Anbietern | Flexibilität |
| Ollama | Lokale Modelle | Kostenlos, offline, volle Kontrolle |
Modell konfigurieren:
Am schnellsten geht es über den Setup-Assistenten:
openclaw onboard
Oder manuell in der Konfigurationsdatei — dort kannst du ein Hauptmodell und ein Fallback-Modell setzen. Wenn das Hauptmodell nicht erreichbar ist, wechselt OpenClaw automatisch zum Backup.
Während einer Konversation wechseln:
Sende /model im Chat, um zwischen konfigurierten Modellen zu wechseln. Praktisch, wenn du für verschiedene Aufgaben verschiedene Modelle bevorzugst.
Persönlichkeit anpassen
OpenClaw speichert die Persönlichkeit in Markdown-Dateien im Ordner ~/.openclaw/workspace/. Fünf Dateien steuern das Verhalten:
IDENTITY.md — Name und Stil des Assistenten. Beispiel:
Name: Alex
Emoji: 🤖
Stil: direkt, technisch, ohne Smalltalk
SOUL.md — Charakterzüge und Grenzen. Hier definierst du, wie der Assistent kommuniziert und was er nicht tun soll (z.B. keine medizinischen Diagnosen).
AGENTS.md — Arbeitsanweisungen. Was ist die Aufgabe des Assistenten? Wie soll er komplexe Anfragen angehen?
USER.md — Informationen über dich: Name, Zeitzone, Sprache, Interessen. Damit kann der Assistent Antworten personalisieren.
TOOLS.md — Umgebungsspezifische Einstellungen und Tool-Präferenzen.
Änderungen werden beim nächsten Gesprächsstart aktiv. Du kannst die Dateien manuell editieren oder den Assistenten bitten, sie selbst anzupassen.
Gedächtnis und Kontext
Einer der größten Vorteile gegenüber ChatGPT: OpenClaw hat ein echtes Langzeitgedächtnis.
Kontext ist alles, was das Modell in der aktuellen Konversation sieht — begrenzt durch das Kontextfenster des jeweiligen Modells. Wenn ein Gespräch zu lang wird, komprimiert OpenClaw ältere Nachrichten automatisch zu Zusammenfassungen (Compaction).
Memory sind Dateien auf deiner Festplatte, die zwischen Sessions bestehen bleiben:
- Tagesnotizen (
memory/2026-02-22.md) — OpenClaw lädt automatisch die Notizen von heute und gestern - MEMORY.md — Permanenter Speicher für wichtige Fakten und Entscheidungen
- Semantische Suche — OpenClaw findet gespeicherte Informationen nach Bedeutung, nicht nur nach exakten Begriffen
Das bedeutet: Dein Assistent weiß nächste Woche noch, was ihr heute besprochen habt.
Werkzeuge des Assistenten
OpenClaw kann mehr als nur Text generieren. Folgende Tools stehen zur Verfügung:
- exec — Führt Terminal-Befehle auf deinem Rechner aus (in einer Sandbox)
- web_search — Sucht im Internet über Brave Search
- web_fetch — Liest den Textinhalt von Webseiten aus
- browser — Steuert einen echten Browser (Klicks, Formulare, Screenshots)
- read / write / edit — Liest, erstellt und bearbeitet Dateien
- message — Sendet Nachrichten an andere Messenger-Kanäle
Du kannst einzelne Tools deaktivieren oder Presets verwenden (minimal, coding, messaging, full), je nachdem wofür du den Assistenten nutzt.
Server-Deployment: 24/7 erreichbar
Wenn OpenClaw auf deinem Laptop läuft, ist der Assistent weg, sobald du den Deckel zumachst. Für permanente Erreichbarkeit brauchst du einen Server.
Empfohlen: Hetzner VPS + Docker (~5 EUR/Monat)
- VPS mieten und per SSH verbinden
- Docker und Docker Compose installieren
- OpenClaw-Repository klonen und Setup-Script ausführen
- Messenger-Kanäle über Docker-Befehle konfigurieren
- Health-Check prüfen
Das Control Panel erreichst du über einen SSH-Tunnel auf localhost:18789. Der Container startet automatisch bei Serverneustarts.
Alternative: Fly.io (~5 EUR/Monat)
Weniger Aufwand — Fly.io übernimmt Image-Bau, HTTPS und automatische Neustarts. Dafür weniger Kontrolle.
Wichtig: Alle OpenClaw-Daten liegen in ~/.openclaw/. Dieser Ordner muss auf einem persistenten Speicher liegen, sonst gehen Konfiguration und Gedächtnis bei einem Container-Neustart verloren.
Weitere Messenger
Neben Telegram unterstützt OpenClaw auch WhatsApp (QR-Code-Kopplung), Discord, Slack, Signal, Google Chat, iMessage (nur macOS) und Microsoft Teams. Die Einrichtung folgt dem gleichen Muster: Kanal in der Config aktivieren, Zugangsdaten eintragen, Gateway neu starten.
Zusammenfassung
OpenClaw gibt dir einen KI-Assistenten, der dort lebt, wo du sowieso kommunizierst. Keine Browser-Tabs, keine Plattform-Abhängigkeit, volle Kontrolle über deine Daten.
Die wichtigsten Schritte:
openclawinstallieren (ein Befehl)- Telegram-Bot bei BotFather erstellen
- Token eintragen und Gateway starten
- KI-Modell konfigurieren (Claude, GPT oder lokal)
- Optional: Persönlichkeit anpassen und auf Server deployen
Ein vollständiger englischer Kurs mit mehreren Lektionen in drei Levels (Beginner, Intermediate, Advanced) ist kostenlos verfügbar unter openclaw-course.pages.dev.