Migrationsanleitung

Wechsel zwischen Self-Hosting und ClawHosters

Wenn du mit einer Hosting-Option gestartet hast und wechseln möchtest, beschreibt diese Anleitung den Prozess in beide Richtungen. Die größte Herausforderung ist der Transfer deiner Konfiguration und Gesprächsdaten, ohne etwas zu verlieren.

Von Self-Hosting zu ClawHosters

Schritt 1: Konfiguration exportieren

Bevor du eine ClawHosters-Instanz erstellst, sammle dein aktuelles Setup:

1. Kopiere deine openclaw.json-Konfigurationsdatei
2. Notiere deine aktuellen LLM-Anbieter- und Modelleinstellungen
3. Exportiere alle installierten benutzerdefinierten Skills oder Plugins
4. Sichere den Inhalt deines Datenvolumes

# Konfiguration aus der selbst gehosteten Instanz kopieren
docker cp openclaw:/app/openclaw.json ./openclaw-backup.json

# Datenvolume sichern
docker run --rm -v openclaw_data:/data -v $(pwd):/backup alpine tar czf /backup/openclaw-data.tar.gz /data

Schritt 2: ClawHosters-Instanz erstellen

1. Melde dich auf clawhosters.com an
2. Erstelle eine neue Instanz mit deinem bevorzugten Tier
3. Warte, bis die Bereitstellung abgeschlossen ist (unter einer Minute)

Schritt 3: LLM-Konfiguration wählen

Du hast zwei Optionen für LLM-Zugang auf ClawHosters:

Verwaltete Tiers (Eco, Standard, Premium): Keine Konfiguration nötig. ClawHosters übernimmt API-Schlüssel und Abrechnung.

BYOK (Bring Your Own Key): Gib deinen vorhandenen API-Schlüssel im Dashboard ein. Die Instanz verbindet sich direkt mit deinem Anbieter.

Schritt 4: Konfiguration übertragen

Nachdem deine Instanz läuft:

1. Öffne die Web-Oberfläche unter der Adresse deiner Instanz auf Port 8080
2. Übernimm deine openclaw.json-Einstellungen über die Gateway-Oberfläche
3. Installiere benutzerdefinierte Skills oder Plugins neu

Schritt 5: Kanäle einrichten

Wenn du Telegram oder WhatsApp genutzt hast:

1. Gehe zum Bereich Kanalkopplung im ClawHosters-Dashboard
2. Folge dem Kopplungsablauf für jeden Kanal
3. Aktualisiere die Webhook-URL deines Bots auf die neue Instanz

Hinweis: Du musst Kanäle neu koppeln, da sich die Webhook-URLs ändern, wenn sich die Serveradresse ändert.

Schritt 6: Prüfen und stilllegen

1. Teste die neue Instanz über die Web-Oberfläche
2. Teste jeden gekoppelten Kanal
3. Sobald alles funktioniert, fahre deine selbst gehostete Instanz herunter

Von ClawHosters zu Self-Hosting

Schritt 1: Server vorbereiten

Richte einen Server mit folgenden Anforderungen ein:

• Linux-Server (Ubuntu 22.04+ empfohlen)
• Docker und docker-compose installiert
• Mindestens 2 vCPU und 4 GB RAM
• Firewall konfiguriert (SSH + dein gewählter Web-Port)

Schritt 2: Von ClawHosters exportieren

Wenn du SSH-Zugang zu deiner ClawHosters-Instanz hast:

# Per SSH mit deiner Instanz verbinden (Zugang über das Dashboard anfordern, falls nötig)
ssh root@deine-instanz-ip

# Konfiguration kopieren
docker cp openclaw:/app/openclaw.json /tmp/openclaw.json

# Datenvolume sichern
docker run --rm -v openclaw_data:/data -v /tmp:/backup alpine tar czf /backup/openclaw-data.tar.gz /data

