Deployment OpenClaw: Ihre eigene AI-Agent-Plattform auf dem VPS

Einleitung: Warum Self-Hosting für KI-Agenten?

In einer Zeit, in der KI-Dienste wie ChatGPT und Claude die Produktivität revolutionieren, wächst auch die Sorge um Datensouveränität und Privatsphäre. Besonders für Privatpersonen und kleine bis mittelständische Unternehmen (KMU) ist die Frage entscheidend: Wo laufen meine Daten und wer hat Zugriff darauf?

Hier kommt OpenClaw ins Spiel – eine self-hosted Gateway-Lösung, die Ihnen ermöglicht, Ihre eigenen KI-Agenten auf Ihrem eigenen Server zu betreiben. Mit einem monatlichen Aufwand von null Euro (abgesehen von den Server-Kosten) erhalten Sie eine leistungsstarke KI-Assistent-Plattform, die komplett unter Ihrer Kontrolle steht.

In diesem Artikel zeige ich Ihnen Schritt für Schritt, wie Sie OpenClaw auf einem VPS (Virtual Private Server) von Hetzner deployen können – eine Lösung, die sowohl für private Anwender als auch für KMUs geeignet ist.

Was ist OpenClaw?

OpenClaw ist ein Self-Hosted Gateway für KI-Agenten, das als Brücke zwischen Ihren bevorzugten Messaging-Apps und KI-Coding-Agents wie Pi fungiert. Das Konzept ist genial einfach:

• Ein einziger Gateway-Prozess läuft auf Ihrem Server
• Dieser Gateway verbindet WhatsApp, Telegram, Discord, iMessage und mehr
• Sie können jederzeit von überall mit Ihrem persönlichen KI-Assistenten chatten
• Ihre Daten bleiben auf Ihrem Server – keine Cloud-Abhängigkeit

Kernfunktionen:

1. Multi-Channel Support: Ein Gateway bedient gleichzeitig mehrere Kanäle
2. Agent-Native: Speziell entwickelt für Coding-Agents mit Tool-Use, Sessions und Memory
3. Open Source: MIT-lizenziert und community-getrieben
4. Self-Hosted: Läuft auf Ihrer Hardware, nach Ihren Regeln

Für wen ist OpenClaw geeignet?

• Entwickler: Die einen persönlichen KI-Assistenten für Code-Support wünschen
• Power-User: Die maximale Kontrolle über ihre Daten möchten
• Kleinunternehmen: Die eine kostengünstige KI-Lösung für interne Automatisierung suchen
• Privacy-Bewusste: Die Cloud-Dienste aufgrund von Datenbedenken vermeiden wollen

Warum Hetzner als VPS-Provider?

Für das Hosting von OpenClaw empfehle ich Hetzner aus mehreren Gründen:

• Preis-Leistung: Unschlagbare Preise für leistungsstarke Server
• Datenschutz: Deutsche Unternehmen unterliegen strengen Datenschutzgesetzen (DSGVO)
• Infrastruktur: Moderne Rechenzentren in Deutschland und Finnland
• Einfachheit: Intuitive Cloud-Console und API
• Transparenz: Keine versteckten Kosten, keine Vertragsbindung

Empfohlene Server-Konfiguration:

Für OpenClaw empfehle ich mindestens:

• CPU: 2 vCPUs (Hetzner CX22 oder höher)
• RAM: 4 GB RAM
• Speicher: 40 GB SSD
• Betriebssystem: Debian 12 (Bookworm) oder Ubuntu 22.04 LTS

Kosten: Ca. 4-5 €/Monat

Voraussetzungen für das Deployment

Bevor wir mit der Installation beginnen, stellen Sie sicher, dass Sie folgende Voraussetzungen erfüllen:

Technische Anforderungen:

1. SSH-Zugriff: Kenntnis der Basics von SSH und Linux-Command-Line
2. Domain: Eine Domain (empfohlen, aber optional für lokale Entwicklung)
3. API-Schlüssel: Anthropic API-Key (oder alternativ OpenAI, OpenRouter) für KI-Modelle
4. Node.js: Version 22+ (wir werden dies während der Installation installieren)
5. Docker: Für Container-Isolation (optional, aber empfohlen)

