Deployen op Render | Docs

Deploy OpenClaw op Render met Infrastructure as Code. De meegeleverde render.yaml Blueprint definieert je volledige stack declaratief — service, disk, omgevingsvariabelen — zodat je met een klik kunt deployen en je infrastructuur naast je code kunt beheren.

Vereisten

Een Render-account (gratis tier beschikbaar)
Een API-sleutel van de modelprovider van je keuze

Deployen met een Render Blueprint

Deploy to Render

Door op deze link te klikken:

Wordt er een nieuwe Render-service aangemaakt op basis van de render.yaml Blueprint in de root van deze repo.
Word je gevraagd om SETUP_PASSWORD in te stellen.
Wordt de Docker-image gebuild en gedeployed.

Na het deployen volgt je service-URL het patroon https://<service-naam>.onrender.com.

De Blueprint begrijpen

Render Blueprints zijn YAML-bestanden die je infrastructuur beschrijven. De render.yaml in deze repository configureert alles wat nodig is om OpenClaw te draaien:

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

Belangrijke Blueprint-features:

Feature	Doel
`runtime: docker`	Bouwt vanaf de Dockerfile in de repo
`healthCheckPath`	Render bewaakt `/health` en herstart ongezonde instanties
`sync: false`	Vraagt om de waarde tijdens het deployen (voor secrets)
`generateValue: true`	Genereert automatisch een cryptografisch veilige waarde
`disk`	Persistente opslag die herdeployments overleeft

Een plan kiezen

Plan	Spin-down	Disk	Geschikt voor
Free	Na 15 min inactief	Niet beschikbaar	Testen, demo’s
Starter	Nooit	1GB+	Persoonlijk gebruik, kleine teams
Standard+	Nooit	1GB+	Productie, meerdere kanalen

De Blueprint staat standaard op starter. Wil je de gratis tier gebruiken, wijzig dan plan: free in de render.yaml van je fork. Let op: zonder persistente disk wordt je configuratie bij elke deploy gereset.

Na het deployen

De configuratiewizard doorlopen

Ga naar https://<jouw-service>.onrender.com/setup
Voer je SETUP_PASSWORD in
Kies een modelprovider en plak je API-sleutel
Configureer optioneel berichtkanalen (Telegram, Discord, Slack)
Klik op Run setup

De Control UI openen

Het webdashboard vind je op https://<jouw-service>.onrender.com/openclaw.

Render Dashboard-features

Logs

Bekijk realtime logs via Dashboard → jouw service → Logs. Filter op:

Build-logs (Docker-image wordt gebouwd)
Deploy-logs (service start op)
Runtime-logs (applicatie-output)

Shell-toegang

Voor debugging kun je een shell-sessie openen via Dashboard → jouw service → Shell. De persistente disk is gemount op /data.

Omgevingsvariabelen

Pas variabelen aan via Dashboard → jouw service → Environment. Wijzigingen triggeren automatisch een herdeployment.

Auto-deploy

Als je de originele OpenClaw-repository gebruikt, deployt Render niet automatisch. Om te updaten voer je een handmatige Blueprint-sync uit vanuit het dashboard.

Eigen domein

Ga naar Dashboard → jouw service → Settings → Custom Domains
Voeg je domein toe
Configureer DNS zoals aangegeven (CNAME naar *.onrender.com)
Render regelt automatisch een TLS-certificaat

Schalen

Render ondersteunt zowel horizontaal als verticaal schalen:

Verticaal: Kies een hoger plan voor meer CPU/RAM
Horizontaal: Verhoog het aantal instanties (Standard-plan en hoger)

Voor OpenClaw is verticaal schalen meestal voldoende. Horizontaal schalen vereist sticky sessions of extern state-management.

Back-ups en migratie

Exporteer je configuratie en workspace wanneer je wilt:

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

Dit downloadt een draagbare back-up die je op elke OpenClaw-host kunt herstellen.

Problemen oplossen

Service start niet op

Bekijk de deploy-logs in het Render Dashboard. Veelvoorkomende oorzaken:

SETUP_PASSWORD ontbreekt — de Blueprint vraagt hierom, maar controleer of het daadwerkelijk is ingesteld
Poort komt niet overeen — zorg dat PORT=8080 overeenkomt met de poort in de Dockerfile

Trage cold starts (gratis tier)

Services op de gratis tier worden na 15 minuten inactiviteit stopgezet. Het eerste verzoek na een spin-down duurt een paar seconden terwijl de container opstart. Upgrade naar het Starter-plan voor een altijd-actieve service.

Dataverlies na herdeployment

Dit gebeurt op de gratis tier (geen persistente disk). Upgrade naar een betaald plan, of exporteer je configuratie regelmatig via /setup/export.

Health check mislukt

Render verwacht binnen 30 seconden een 200-respons van /health. Als builds slagen maar deploys mislukken, heeft de service mogelijk te lang nodig om op te starten. Controleer:

Build-logs op fouten
Of de container lokaal draait met docker build && docker run