Jan 30, 2026
Faradilla A.
10Min. Lesezeit
Die Installation von OpenClaw (früher unter dem Namen Moltbot/Clawbot bekannt) auf einem privaten Server umfasst mehrere Schritte: die Vorbereitung Ihrer VPS-Umgebung (Virtual Private Server), das Klonen des OpenClaw-Repository, das Ausführen des Docker-Setups, die Konfiguration der Zugangsdaten für Ihren KI-Anbieter sowie die Anbindung an eine Messaging-Plattform.
Der gesamte Einrichtungsprozess ist überschaubar und dauert in der Regel etwa 30 Minuten. Am Ende verfügen Sie über einen eigenen KI-Assistenten, der rund um die Uhr auf Nachrichten reagieren kann.
Technisch lässt sich OpenClaw auch auf einem lokalen Laptop betreiben, dies ist jedoch mit klaren Einschränkungen verbunden. Sobald Sie den Rechner schließen oder die Internetverbindung unterbrochen wird, ist der Bot nicht mehr erreichbar.
Aus diesem Grund ist der Betrieb auf einem privaten Server besonders sinnvoll. Ein VPS sorgt für konstante Verfügbarkeit und kontinuierliche Hintergrundausführung, auch wenn Sie offline sind. So läuft OpenClaw dauerhaft, ohne dass Sie ihn manuell überwachen müssen.
Um OpenClaw auf einem privaten Server zu installieren, benötigen Sie einen Linux-basierten VPS mit vollem administrativen Zugriff. Dieser Server bildet die Grundlage der Einrichtung, denn dieses dauerhaft aktive System stellt sicher, dass Ihr Bot jederzeit verfügbar bleibt.
Sie benötigen dafür keinen Hochleistungsserver, sollten jedoch bestimmte OpenClaw-Anforderungen erfüllen, um einen stabilen Betrieb zu gewährleisten.
Hier ist Ihre Checkliste für den Server:
In diesem Beispiel verwenden wir Hostingers OpenClaw-Hosting, da der integrierte Docker-Manager die Einrichtung vereinfacht. Die gleichen Schritte gelten jedoch grundsätzlich für jeden anderen VPS-Anbieter.
Wenn Sie mit der Einrichtung eines VPS noch nicht vertraut sind, sollten Sie zunächst eine grundlegende VPS-Ersteinrichtung durchführen und sicherstellen, dass Sie sich per SSH mit Ihrem Server verbinden können.