Software-Voraussetzungen auf Ihrem lokalen Rechner:

• SSH-Client (integriert in macOS/Linux, Putty für Windows)
• Text-Editor (VS Code, Sublime Text oder Nano/Vim)

Schritt-für-Schritt Installation Guide

Schritt 1: VPS bei Hetzner erstellen

1. Registrieren Sie sich bei Hetzner Cloud
2. Erstellen Sie ein Projekt und klicken Sie auf "Add Server"
3. Wählen Sie folgende Konfiguration:
   • Standort: Nürnberg oder Helsinki (je nach Ihrer Zielgruppe)
   • Image: Debian 12 (Bookworm)
   • Typ: CX22 (2 vCPUs, 4 GB RAM)
   • SSH Key: Fügen Sie Ihren öffentlichen SSH-Schlüssel hinzu (empfohlen) oder wählen Sie Root-Passwort
4. Server erstellen – Nach ca. 2-3 Minuten ist Ihr Server bereit

Schritt 2: Mit SSH verbinden

# Mit Ihrem SSH-Key
ssh root@ihre-server-ip

# Oder mit Passwort
ssh root@ihre-server-ip

Schritt 3: System aktualisieren und vorbereiten

# System aktualisieren
apt update && apt upgrade -y

# Notwendige Pakete installieren
apt install -y curl git nano ufw fail2ban

# Firewall einrichten (nur SSH, HTTP, HTTPS erlauben)
ufw allow ssh
ufw allow http
ufw allow https
ufw --force enable

# Optional: Fail2Ban für SSH-Schutz aktivieren
systemctl enable fail2ban
systemctl start fail2ban

Schritt 4: Node.js 22 installieren

OpenClaw benötigt Node.js 22 oder höher:

# Node.js Repository hinzufügen
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -

# Node.js und npm installieren
apt install -y nodejs

# Installation überprüfen
node --version  # Sollte v22.x.x zeigen
npm --version   # Sollte 10.x.x zeigen

Schritt 5: OpenClaw installieren

# Arbeitsverzeichnis erstellen
mkdir -p /opt/openclaw
cd /opt/openclaw

# OpenClaw installieren (Beispiel - abhängig von der offiziellen Installationsmethode)
# Da OpenClaw noch in Entwicklung ist, gibt es verschiedene Möglichkeiten:

# Option A: Via npm (Global)
npm install -g @tell-a-friend/openclaw

# Option B: Via Git Repository klonen
git clone https://github.com/tell-a-friend/openclaw.git
cd openclaw
npm install
npm run build

Schritt 6: Konfiguration einrichten

OpenClaw speichert seine Konfiguration in ~/.openclaw/openclaw.json:

# Konfigurationsverzeichnis erstellen
mkdir -p ~/.openclaw

# Basis-Konfiguration erstellen
nano ~/.openclaw/openclaw.json

Fügen Sie folgende Konfiguration ein:

{
  "gateway": {
    "port": 18789,
    "host": "0.0.0.0"
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "Ihr-Telegram-Bot-Token",
      "allowFrom": ["+41791234567"]
    }
  },
  "agents": {
    "default": {
      "provider": "anthropic",
      "model": "claude-sonnet-4",
      "apiKey": "sk-ant-xxx-xxx"
    }
  }
}

Schritt 7: Environment-Variablen setzen

# Environment-Datei erstellen
nano ~/.openclaw/.env

Inhalt:

ANTHROPIC_API_KEY=sk-ant-xxx-xxx-xxx
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrsTUVwxyz

Sicherheitstipp: Stellen Sie sicher, dass diese Dateien nur für root lesbar sind:

chmod 600 ~/.openclaw/openclaw.json
chmod 600 ~/.openclaw/.env

Schritt 8: OpenClaw als System-Dienst einrichten

Damit OpenClaw automatisch startet und nach einem Neustart wieder verfügbar ist, erstellen wir einen Systemd-Service:

