Zum Hauptinhalt springen
OpenClaw mit Infrastructure as Code auf Render bereitstellen. Der enthaltene Blueprint render.yaml definiert Ihren gesamten Stack deklarativ — Service, Datenträger, Umgebungsvariablen — sodass Sie mit einem einzigen Klick bereitstellen und Ihre Infrastruktur zusammen mit Ihrem Code versionieren können.

​
Voraussetzungen

​
Mit einem Render Blueprint bereitstellen

Auf Render bereitstellen Ein Klick auf diesen Link wird:
  1. Einen neuen Render-Service aus dem Blueprint render.yaml im Stammverzeichnis dieses Repository erstellen.
  2. Das Docker-Image bauen und bereitstellen
Nach der Bereitstellung folgt Ihre Service-URL dem Muster https://<service-name>.onrender.com.

​
Den Blueprint verstehen

Render Blueprints sind YAML-Dateien, die Ihre Infrastruktur definieren. Das render.yaml in diesem Repository konfiguriert alles, was zum Ausführen von OpenClaw erforderlich ist: 
services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: OPENCLAW_GATEWAY_PORT
        value: "8080"
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true # erzeugt automatisch ein sicheres Token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1
Verwendete zentrale Blueprint-Funktionen:
FunktionZweck
runtime: dockerBaut aus dem Dockerfile des Repository
healthCheckPathRender überwacht /health und startet ungesunde Instanzen neu
generateValue: trueErzeugt automatisch einen kryptografisch sicheren Wert
diskPersistenter Speicher, der erneute Bereitstellungen überlebt

​
Einen Plan auswählen

PlanHerunterfahrenDatenträgerAm besten geeignet für
FreeNach 15 Min. InaktivitätNicht verfügbarTests, Demos
StarterNiemals1GB+Persönliche Nutzung, kleine Teams
Standard+Niemals1GB+Produktion, mehrere Kanäle
Der Blueprint verwendet standardmäßig starter. Um den Free Tier zu verwenden, ändern Sie plan: free in render.yaml Ihres Forks (beachten Sie jedoch: ohne persistenten Datenträger wird der OpenClaw-Zustand bei jeder Bereitstellung zurückgesetzt).

​
Nach der Bereitstellung

​
Auf die Control UI zugreifen

Das Web-Dashboard ist verfügbar unter https://<your-service>.onrender.com/. Verbinden Sie sich mit dem konfigurierten Shared Secret. Diese Bereitstellungsvorlage erzeugt OPENCLAW_GATEWAY_TOKEN automatisch (zu finden unter Dashboard → Ihr Service → Environment); wenn Sie es durch Passwortauthentifizierung ersetzen, verwenden Sie stattdessen dieses Passwort.

​
Funktionen des Render-Dashboards

​
Logs

Echtzeit-Logs anzeigen unter Dashboard → Ihr Service → Logs. Filtern nach:
  • Build-Logs (Erstellung des Docker-Images)
  • Deploy-Logs (Service-Start)
  • Laufzeit-Logs (Anwendungsausgabe)

​
Shell-Zugriff

Für Debugging öffnen Sie eine Shell-Sitzung über Dashboard → Ihr Service → Shell. Der persistente Datenträger ist unter /data eingehängt.

​
Umgebungsvariablen

Variablen unter Dashboard → Ihr Service → Environment ändern. Änderungen lösen automatisch eine erneute Bereitstellung aus.

​
Auto-deploy

Wenn Sie das ursprüngliche OpenClaw-Repository verwenden, führt Render keine automatische Bereitstellung Ihres OpenClaw aus. Um es zu aktualisieren, führen Sie im Dashboard eine manuelle Blueprint-Synchronisierung aus.

​
Benutzerdefinierte Domain

  1. Zu Dashboard → Ihr Service → Settings → Custom Domains gehen
  2. Ihre Domain hinzufügen
  3. DNS wie angewiesen konfigurieren (CNAME auf *.onrender.com)
  4. Render stellt automatisch ein TLS-Zertifikat bereit

​
Skalierung

Render unterstützt horizontale und vertikale Skalierung:
  • Vertikal: Plan ändern, um mehr CPU/RAM zu erhalten
  • Horizontal: Instanzanzahl erhöhen (Standard-Plan und höher)
Für OpenClaw ist vertikale Skalierung in der Regel ausreichend. Horizontale Skalierung erfordert Sticky Sessions oder externes Zustandsmanagement.

​
Backups und Migration

Exportieren Sie Ihren Zustand, die Konfiguration, Auth-Profile und den Workspace jederzeit über den Shell-Zugriff im Render-Dashboard: 
openclaw backup create
Dadurch wird ein portables Backup-Archiv mit dem OpenClaw-Zustand plus jedem konfigurierten Workspace erstellt. Siehe Backup für Details.

​
Fehlerbehebung

​
Service startet nicht

Prüfen Sie die Deploy-Logs im Render-Dashboard. Häufige Probleme:
  • Fehlendes OPENCLAW_GATEWAY_TOKEN — prüfen Sie, ob es unter Dashboard → Environment gesetzt ist
  • Port-Mismatch — stellen Sie sicher, dass OPENCLAW_GATEWAY_PORT=8080 gesetzt ist, damit das Gateway an den von Render erwarteten Port bindet

​
Langsame Cold Starts (Free Tier)

Services im Free Tier werden nach 15 Minuten Inaktivität heruntergefahren. Die erste Anfrage nach dem Herunterfahren dauert einige Sekunden, während der Container startet. Wechseln Sie zum Starter-Plan für dauerhaften Betrieb.

​
Datenverlust nach erneuter Bereitstellung

Das passiert im Free Tier (kein persistenter Datenträger). Wechseln Sie zu einem kostenpflichtigen Plan oder exportieren Sie regelmäßig ein vollständiges Backup über openclaw backup create in der Render-Shell.

​
Fehler bei der Zustandsprüfung

Render erwartet innerhalb von 30 Sekunden eine 200-Antwort von /health. Wenn Builds erfolgreich sind, Bereitstellungen aber fehlschlagen, braucht der Service möglicherweise zu lange zum Starten. Prüfen Sie:
  • Build-Logs auf Fehler
  • Ob der Container lokal mit docker build && docker run läuft

​
Nächste Schritte