Docker bildet die Grundlage für den Betrieb von OpenClaw. Es kapselt alle benötigten Komponenten in Containern, sodass Abhängigkeiten nicht manuell installiert und einzeln konfiguriert werden müssen. Dadurch ist die Installation übersichtlicher, zuverlässiger und deutlich einfacher zu warten.
Wenn Sie Hostinger verwenden, dann öffnen Sie im hPanel den Docker Manager. Sollte Docker noch nicht installiert worden sein, lässt er sich mit wenigen Klicks aktivieren. Dies ist der einfachste Weg.
Wenn Sie einen anderen VPS-Anbieter nutzen oder Docker manuell überprüfen möchten, dann verbinden Sie sich per SSH mit Ihrem Server und führen Sie die folgenden Befehle aus:
docker --version
docker compose version
Wenn beide Befehle eine Versionsnummer zurückmelden, sind Docker und Docker Compose korrekt installiert. Erhalten Sie stattdessen die Meldung „command not found“, wurde Docker noch nicht eingerichtet.
Ein funktionsfähiges OpenClaw-Docker-Setup setzt ein korrekt installiertes Docker-Containersystem voraus. Installieren Sie Docker in diesem Fall manuell unter Ubuntu und überprüfen Sie die Installation anschließend erneut.
Sobald die Docker-Installation verifiziert und ausgeführt wird, können Sie mit der eigentlichen Bereitstellung von OpenClaw fortfahren.
Nun folgt der zentrale Teil der Einrichtung. In diesem Schritt klonen Sie das OpenClaw-Repository und verwenden das offizielle Docker-Setup-Skript, um OpenClaw zu erstellen und bereitzustellen.
Zunächst müssen Sie den OpenClaw-Code auf Ihren Server herunterladen. Sollte Git noch nicht installiert worden sein, müssen Sie dies zuerst tun:
# Git installieren (falls noch nicht vorhanden)
sudo apt install git -y
# Repository klonen
git clone https://github.com/openclaw/openclaw.git
# In das OpenClaw-Verzeichnis wechseln
cd openclaw
Führen Sie nun das Docker-Setup-Skript aus. OpenClaw beinhaltet ein eigenes Setup-Skript, das die gesamte Erstkonfiguration automatisiert übernimmt:
./docker-setup.sh
Dieses Setup-Skript ist der wesentliche Einstiegspunkt für die OpenClaw-Installation. Es erledigt unter anderem folgende Aufgaben:
Der gesamte Vorgang ist weitgehend automatisiert. Im Unterschied zu vielen Docker-Anwendungen, bei denen ein vorgefertigtes Image aus einem Registry geladen wird, erstellt OpenClaw das Image lokal auf Ihrem Server. Das hat mehrere Vorteile:
Während der Ausführung des Docker-Setup-Skripts startet ein interaktiver Onboarding-Assistent, der OpenClaw für Sie konfiguriert. In diesem Schritt richten Sie die Zugangsdaten für Ihren KI-Anbieter sowie weitere grundlegende Einstellungen ein.
Wenn Sie ./docker-setup.sh ausführen, sehen Sie nach dem Build des Images den Onboarding-Assistenten. Er stellt mehrere wichtige Fragen:
Gateway-Modus:
Wählen Sie Lokal, sodass das Gateway direkt auf Ihrem VPS betrieben wird.
Authentifizierungsmethode:
Dies ist der wichtigste Teil der Konfiguration. Sie müssen festlegen, wie OpenClaw auf KI-Modelle zugreifen soll. Zur Auswahl stehen unter anderem:
Wenn Sie die empfohlene Option mit einem Anthropic-API-Schlüssel wählen, müssen Sie sich bei Anthropic anmelden, im Dashboard zu den API-Schlüsseln navigieren, einen neuen Schlüssel erstellen, ihn kopieren und im Setup-Assistenten einfügen.
Bewahren Sie diesen Schlüssel sorgfältig auf. Jeder, der Zugriff darauf hat, kann das Modell über Ihr Konto verwenden, und die Nutzung wird Ihnen in Rechnung gestellt.
Bei den anderen Optionen ist der Ablauf ähnlich: Sie erhalten einen API-Schlüssel von der jeweiligen Plattform und hinterlegen ihn im Setup. Der Assistent speichert diese Zugangsdaten anschließend als Linux-Umgebungsvariablen in den OpenClaw-Konfigurationsdateien.
Danach wählen Sie das gewünschte Modell für den jeweiligen Anbieter sowie die zugehörigen Sicherheitseinstellungen aus.
Ein häufiger Konfigurationsfehler bei OpenClaw ist ein fehlender oder ungültiger API-Schlüssel. Ohne einen gültigen Anthropic- oder OpenAI-Schlüssel kann OpenClaw nicht arbeiten. Beachten Sie außerdem, dass sowohl Anthropic als auch OpenAI eine hinterlegte Zahlungsmethode für den API-Zugriff voraussetzen. Stellen Sie daher sicher, dass Ihr Schlüssel aktiv ist und die Abrechnung korrekt eingerichtet wurde.
Nach Abschluss des Setup-Skripts sollte OpenClaw bereits in Betrieb sein.
Wechseln Sie in das OpenClaw-Verzeichnis, um zu verifizieren, dass alle Container korrekt laufen, und überprüfen Sie den Status:
# Stelle sicher, dass du dich im Openclaw-Verzeichnis befindest
cd ~/openclaw
# Laufende Container überprüfen
docker compose ps
Sie sollten den Container openclaw-gateway mit dem Status „Up“ oder „Running“ sehen. Weitere Anzeichen für einen erfolgreichen Start sind unter anderem:
Wenn stattdessen Meldungen wie „Invalid API key,“ „Authentication failed,“ „Connection refused,“ erscheinen oder der Container wiederholt neu startet, liegt ein Konfigurationsproblem vor.
Brechen Sie in diesem Fall nicht einfach ab, sondern prüfen Sie die Logs gezielt:
docker compose logs openclaw-gateway
Dies ist wichtig für die Fehlerbehebung. Die OpenClaw-Protokolle zeigen, was der Bot tatsächlich ausführt, sodass Sie die Probleme beheben können.
Das OpenClaw-Dashboard ist über die IP-Adresse Ihres VPS auf Port 18789 erreichbar:
http://your-vps-ip:18789
Beispiel: http://45.123.45.67:18789
Wenn Sie die Steuerungsoberfläche zum ersten Mal aufrufen, benötigen Sie das Gateway-Token, das während der Einrichtung generiert wurde. Sie finden es mit folgendem Befehl:
cat ~/.clawdbot/.env | grep CLAWDBOT_GATEWAY_TOKEN
Alternativ können Sie auch die Ausgabe des Setup-Skripts prüfen. Wenn Sie ./docker-setup.sh ausgeführt haben, wird das Gateway-Token am Ende der Ausgabe angezeigt.
Hinweis: Obwohl das Projekt inzwischen OpenClaw heißt, verwenden Konfigurationsdateien und Verzeichnisse weiterhin die Bezeichnung clawdbot (z. B. ~/.clawdbot/ und CLAWDBOT_GATEWAY_TOKEN). Dies ist während der Übergangsphase normal und hat keinen Einfluss auf die Funktionalität.
Rufen Sie das Dashboard auf, navigieren Sie zu Settings → Token (eventuell werden Sie auch direkt dazu aufgefordert). Fügen Sie das Gateway-Token ein und klicken Sie anschließend auf Speichern oder Authentifizieren.
Die OpenClaw-Schnittstelle dient als zentrales Kontrollzentrum. Sie müssen an dieser Stelle noch nicht alle Optionen konfigurieren. Stellen Sie lediglich sicher, dass Sie Zugriff haben und dass OpenClaw als funktionsfähig angezeigt wird.
Wenn Sie die Benutzeroberfläche nicht erreichen können, dann führen Sie die folgenden Schritte zur Fehlerbehebung aus:
Das Web-Dashboard, das Sie zuvor eingerichtet haben, dient der Verwaltung. Die eigentliche Interaktion mit OpenClaw erfolgt jedoch über eine Messaging-Anwendung, in der die KI-Konversationen stattfinden.
Im folgenden Beispiel wird die Einrichtung mit Telegram beschrieben, da diese Plattform besonders einfach zu konfigurieren ist. Der grundlegende Ablauf ist bei anderen Messaging-Diensten jedoch vergleichbar.
So richten Sie einen Telegram-Nachrichtenkanal für OpenClaw ein:
Schritt 1: Erstellen Sie einen Telegram-Bot
Schritt 2: Fügen Sie Telegram zu OpenClaw hinzu
Wechseln Sie zurück auf Ihren Server und führen Sie die folgenden Befehle aus:
# Stelle sicher, dass du dich im OpenClaw-Verzeichnis befindest
cd ~/openclaw
# Telegram mit deinem Bot-Token hinzufügen
docker compose run --rm openclaw-cli providers add --provider telegram --token YOUR_BOT_TOKEN
Ersetzen Sie YOUR_BOT_TOKEN durch das aktuelle Token, das Sie von BotFather erhalten haben.
Schritt 3: Aktivieren Sie die erforderlichen Bot-Berechtigungen
Führen Sie im BotFather-Chat die folgenden Schritte aus:
Schritt 4: Beginnen Sie mit dem Chat
Wenn Sie während der Einrichtung die DM-Kopplung aktiviert haben, erhalten Sie einen Kopplungscode. Genehmigen Sie diesen auf Ihrem Server mit folgendem Befehl:
docker compose run --rm openclaw-cli pairing approve telegram <der-erhaltene-code>
Senden Sie nach der Genehmigung eine weitere Nachricht. OpenClaw sollte nun antworten.
Wenn Nachrichten in Ihrem OpenClaw-Telegram-Setup nicht funktionieren, dann überprüfen Sie die folgenden Punkte:
So überprüfen Sie häufige Probleme bei der Einrichtung von OpenClaw: Prüfen Sie zunächst den Container-Status, kontrollieren Sie Ihr Gateway-Token und analysieren Sie die Protokolle auf konkrete Fehlermeldungen. Die meisten Probleme lassen sich klaren Kategorien zuordnen und können schnell behoben werden, sobald Sie wissen, worauf Sie achten müssen.
Im Folgenden finden Sie die häufigsten Ursachen, wenn OpenClaw nicht wie erwartet funktioniert.
Container stoppt wiederholt
Wenn der Container startet, aber immer wieder stoppt, gehen Sie wie folgt vor:
Häufige Ursachen sind ein fehlender oder ungültiger API-Schlüssel, ein bereits belegter Port 18789, Probleme mit der Docker-Compose-Konfiguration oder unzureichende Berechtigungen.
Authentifizierungsfehler
Dies ist das mit Abstand häufigste Problem. Wenn Meldungen wie „authentication failed,“ „invalid API key“ auftreten oder Modellanforderungen fehlschlagen, dann überprüfen Sie Ihren API-Schlüssel:
cat ~/.clawdbot/.env
Suchen Sie nach ANTHROPIC_API_KEY oder OPENAI_API_KEY und stellen Sie sicher, dass:
Überprüfen Sie außerdem im Dashboard der jeweiligen KI-Plattform, ob der Schlüssel gültig ist und die Abrechnung aktiv ist. Sowohl Anthropic als auch OpenAI setzen eine aktive Zahlungsmethode für den API-Zugriff voraus.
Fügen Sie die Zugangsdaten anschließend erneut hinzu oder aktualisieren Sie sie:
# .env-Datei bearbeiten
nano ~/.clawdbot/.env
# API-Schlüssel hinzufügen oder aktualisieren
ANTHROPIC_API_KEY=your_actual_key_here
# Gateway neu starten
docker compose restart openclaw-gateway
Portkonflikte
Wenn Fehlermeldungen wie „port already in use“ oder „address already in use“ angezeigt werden, dann gehen Sie wie folgt vor:
Container-Neustartschleifen
Wenn der Container ständig neu gestartet wird, deutet dies in der Regel auf fehlende Umgebungsvariablen, beschädigte Konfigurationsdateien, eine ungültige Modellkonfiguration oder Berechtigungsprobleme hin.
So beheben Sie das Problem:
Kein Zugriff auf die Benutzeroberfläche
Wenn der Container läuft, Sie aber das Dashboard nicht erreichen können, dann überprüfen Sie Folgendes:
OpenClaw sicher neu starten
Ein Neustart ist erforderlich, wenn Sie Umgebungsvariablen ändern, der Bot nicht mehr reagiert oder bestimmte Konfigurationsanpassungen vorgenommen wurden.
Ein Neustart kann auch ungewöhnliches Verhalten beheben, selbst wenn keine offensichtlichen Fehler in den Protokollen erscheinen.
Für einen schnellen Neustart ohne vorheriges Stoppen des Containers:
docker restart openclaw-gateway
Oder für einen sauberen Neustart, bei dem Sie den Container manuell stoppen und anschließend neu starten (nützlich, wenn Sie mehr Kontrolle über den Prozess benötigen oder sicherstellen möchten, dass der Container vollständig stoppt):
docker stop openclaw-gateway
docker start openclaw-gateway
Zu den bewährten Best Practices für den Betrieb von OpenClaw zählen der sichere Umgang mit dem Gateway-Token, die regelmäßige Überwachung der Ressourcennutzung sowie das konsequente Einspielen von Updates.
Der Betrieb eines KI-Bots auf einem Server bringt Verantwortung mit sich. Dieser werden Sie gerecht, indem Sie frühzeitig saubere Betriebsgewohnheiten in zentralen Bereichen etablieren.
Sicherheitspraktiken
Ressourcenmanagement
OpenClaw ist vergleichsweise ressourcenschonend, dennoch sollten Sie die folgenden Aspekte regelmäßig überwachen:
Wenn Sie anhaltende Ressourcenengpässe feststellen, sollten Sie entweder ein Upgrade Ihres VPS in Betracht ziehen oder analysieren, wodurch die erhöhte Nutzung verursacht wird.
Update-Strategie
Neue OpenClaw-Versionen werden regelmäßig veröffentlicht und enthalten Verbesserungen sowie Fehlerkorrekturen.
Überwachung der Betriebszeit
Richten Sie eine grundlegende Überwachung ein, damit Sie frühzeitig bemerken, wenn OpenClaw nicht mehr erreichbar ist:
Sicherung der Konfiguration
Ihre Umgebungsvariablen – insbesondere das Gateway-Token – sind für den Betrieb von OpenClaw essenziell und sollten sicher dokumentiert werden:
Um OpenClaw nach der Einrichtung zuverlässig zu betreiben, sollten Sie die Protokolle regelmäßig prüfen, den Container bei neuen Versionen aktualisieren und die wichtigsten Leistungskennzahlen im Blick behalten.
Der tägliche Verwaltungsaufwand ist gering, wenn alles reibungslos läuft. Eine gewisse regelmäßige Kontrolle hilft jedoch dabei, den Betrieb stabil und gesund zu halten. Die folgenden Maßnahmen haben sich bewährt.
Überprüfen Sie die Protokolle regelmäßig
Machen Sie es sich zur Gewohnheit, etwa einmal pro Woche einen Blick in die Protokolle zu werfen:
docker compose logs --tail 100 openclaw-gateway
Achten Sie dabei insbesondere auf wiederkehrende Fehler oder Warnungen, Leistungsprobleme, Verbindungsfehler oder ungewöhnliche Muster.
Meist werden Sie lediglich den normalen Betriebsablauf sehen. Wenn Sie Auffälligkeiten jedoch frühzeitig erkennen, lassen sich größere Probleme meist vermeiden.
Halten Sie OpenClaw auf dem neusten Stand
Wenn eine neue OpenClaw-Version veröffentlicht wird, können Sie den aktuellen Code direkt aus dem Repository abrufen:
git pull
Führen Sie anschließend das Setup-Skript erneut aus. Ihre bestehende Konfiguration bleibt dabei erhalten:
./docker-setup.sh
Überwachen Sie die Betriebszeit
Überprüfen Sie regelmäßig den Status der Container. Der Container sollte als Up angezeigt werden. Wenn er hingegen häufig neu startet, dann analysieren Sie die Protokolle, um die Ursache zu ermitteln.
Überwachen Sie die Leistung
Kontrollieren Sie alle paar Wochen die Ressourcennutzung des Containers:
docker stats openclaw-gateway
Dieser Befehl zeigt die CPU-, Speicher- und Netzwerkauslastung in Echtzeit an. Wenn die Nutzung dauerhaft hoch erscheint, sollten Sie folgende Schritte in Betracht ziehen:
Für die meisten Einsatzszenarien sind keine komplexen Maßnahmen wie Skalierung, Clustering oder aufwendige Optimierungen erforderlich. OpenClaw läuft für den persönlichen Einsatz oder kleine Teams zuverlässig auf einem einzigen VPS.
Konzentrieren Sie sich darauf, den Betrieb stabil aufrechtzuerhalten, bei Bedarf Updates einzuspielen, Fehler frühzeitig zu erkennen und grundlegende Sicherheitsmaßnahmen konsequent umzusetzen.
Weitere Informationen zu Docker-Befehlen, die bei der Verwaltung von OpenClaw hilfreich sind, finden Sie in diesem Docker-Spickzettel.
Alle Tutorial-Inhalte auf dieser Website unterliegen Hostingers strengen redaktionellen Standards und Normen.