OpenClaw auf einem VPS installieren: komplette Anleitung

OpenClaw auf einem VPS zu installieren erfordert einen Linux-Server, empfohlen werden Ubuntu 22.04 oder 24.04 LTS, SSH-Zugriff, einen API-Schlüssel für ein KI-Modell oder Ollama für lokale Inferenz und Zugangsdaten für mindestens eine Messaging-Plattform. Die offizielle Seite beschreibt drei Schritte: Plan wählen, per SSH den Onboarding-Assistenten starten und OpenClaw über das Terminal oder die Control UI durch einen SSH-Tunnel aufrufen. Die manuelle Installation aus dem OpenClaw GitHub-Repository läuft ähnlich ab. Prüfe alle Befehle in der README des Repositorys, bevor du sie ausführst.

Die vorinstallierte Option: Contabo OpenClaw Hosting

Am schnellsten erhältst du eine laufende OpenClaw-Instanz mit einem Contabo VPS-Plan, auf dem OpenClaw bereits installiert ist. Die offizielle Seite bestätigt diesen Ablauf in drei Schritten:

1. Wähle unter contabo.com/de/openclaw-hosting/ einen Plan. Die Pläne sind nach Anwendungsfall gekennzeichnet: private Nutzung, Power User, Team-Bereitstellung und Enterprise-Betrieb. Aktuelle Preise findest du auf der Seite.
2. Sobald der Server bereitsteht, verbindest du dich per SSH und startest den Onboarding-Assistenten. Füge die API-Schlüssel deines KI-Anbieters hinzu, die bei der Einrichtung verschlüsselt werden, verbinde deine Messaging-Apps und konfiguriere deine Einstellungen.
3. Starte die Terminaloberfläche, um direkt mit deinem Assistenten zu interagieren, oder greife über einen SSH-Tunnel sicher auf die Control UI zu.

Contabo bietet vollständigen technischen Support für die VPS-Infrastruktur und die anfängliche 1-Klick-Installation. Für Konfiguration, Wartung und Fehlerbehebung bei OpenClaw bist du selbst verantwortlich. Antworten auf Fragen zur Anwendung findest du in der OpenClaw-Dokumentation und in der GitHub-Community.

Manuelle Installation: Voraussetzungen

Wenn du OpenClaw lieber aus dem GitHub-Repository installierst, halte vor dem Start Folgendes bereit:

• Einen Linux-VPS, empfohlen werden Ubuntu 22.04 LTS oder 24.04 LTS. Prüfe die unterstützten Distributionen in der README des OpenClaw GitHub-Repositorys.
• Root- oder sudo-Zugriff per SSH.
• Genügend RAM für dein vorgesehenes KI-Modell. Weitere Angaben findest du unten im Abschnitt zu den RAM-Anforderungen.
• Einen API-Schlüssel für ein KI-Modell von OpenAI, Anthropic oder Google. Alternativ kannst du Ollama für lokale Inferenz ohne API-Kosten verwenden.
• Zugangsdaten für die Messaging-Plattform: Bot-Token oder Webhook-URL für deine gewählte App.
• Optional eine Domain, die für eine übersichtliche Gateway-URL auf deinen VPS verweist.

Schritt 1: VPS vorbereiten

• Aktualisiere das System:
      sudo apt update && sudo apt upgrade -y
• Erstelle einen Benutzer ohne Root-Rechte, unter dem OpenClaw ausgeführt wird:
      adduser openclaw-user
      usermod -aG sudo openclaw-user
    Wechsle zu diesem Benutzer. Führe OpenClaw niemals als root aus.
• Konfiguriere die UFW-Firewall:
      sudo ufw default deny incoming
      sudo ufw allow OpenSSH
      sudo ufw enable
• Aktiviere die Contabo Firewall auf Netzwerkebene, bevor du weitere Ports öffnest: new.contabo.com → Network Services → Firewall → standardmäßig alle eingehenden Verbindungen blockieren.

Schritt 2: OpenClaw installieren

Prüfe vor der Ausführung die genauen Befehle im OpenClaw GitHub-Repository. Das Projekt wird aktiv weiterentwickelt und die Installationsschritte können sich zwischen Versionen ändern. Der allgemeine Ablauf:

• Klone das Repository. Prüfe die aktuelle URL in der offiziellen OpenClaw-Dokumentation:
      git clone https://github.com/[openclaw-repo] openclaw
      cd openclaw
• Installiere die erforderliche Laufzeitumgebung. Prüfe in der README, ob deine Version Node.js oder Python benötigt:
      # Node.js example:
      npm install
• Kopiere die Vorlage der Umgebungsdatei und konfiguriere sie:
      cp .env.example .env
      nano .env
    Füge den API-Schlüssel deines KI-Modells und die Gateway-Zugangsdaten hinzu. Speichere die Datei.
• Führe alle weiteren Einrichtungsschritte aus der README des Repositorys aus.

Schritt 3: Messaging-App verbinden

Die offizielle Seite bestätigt die Unterstützung folgender Messaging-Plattformen: WhatsApp, Telegram, Discord, Slack, Signal, iMessage und Microsoft Teams.

Telegram

