OpenClaw auf Render: Infrastructure as Code Deploy

Es ist immer das Gleiche: Du willst eine App deployen und verbringst die erste Stunde damit, Umgebungsvariablen in ein Web-Interface zu tippen. Wenn du später etwas ändern willst, weißt du nicht mehr genau, was du wo eingestellt hast. Das nervt und hält dich vom eigentlichen Programmieren ab.

Manuelle Setups sind fehleranfällig und schwer zu reproduzieren. Infrastructure as Code (IaC) löst dieses Problem, indem du deine Infrastruktur direkt in einer Datei definierst. So bleibt alles versioniert und du kannst deine gesamte Umgebung mit einem Klick wiederherstellen.

What You’ll Need

• Ein Render-Account (Free Tier ist verfügbar)
• Ein API-Key von deinem bevorzugten Model Provider

Quick Start

Deploye OpenClaw mit einem Klick über das Render Blueprint. Die enthaltene render.yaml definiert deinen gesamten Stack deklarativ – inklusive Service, Disk und Umgebungsvariablen.

Deploy to Render

Das passiert, wenn du auf diesen Link klickst:

1. Render erstellt einen neuen Service basierend auf dem render.yaml Blueprint aus diesem Repo.
2. Du wirst aufgefordert, ein SETUP_PASSWORD festzulegen.
3. Das Docker-Image wird gebaut und deployt.

Sobald der Vorgang abgeschlossen ist, erreichst du deinen Service unter https://<service-name>.onrender.com.

Understanding the Blueprint

Render Blueprints sind YAML-Dateien, die deine Infrastruktur beschreiben. 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

Diese Blueprint-Features werden genutzt:

Feature	Zweck
runtime: docker	Baut das Image direkt aus dem Dockerfile des Repos
healthCheckPath	Render prüft /health und startet defekte Instanzen neu
sync: false	Fragt den Wert während des Deployments ab (für Secrets)
generateValue: true	Erzeugt automatisch einen sicheren Token
disk	Permanenter Speicher, der Deployments überlebt

Choosing a plan

Plan	Spin-down	Disk	Best for
Free	Nach 15 Min Idle	Nicht verfügbar	Testing, Demos
Starter	Nie	1GB+	Personal use, kleine Teams
Standard+	Nie	1GB+	Production, mehrere Channels

Der Blueprint nutzt standardmäßig starter. Wenn du den Free Tier nutzen willst, ändere plan: free in deiner Kopie der render.yaml. Beachte dabei: Ohne Disk wird deine Konfiguration bei jedem Deployment zurückgesetzt.

After deployment

Setup-Wizard abschließen

1. Rufe https://<dein-service>.onrender.com/setup auf.
2. Gib dein SETUP_PASSWORD ein.
3. Wähle einen Model Provider und füge deinen API-Key ein.
4. Konfiguriere optional Messaging-Channels (Telegram, Discord, Slack).
5. Klicke auf Run setup.

Control UI aufrufen

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

Render Dashboard Features

Logs

Du findest Echtzeit-Logs unter Dashboard → dein Service → Logs. Du kannst filtern nach:

• Build-Logs (Erstellung des Docker-Images)
• Deploy-Logs (Start des Services)
• Runtime-Logs (Ausgaben der Applikation)

Shell-Zugriff

Für das Debugging kannst du eine Shell öffnen: Dashboard → dein Service → Shell. Die Disk ist unter /data gemountet.

Umgebungsvariablen

Du kannst Variablen unter Dashboard → dein Service → Environment anpassen. Änderungen lösen automatisch ein neues Deployment aus.

Backups und Migration

Du kannst deine Konfiguration und den Workspace jederzeit exportieren: https://<dein-service>.onrender.com/setup/export Dies lädt ein Backup herunter, das du auf jedem OpenClaw-Host wiederherstellen kannst.

Troubleshooting

Service startet nicht

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

• Fehlendes SETUP_PASSWORD – prüfe, ob es korrekt gesetzt wurde.
• Port-Fehler – stelle sicher, dass PORT=8080 mit dem Port im Dockerfile übereinstimmt.

Langsame Kaltstarts (Free Tier)

Services im Free Tier fahren nach 15 Minuten Inaktivität herunter. Der erste Request danach dauert einige Sekunden, während der Container startet. Nutze den Starter-Plan für “Always-on”.

Datenverlust nach Deployment

Das passiert im Free Tier, da keine Disk verfügbar ist. Upgrade auf einen bezahlten Plan oder exportiere deine Daten 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 scheitert, braucht der Service eventuell zu lange zum Starten. Prüfe:

• Build-Logs auf Fehler.
• Ob der Container lokal mit docker build && docker run funktioniert.

AI Setup Assistant

What’s Next

• Model Provider konfigurieren
• Messaging Channels verbinden
• Eigene Plugins entwickeln