# Systemd-Service-Datei erstellen
nano /etc/systemd/system/openclaw.service

Inhalt:

[Unit]
Description=OpenClaw Gateway
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/openclaw
Environment="NODE_ENV=production"
ExecStart=/usr/bin/node /opt/openclaw/dist/gateway.js
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Service aktivieren und starten:

# Service neu laden
systemctl daemon-reload

# OpenClaw aktivieren (Autostart)
systemctl enable openclaw

# OpenClaw starten
systemctl start openclaw

# Status prüfen
systemctl status openclaw

Schritt 9: Telegram Bot konfigurieren

1. BotFather kontaktieren: Öffnen Sie Telegram und suchen Sie nach @BotFather
2. Neuen Bot erstellen: Senden Sie /newbot und folgen Sie den Anweisungen
3. Bot-Token kopieren: Speichern Sie das Token in Ihrer Konfiguration
4. Webhook setzen (optional): Für bessere Latenz können Sie einen Webhook statt Long Polling verwenden

# Webhook setzen
curl -X POST "https://api.telegram.org/bot<IHR-BOT-TOKEN>/setWebhook?url=https://ihre-domain.com/webhook"

Schritt 10: Domain und SSL konfigurieren (optional)

Für eine professionelle Einrichtung sollten Sie eine Domain konfigurieren:

1. DNS einrichten: A-Record auf Ihre VPS-IP
2. SSL-Zertifikat erstellen: Mit Let's Encrypt

# Certbot installieren
apt install -y certbot python3-certbot-nginx

# Zertifikat erstellen
certbot certonly --standalone -d ihre-domain.com

# Automatische Erneuerung konfigurieren
certbot renew --dry-run

3. Nginx als Reverse Proxy (optional, für Load Balancing und Caching):

# Nginx installieren
apt install -y nginx

# Konfiguration erstellen
nano /etc/nginx/sites-available/openclaw

Inhalt:

server {
    listen 80;
    server_name ihre-domain.com;

    location / {
        proxy_pass http://localhost:18789;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

Dashboard und Monitoring

OpenClaw bietet ein Web-Dashboard für Monitoring und Konfiguration:

• Local Access: http://127.0.0.1:18789/ (vom Server)
• Remote Access: http://ihre-server-ip:18789/ (über SSH-Tunnel oder öffentlich wenn konfiguriert)

Monitoring implementieren

Für Produktionsumgebungen empfehle ich:

1. Alerting: Einrichten von Benachrichtigungen bei Problemen

Resource-Monitoring:

# CPU, RAM, Disk Auslastung
htop

Logs überwachen:

# OpenClaw Logs
journalctl -u openclaw -f

# FehlerLogs
journalctl -u openclaw -p err

Kostenaufstellung

Monatliche Kosten:

• VPS (Hetzner CX22): ~4,50 €
• Domain (optional): ~1-2 €/Monat
• Anthropic API: Nach Nutzung (typisch 5-20 €/Monat je nach Anwendungsfall)
• Total: ~10-30 €/Monat

Einmalkosten:

• Domain-Registrierung: ~10-15 €/Jahr
• SSL-Zertifikat: Kostenlos (Let's Encrypt)
• OpenClaw: Kostenlos (Open Source, MIT-Lizenz)

Vergleich mit SaaS-Lösungen:

Sicherheit und Best Practices

Security-Hardening:

Regelmässige Backups:

# Backup-Skript für Konfigurationen
tar -czf /backup/openclaw-$(date +%Y%m%d).tar.gz ~/.openclaw

Automatische Updates:

# Unattended upgrades
apt install -y unattended-upgrades
dpkg-reconfigure --priority=low unattended-upgrades

Firewall-Regeln:

# Nur HTTPS von überall, SSH nur von bestimmten IPs
ufw allow from Ihre-IP to any port 22
ufw allow 80/tcp
ufw allow 443/tcp

SSH-Zugriff beschränken:

# SSH nur für bestimmte IPs erlauben (in /etc/ssh/sshd_config)
AllowUsers ihr-username
PermitRootLogin no

Datenschutz:

• Keine Third-Party-Dienste: Ihre Daten verlassen Ihren Server nicht
• DSGVO-konform: Da Server in Deutschland steht
• Verschlüsselung: Alle Kommunikationen werden verschlüsselt
• Audit-Logs: Alle Aktivitäten werden protokolliert

Erweiterte Konfigurationen

Multi-Agent Setup:

OpenClaw unterstützt mehrere Agenten gleichzeitig:

{
  "agents": {
    "coding": {
      "provider": "anthropic",
      "model": "claude-sonnet-4",
      "apiKey": "sk-ant-xxx"
    },
    "translation": {
      "provider": "openai",
      "model": "gpt-4",
      "apiKey": "sk-open-xxx"
    }
  }
}

Channel-spezifische Konfigurationen:

{
  "channels": {
    "telegram": {
      "allowFrom": ["+41791234567"],
      "groups": {
        "*": { "requireMention": true }
      }
    },
    "whatsapp": {
      "allowFrom": ["+41791234567", "+41787654321"]
    }
  }
}

Fehlersuche und Troubleshooting

Häufige Probleme:

1. OpenClaw startet nicht

# Status prüfen
systemctl status openclaw

# Logs lesen
journalctl -u openclaw -n 50

2. Telegram Bot reagiert nicht

# Bot-Token prüfen
curl https://api.telegram.org/bot<IHR-TOKEN>/getMe

# Webhook-Status prüfen
curl https://api.telegram.org/bot<IHR-TOKEN>/getWebhookInfo

3. API-Fehler (Anthropic/OpenAI)

• API-Key prüfen
• Kreditkartenlimit bei Anthropic
• Netzwerkverbindung zum API-Endpunkt

4. Memory-Probleme

# RAM-Auslastung prüfen
free -h

# Node.js Memory-Limit erhöhen
export NODE_OPTIONS="--max-old-space-size=4096"

Scale-Up und Wachstum

Für wachsende Anwendungen:

1. Server-Upgrade: CX41 oder CX62 für mehr Rechenleistung
2. Load Balancing: Nginx mit Multi-Server-Setup
3. Database Integration: PostgreSQL oder MongoDB für persistente Sessions
4. Monitoring Stack: Prometheus + Grafana für Performance-Monitoring

Community und Support

Ressourcen:

• Offizielle Dokumentation: docs.openclaw.ai
• GitHub Repository: github.com/tell-a-friend/openclaw

Support-Angebot:

Bei synara bieten wir professionelle Unterstützung für:

• Installation und Konfiguration
• Custom-Development
• Monitoring und Wartung
• Schulungen für Teams

Kontaktieren Sie uns für eine unverbindliche Beratung!

Fazit

OpenClaw auf einem Hetzner VPS zu deployen, ist nicht nur machbar, sondern auch sehr kosteneffizient. Mit monatlich 10-30 € erhalten Sie:

✅ Vollständige Kontrolle über Ihre KI-Agenten
✅ 100% Datensouveränität
✅ Skalierbarkeit für wachsende Anforderungen
✅ Multi-Channel Support (Telegram, WhatsApp, Discord, etc.)
✅ Open Source und Community-getrieben

Für Privatpersonen und KMUs ist dies eine attraktive Alternative zu SaaS-Lösungen, die monatliche Gebühren verlangt und Ihnen die Kontrolle über Ihre Daten entzieht.

Nächste Schritte:

1. Hetzner Account erstellen und VPS deployen
2. Dieser Anleitung folgen und OpenClaw installieren
3. Erste Tests mit Ihrem persönlichen KI-Assistenten
4. Erweiterte Features bei Bedarf hinzufügen

💡 Pro-Tipp:

Starten Sie mit der minimalen Konfiguration (Telegram + ein Agent) und erweitern Sie schrittweise je nach Bedarf. OpenClaw ist modular aufgebaut – Sie müssen nicht alles auf einmal konfigurieren.

Dieser Artikel wurde mit Unterstützung von OpenClaw erstellt – ein self-hosted Gateway für KI-Agenten.