Deployment auf Render | Docs

OpenClaw lässt sich auf Render per Infrastructure as Code deployen. Die mitgelieferte render.yaml-Blueprint-Datei beschreibt deinen gesamten Stack deklarativ — Service, Disk, Umgebungsvariablen — sodass du mit einem einzigen Klick deployen und deine Infrastruktur direkt im Repository versionieren kannst.

Voraussetzungen

Ein Render-Konto (kostenloser Tarif verfügbar)
Ein API-Key von deinem bevorzugten Model-Provider

Deployment per Render Blueprint

Deploy to Render

Wenn du auf diesen Link klickst, passiert Folgendes:

Render erstellt einen neuen Service aus der render.yaml-Blueprint-Datei im Root des Repositorys.
Du wirst aufgefordert, dein SETUP_PASSWORD festzulegen.
Das Docker-Image wird gebaut und deployed.

Nach dem Deployment folgt deine Service-URL dem Muster https://<service-name>.onrender.com.

Den Blueprint verstehen

Render Blueprints sind YAML-Dateien, die deine Infrastruktur definieren. Die render.yaml in diesem Repository konfiguriert alles, was für den Betrieb von OpenClaw nötig ist:

services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: PORT
        value: "8080"
      - key: SETUP_PASSWORD
        sync: false # prompts during deploy
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true # auto-generates a secure token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1

Wichtige Blueprint-Features im Überblick:

Feature	Zweck
`runtime: docker`	Baut aus dem Dockerfile im Repository
`healthCheckPath`	Render überwacht `/health` und startet ungesunde Instanzen neu
`sync: false`	Fragt den Wert beim Deployment ab (für Secrets)
`generateValue: true`	Generiert automatisch einen kryptographisch sicheren Wert
`disk`	Persistenter Speicher, der Redeploys überlebt

Den richtigen Tarif wählen

Tarif	Spin-down	Disk	Am besten für
Free	Nach 15 Min. Inaktivität	Nicht verfügbar	Testen, Demos
Starter	Nie	Ab 1 GB	Persönliche Nutzung, kleine Teams
Standard+	Nie	Ab 1 GB	Produktion, mehrere Kanäle

Der Blueprint setzt standardmäßig starter. Für den kostenlosen Tarif änderst du plan: free in der render.yaml deines Forks — aber Achtung: ohne persistente Disk wird die Konfiguration bei jedem Deployment zurückgesetzt.

Nach dem Deployment

Einrichtungsassistent abschließen

Öffne https://<dein-service>.onrender.com/setup
Gib dein SETUP_PASSWORD ein
Wähle einen Model-Provider und füge deinen API-Key ein
Optional: Messaging-Kanäle konfigurieren (Telegram, Discord, Slack)
Klick auf Run setup

Control UI öffnen

Das Web-Dashboard erreichst du unter https://<dein-service>.onrender.com/openclaw.

Render-Dashboard-Features

Logs

Echtzeit-Logs findest du unter Dashboard → dein Service → Logs. Filtere nach:

Build-Logs (Docker-Image-Erstellung)
Deploy-Logs (Service-Start)
Runtime-Logs (Anwendungsausgaben)

Shell-Zugang

Zum Debuggen kannst du eine Shell-Session öffnen über Dashboard → dein Service → Shell. Die persistente Disk ist unter /data gemountet.

Umgebungsvariablen

Variablen änderst du unter Dashboard → dein Service → Environment. Änderungen lösen automatisch ein Redeploy aus.

Auto-Deploy

Wenn du das originale OpenClaw-Repository nutzt, führt Render kein automatisches Redeploy durch. Um zu aktualisieren, starte manuell einen Blueprint Sync über das Dashboard.

Eigene Domain

Geh zu Dashboard → dein Service → Settings → Custom Domains
Füge deine Domain hinzu
Konfiguriere DNS wie angewiesen (CNAME auf *.onrender.com)
Render stellt automatisch ein TLS-Zertifikat aus

Skalierung

Render unterstützt horizontale und vertikale Skalierung:

Vertikal: Tarif wechseln für mehr CPU/RAM
Horizontal: Instanzanzahl erhöhen (ab Standard-Tarif)

Für OpenClaw reicht in der Regel vertikale Skalierung. Horizontale Skalierung erfordert Sticky Sessions oder externes State-Management.

Backups und Migration

Exportiere deine Konfiguration und deinen Workspace jederzeit:

https://<dein-service>.onrender.com/setup/export

Das lädt ein portables Backup herunter, das du auf jedem anderen OpenClaw-Host wiederherstellen kannst.

Problembehandlung

Service startet nicht

Prüfe die Deploy-Logs im Render-Dashboard. Häufige Ursachen:

SETUP_PASSWORD fehlt — der Blueprint fragt danach, aber überprüfe sicherheitshalber, ob es gesetzt ist
Port-Konflikt — stelle sicher, dass PORT=8080 mit dem im Dockerfile freigegebenen Port übereinstimmt

Langsame Kaltstarts (kostenloser Tarif)

Services im kostenlosen Tarif werden nach 15 Minuten Inaktivität heruntergefahren. Die erste Anfrage danach dauert ein paar Sekunden, bis der Container wieder hochgefahren ist. Ein Upgrade auf den Starter-Tarif sorgt für dauerhaften Betrieb.

Datenverlust nach Redeploy

Das passiert im kostenlosen Tarif (keine persistente Disk). Upgrade auf einen bezahlten Tarif oder exportiere deine Konfiguration regelmäßig über /setup/export.

Health-Check-Fehler

Render erwartet innerhalb von 30 Sekunden eine 200-Antwort von /health. Wenn der Build klappt, aber das Deployment fehlschlägt, braucht der Service möglicherweise zu lange zum Starten. Prüfe:

Die Build-Logs auf Fehler
Ob der Container lokal läuft mit docker build && docker run