Erstelle über @BotFather einen Bot in Telegram: Sende /newbot, folge den Anweisungen und kopiere das Bot-Token. Füge das Token deiner .env-Datei hinzu. Den genauen Schlüsselnamen findest du in der OpenClaw-Dokumentation.

Discord

Erstelle unter discord.com/developers/applications eine Discord-Anwendung, füge einen Bot hinzu, kopiere das Token und trage es in .env ein. Erzeuge eine OAuth2-Einladungs-URL mit dem bot-Scope und den erforderlichen Berechtigungen. Lade den Bot anschließend auf deinen Server ein. Prüfe die benötigten Berechtigungen in der OpenClaw-Dokumentation.

Slack

Erstelle unter api.slack.com/apps eine Slack-App. Nutze die App-Manifest-Methode, falls sie verfügbar ist. Kopiere das Bot-Token und das Signing Secret in .env. Die aktuelle Slack-Manifest-Vorlage findest du in der OpenClaw-Dokumentation.

WhatsApp

Die Methode zur WhatsApp-Integration kann sich ändern. Prüfe daher vor dem Start den aktuell unterstützten Ansatz im OpenClaw GitHub-Repository, da Änderungen der Plattformrichtlinien die verfügbaren Methoden beeinflussen.

Schritt 4: KI-Modell konfigurieren

Füge die Zugangsdaten für dein ausgewähltes KI-Modell in .env ein. Alle vier folgenden Anbieter werden auf der offiziellen Seite bestätigt:

Wichtiger Hinweis aus den offiziellen FAQ: ‚Du zahlst pro Token. Behalte die Token-Nutzung im Blick, da sich diese Kosten bei einem autonomen Agenten wie OpenClaw schnell summieren können.‘ Mit Ollama entfallen diese Kosten, weil die Modelle lokal auf dem VPS laufen.

Ollama für lokale Inferenz einrichten

1. Installiere Ollama auf demselben VPS:
       curl -fsSL https://ollama.com/install.sh | sh
2. Lade ein Modell herunter:
       ollama pull llama3
3. Lege den Ollama-Endpunkt in .env fest:
       OLLAMA_BASE_URL=http://localhost:11434
     Prüfe den genauen Schlüsselnamen in der OpenClaw-Dokumentation.

RAM-Anforderungen für lokale Inferenz: ungefähr 8 GB für ein 7B-Modell und 16 GB für ein 13B-Modell. Die RAM-Ausstattung der Pläne findest du unter contabo.com/en/openclaw-hosting/.

Schritt 5: Domain und SSL einrichten

Die offiziellen FAQ bestätigen: ‚Ja. Richte deine Domain auf die IP-Adresse deines VPS aus und konfiguriere SSL mit Let’s Encrypt, um sicher auf deine OpenClaw-Instanz zuzugreifen.‘

• Richte den A-Record deiner Domain beim Registrar auf die IP-Adresse deines VPS aus.
• Installiere certbot:
      sudo apt install certbot
• Fordere ein SSL-Zertifikat an:
      sudo certbot certonly –standalone -d yourdomain.com
• Konfiguriere OpenClaw für die Verwendung des Zertifikats. Prüfe die Konfigurationsmethode in der OpenClaw-Dokumentation.
• Öffne den Gateway-Port in UFW. Ersetze 3000 durch deinen tatsächlichen Port:
      sudo ufw allow 3000
    Füge die Regel außerdem in der Contabo Firewall unter new.contabo.com hinzu.

Schritt 6: OpenClaw starten und testen

Führe OpenClaw als systemd-Dienst aus, damit die Anwendung nach einem Neustart des Servers automatisch wieder startet. Erstelle unter /etc/systemd/system/openclaw.service eine Service-Datei. Prüfe den korrekten ExecStart-Befehl und das Arbeitsverzeichnis in der OpenClaw-Dokumentation:

[Unit]
Description=OpenClaw AI Agent
After=network.target

[Service]
Type=simple
User=openclaw-user
WorkingDirectory=/home/openclaw-user/openclaw
ExecStart=/usr/bin/node index.js
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

• Aktiviere und starte den Dienst:
      sudo systemctl enable openclaw
      sudo systemctl start openclaw
• Prüfe den Status:
      sudo systemctl status openclaw
• Sende eine Testnachricht aus deiner Messaging-App. Eine Antwort bestätigt, dass alle Komponenten funktionieren.

Häufige Probleme:

• Keine Antwort von der Messaging-App: Prüfe, ob der Gateway-Port sowohl in UFW als auch in der Contabo Firewall geöffnet ist.
• Fehler beim API-Schlüssel: Prüfe, ob der Schlüssel in .env korrekt und ohne zusätzliche Leerzeichen oder Anführungszeichen eingetragen ist.
• Ollama-Modell wird nicht geladen: Prüfe mit free -h den verfügbaren RAM und lade bei Bedarf ein kleineres Modell herunter.

FAQ: OpenClaw auf einem VPS installieren

Hinweis: Die in diesem Artikel genannten Produktspezifikationen, Funktionen und Preise können sich ändern und je nach Region, Abrechnungszeitraum und laufender Aktion abweichen. Aktuelle Angaben, Preise und lokale Wechselkurse findest du auf der offiziellen Website des jeweiligen Anbieters oder der jeweiligen Marke.