Wenn du keinen SSH-Zugang hast, exportiere deine Konfiguration über die Web-Oberfläche und notiere deine Einstellungen manuell.

Schritt 3: Docker auf deinem Server einrichten

Erstelle eine docker-compose.yml basierend auf der Docker-Konfigurationsreferenz:

version: "3.8"
services:
  openclaw:
    image: ghcr.io/phioranex/openclaw-docker:latest
    ports:
      - "8080:18789"
    volumes:
      - openclaw_data:/data
    environment:
      - OPENCLAW_GATEWAY_MODE=local
    command: gateway --allow-unconfigured --bind lan
    restart: unless-stopped

volumes:
  openclaw_data:

Schritt 4: Daten importieren

# Container starten
docker-compose up -d

# Falls du ein Datenbackup hast, stelle es wieder her
docker run --rm -v openclaw_data:/data -v $(pwd):/backup alpine tar xzf /backup/openclaw-data.tar.gz -C /

# Konfiguration in den Container kopieren
docker cp openclaw.json openclaw:/app/openclaw.json

# Neustart zum Übernehmen
docker-compose restart

Schritt 5: LLM-Zugang konfigurieren

Für Self-Hosting brauchst du eigene API-Schlüssel:

1. Besorge einen API-Schlüssel von deinem bevorzugten LLM-Anbieter
2. Füge ihn zu deiner openclaw.json oder den Umgebungsvariablen hinzu
3. Siehe die Umgebungsvariablen-Referenz für Konfigurationsoptionen

Schritt 6: Kanäle einrichten

Konfiguriere alle Messaging-Kanäle neu:

• Telegram: Erstelle einen neuen Bot oder aktualisiere die Webhook-URL auf die Adresse deines Servers
• WhatsApp: Aktualisiere die Webhook-Konfiguration auf deinen Server

Schritt 7: ClawHosters kündigen

Sobald alles auf deinem selbst gehosteten Setup funktioniert:

1. Überprüfe, dass alle Kanäle antworten
2. Teste die Web-Oberfläche
3. Pausiere oder lösche deine ClawHosters-Instanz über das Dashboard

Was wird übertragen und was nicht

Ausfallzeit einplanen

Während der Migration gibt es eine Periode, in der dein Assistent nicht verfügbar ist:

Geschätzte Ausfallzeit: - Self-Hosting zu ClawHosters: 5-15 Minuten (hauptsächlich Kanal-Neukopplung) - ClawHosters zu Self-Hosting: 30-60 Minuten (Server-Einrichtung + Konfiguration)

Um die Ausfallzeit zu minimieren: 1. Richte die neue Instanz zuerst ein, ohne Kanäle umzuschalten 2. Teste die neue Instanz über die Web-Oberfläche 3. Schalte Kanäle erst um, nachdem die neue Instanz bestätigt funktioniert 4. Der Kanalwechsel selbst dauert unter einer Minute

Fehlerbehebung bei Migrationsproblemen

Container startet nach Datenimport nicht: Überprüfe, ob die Datenvolume-Pfade zwischen Quelle und Ziel übereinstimmen. Der Volume-Mount-Pfad muss identisch sein.

Konfiguration wird nicht übernommen: Stelle sicher, dass openclaw.json am richtigen Ort innerhalb des Containers liegt. Verwende docker exec openclaw cat /app/openclaw.json zur Bestätigung.

Kanäle empfangen keine Nachrichten: Webhook-URLs müssen auf die Adresse des neuen Servers zeigen. Prüfe, ob deine Firewall eingehenden Verkehr auf dem Web-Port erlaubt.

Verwandte Dokumentation

• Self-Hosting vs. ClawHosters -- Hosting-Optionen vergleichen
• Docker-Konfigurationsreferenz -- Details zur Container-Einrichtung
• Umgebungsvariablen -- Konfigurationsreferenz
• Architekturübersicht -- Wie ClawHosters intern funktioniert