OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Hosting

DigitalOcean

Betreiben Sie einen persistenten OpenClaw Gateway auf einem DigitalOcean Droplet (ca. 6 USD/Monat für den Basic-Tarif mit 1 GB).

DigitalOcean bietet einen unkomplizierten, kostenpflichtigen VPS-Weg. Für günstigere oder kostenlose Optionen:

  • Hetzner -- mehr Kerne/RAM pro Dollar.
  • Oracle Cloud -- dauerhaft kostenloser ARM-Tarif (bis zu 4 OCPU, 24 GB RAM), die Registrierung kann jedoch problematisch sein und es wird ausschließlich ARM unterstützt.

Voraussetzungen

  • DigitalOcean-Konto (registrieren)
  • SSH-Schlüsselpaar (oder die Bereitschaft, die Passwortauthentifizierung zu verwenden)
  • Etwa 20 Minuten

Einrichtung

  • Droplet erstellen

    1. Melden Sie sich bei DigitalOcean an.
    2. Klicken Sie auf Create > Droplets.
    3. Wählen Sie:
      • Region: Die Ihnen nächstgelegene Region
      • Image: Ubuntu 24.04 LTS
      • Size: Basic, Regular, 1 vCPU / 1 GB RAM / 25 GB SSD
      • Authentication: SSH key (empfohlen) oder Password
    4. Klicken Sie auf Create Droplet und notieren Sie sich die IP-Adresse.

  • Verbinden und installieren

    bash
    ssh root@YOUR_DROPLET_IP apt update && apt upgrade -y # Install Node.js 24curl -fsSL https://deb.nodesource.com/setup_24.x | bash -apt install -y nodejs # Install OpenClawcurl -fsSL https://openclaw.ai/install.sh | bash # Create the non-root user that will own OpenClaw state and services.adduser openclawusermod -aG sudo openclawloginctl enable-linger openclaw su - openclawopenclaw --version

    Verwenden Sie die Root-Shell ausschließlich für die initiale Systemeinrichtung. Führen Sie OpenClaw-Befehle als Nicht-Root-Benutzer openclaw aus, damit der Zustand unter /home/openclaw/.openclaw/ gespeichert und der Gateway als systemd---user-Dienst dieses Benutzers installiert wird.

  • Einrichtungsassistenten ausführen

    bash
    openclaw onboard --install-daemon

    Der Assistent führt Sie durch die Modellauthentifizierung, die Kanaleinrichtung, die Generierung des Gateway-Tokens und die Installation des Daemons (systemd-Benutzerdienst).

  • Swap hinzufügen (für Droplets mit 1 GB empfohlen)

    bash
    fallocate -l 2G /swapfilechmod 600 /swapfilemkswap /swapfileswapon /swapfileecho '/swapfile none swap sw 0 0' >> /etc/fstab

  • Gateway überprüfen

    bash
    openclaw statussystemctl --user status openclaw-gateway.servicejournalctl --user -u openclaw-gateway.service -f

  • Auf die Bedienoberfläche zugreifen

    Der Gateway bindet sich standardmäßig an local loopback. Wählen Sie eine der folgenden Optionen.

    Option A: SSH-Tunnel (am einfachsten)

    bash
    # From your local machinessh -L 18789:localhost:18789 root@YOUR_DROPLET_IP

    Öffnen Sie anschließend http://localhost:18789.

    Option B: Tailscale Serve

    bash
    curl -fsSL https://tailscale.com/install.sh | sudo shsudo tailscale upopenclaw config set gateway.tailscale.mode serveopenclaw gateway restart

    Öffnen Sie anschließend https://<magicdns>/ auf einem beliebigen Gerät in Ihrem Tailnet.

    Tailscale Serve authentifiziert den Datenverkehr der Bedienoberfläche und WebSocket-Datenverkehr über Tailnet-Identitäts-Header. Dabei wird vorausgesetzt, dass der Gateway-Host selbst vertrauenswürdig ist. HTTP-API-Endpunkte verwenden unabhängig davon weiterhin den normalen Authentifizierungsmodus des Gateways (Token/Passwort). Um über Serve ausdrücklich gemeinsame geheime Zugangsdaten zu verlangen, legen Sie gateway.auth.allowTailscale: false fest und verwenden Sie gateway.auth.mode: "token" oder "password".

    Option C: Tailnet-Bindung (ohne Serve)

    bash
    openclaw config set gateway.bind tailnetopenclaw gateway restart

    Öffnen Sie anschließend http://<tailscale-ip>:18789 (Token erforderlich).

    • Persistenz und Sicherungen

    Der OpenClaw-Zustand befindet sich unter:

    • ~/.openclaw/ -- openclaw.json, Kanal-/Provider-Zugangsdaten, agentenspezifische auth-profiles.json-Dateien und Sitzungsdaten.
    • ~/.openclaw/workspace/ -- der Agenten-Arbeitsbereich (SOUL.md, Speicher, Artefakte).

    Diese Daten bleiben bei Neustarts des Droplets erhalten. So erstellen Sie eine portable Momentaufnahme:

    bash
    openclaw backup create

    DigitalOcean-Momentaufnahmen sichern das gesamte Droplet; openclaw backup create ist zwischen Hosts übertragbar.

    Tipps für 1 GB RAM

    Das 6-Dollar-Droplet verfügt nur über 1 GB RAM. So gewährleisten Sie einen reibungslosen Betrieb:

    • Stellen Sie sicher, dass der obige Swap-Schritt in /etc/fstab eingetragen ist, damit Swap auch nach Neustarts aktiv bleibt.
    • Bevorzugen Sie API-basierte Modelle (Claude, GPT) gegenüber lokalen Modellen -- lokale LLM-Inferenz ist mit 1 GB nicht möglich.
    • Legen Sie für agents.defaults.model.primary ein kleineres Modell fest, wenn bei großen Prompts Speicherüberschreitungen auftreten.
    • Überwachen Sie das System mit free -h und htop.

    Fehlerbehebung

    Gateway startet nicht -- Führen Sie openclaw doctor --non-interactive aus und prüfen Sie die Protokolle mit journalctl --user -u openclaw-gateway.service -n 50.

    Port wird bereits verwendet -- Führen Sie lsof -i :18789 aus, um den Prozess zu ermitteln, und beenden Sie ihn anschließend.

    Nicht genügend Arbeitsspeicher -- Prüfen Sie mit free -h, ob Swap aktiv ist. Wenn weiterhin Speicherüberschreitungen auftreten, wechseln Sie von lokalen Modellen zu API-basierten Modellen (Claude, GPT) oder führen Sie ein Upgrade auf ein Droplet mit 2 GB durch.

    Nächste Schritte

    Verwandte Themen

    Was this useful?
    On this page

    On this page