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 Ihres bevorzugten Modell-Providers
Bereitstellung
Dadurch wird aus render.yaml ein Render-Dienst erstellt, das Docker-Image gebaut und bereitgestellt. Ihre Dienst-URL entspricht dem Muster https://<service-name>.onrender.com.
Der Blueprint
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 aus dem Dockerfile 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+ | Produktion, 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-Status bei jeder Bereitstellung zurückgesetzt wird, wenn kein persistenter Datenträger vorhanden ist.
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 (Start des Dienstes) 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 führt automatisch eine erneute Bereitstellung durch, wenn der Branch des verbundenen Repositorys einen neuen Commit erhält. Wenn Sie direkt aus openclaw/openclaw statt aus 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 verknüpfen Sie den Dienst mit Ihrem eigenen Fork.
Benutzerdefinierte Domain
- Dashboard → your service → Settings → Custom Domains
- Fügen Sie Ihre Domain hinzu
- Konfigurieren Sie DNS gemäß den Anweisungen (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). Dies erfordert Sticky Sessions oder eine externe Statusverwaltung, da OpenClaw den Laufzeitstatus auf dem lokalen Datenträger speichert.
Sicherungen und Migration
Exportieren Sie Status, Konfiguration, Authentifizierungsprofile und Arbeitsbereich jederzeit über die Shell im Render-Dashboard:
openclaw backup createDadurch wird ein portables Sicherungsarchiv erstellt. Siehe Sicherung.
Fehlerbehebung
Dienst startet nicht
Prüfen Sie die Bereitstellungsprotokolle im Render-Dashboard. Häufige Probleme:
- Fehlendes
OPENCLAW_GATEWAY_TOKEN– überprüfen Sie unter Dashboard → Environment, ob es festgelegt ist - Port stimmt nicht überein – stellen Sie
OPENCLAW_GATEWAY_PORT=8080sicher, damit das Gateway den von Render erwarteten Port verwendet
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 dauerhaft aktiven Dienst zum Starter-Tarif.
Datenverlust nach erneuter Bereitstellung
Dies geschieht beim kostenlosen Tarif (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.
Fehlgeschlagene Integritätsprüfungen
Wenn Builds erfolgreich sind, Bereitstellungen jedoch fehlschlagen, benötigt der Dienst möglicherweise zu lange zum Starten oder /health ist möglicherweise nicht erreichbar. Prüfen Sie:
- Die Build-Protokolle auf Fehler
- Ob der Container lokal mit
docker build && docker runausgefü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: Aktualisierung