Hosting

Render

Stellen Sie OpenClaw auf Render mithilfe des render.yaml-Blueprints des Repositorys bereit. Er definiert den Dienst, den Datenträger und die Umgebungsvariablen in einer einzigen Datei.

Voraussetzungen

Ein Render-Konto (kostenloser Tarif verfügbar)
Ein API-Schlüssel von Ihrem bevorzugten Modell-Provider

Bereitstellung

Auf Render bereitstellen

Dadurch wird ein Render-Dienst aus render.yaml erstellt, das Docker-Image gebaut und bereitgestellt. Ihre Dienst-URL folgt dem Muster https://<service-name>.onrender.com.

Der Blueprint

yaml

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 # generiert automatisch ein sicheres Token    disk:      name: openclaw-data      mountPath: /data      sizeGB: 1

Funktion	Zweck
`runtime: docker`	Erstellt das Image anhand des Dockerfiles des Repositorys
`healthCheckPath`	Render überwacht `/health` und startet fehlerhafte Instanzen neu
`generateValue: true`	Generiert automatisch einen kryptografisch sicheren Wert
`disk`	Persistenter Speicher, der erneute Bereitstellungen überdauert

Tarif auswählen

Tarif	Herunterfahren	Datenträger	Am besten geeignet für
Free	Nach 15 Min. Inaktivität	Nicht verfügbar	Tests, Demos
Starter	Nie	1GB+	Persönliche Nutzung, kleine Teams
Standard+	Nie	1GB+	Produktivbetrieb, mehrere Kanäle

Der Blueprint verwendet standardmäßig starter. Um den kostenlosen Tarif zu verwenden, ändern Sie plan: free in render.yaml Ihres Forks. Beachten Sie, dass der OpenClaw-Zustand ohne persistenten Datenträger bei jeder Bereitstellung zurückgesetzt wird.

Nach der Bereitstellung

Auf die Control UI zugreifen

Das Web-Dashboard ist unter https://<your-service>.onrender.com/ verfügbar. Stellen Sie die Verbindung mit dem gemeinsamen Geheimnis her: dem automatisch generierten OPENCLAW_GATEWAY_TOKEN (zu finden unter Dashboard → your service → Environment) oder Ihrem Passwort, falls Sie zur Passwortauthentifizierung gewechselt haben.

Protokolle

Dashboard → your service → Logs zeigt Build-Protokolle (Erstellung des Docker-Images), Bereitstellungsprotokolle (Dienststart) und Laufzeitprotokolle (Anwendungsausgabe).

Shell-Zugriff

Dashboard → your service → Shell öffnet eine Shell-Sitzung. Der persistente Datenträger ist unter /data eingehängt.

Umgebungsvariablen

Bearbeiten Sie Variablen unter Dashboard → your service → Environment. Änderungen lösen automatisch eine erneute Bereitstellung aus.

Automatische Bereitstellung

Render stellt automatisch erneut bereit, wenn der Branch des verbundenen Repositorys einen neuen Commit erhält. Wenn Sie direkt von openclaw/openclaw statt von Ihrem eigenen Fork bereitgestellt haben, besitzen Sie keinen Push-Zugriff, um dies auszulösen. Aktualisieren Sie daher über eine manuelle Blueprint-Synchronisierung im Dashboard oder richten Sie den Dienst auf Ihren eigenen Fork aus.

Benutzerdefinierte Domain

Dashboard → your service → Settings → Custom Domains
Fügen Sie Ihre Domain hinzu
Konfigurieren Sie DNS wie angewiesen (CNAME auf *.onrender.com)
Render stellt automatisch ein TLS-Zertifikat bereit

Skalierung

Vertikal: Wechseln Sie den Tarif, um mehr CPU/RAM zu erhalten. Dies ist für OpenClaw normalerweise ausreichend.
Horizontal: Erhöhen Sie die Anzahl der Instanzen (Standard-Tarif und höher). Erfordert Sticky Sessions oder eine externe Zustandsverwaltung, da OpenClaw den Laufzeitzustand auf dem lokalen Datenträger speichert.

Sicherungen und Migration

Exportieren Sie über die Shell im Render Dashboard jederzeit Zustand, Konfiguration, Authentifizierungsprofile und Arbeitsbereich:

bash

openclaw backup create

Dadurch wird ein portierbares Sicherungsarchiv erstellt. Siehe Sicherung.

Fehlerbehebung

Dienst startet nicht

Prüfen Sie die Bereitstellungsprotokolle im Render Dashboard. Häufige Probleme:

Fehlendes OPENCLAW_GATEWAY_TOKEN – prüfen Sie, ob es unter Dashboard → Environment festgelegt ist
Portabweichung – stellen Sie OPENCLAW_GATEWAY_PORT=8080 sicher, damit das Gateway an den von Render erwarteten Port gebunden wird

Langsame Kaltstarts (kostenloser Tarif)

Dienste im kostenlosen Tarif werden nach 15 Minuten Inaktivität heruntergefahren. Die erste Anfrage nach dem Herunterfahren dauert einige Sekunden, während der Container startet. Wechseln Sie für einen durchgehenden Betrieb zum Starter-Tarif.

Datenverlust nach erneuter Bereitstellung

Dies tritt im kostenlosen Tarif auf (kein persistenter Datenträger). Wechseln Sie zu einem kostenpflichtigen Tarif oder exportieren Sie regelmäßig über die Render-Shell mit openclaw backup create eine Sicherung.

Fehler bei der Zustandsprüfung

Wenn Builds erfolgreich sind, aber Bereitstellungen fehlschlagen, benötigt der Dienst möglicherweise zu lange zum Starten oder /health ist möglicherweise nicht erreichbar. Prüfen Sie:

Build-Protokolle auf Fehler
Ob der Container lokal mit docker build && docker run ausgeführt wird

Nächste Schritte

Richten Sie Messaging-Kanäle ein: Kanäle
Konfigurieren Sie das Gateway: Gateway-Konfiguration
Halten Sie OpenClaw auf dem neuesten Stand: Aktualisieren

Was this useful?