Déployer sur Render | Docs

Déployez OpenClaw sur Render grâce à l’Infrastructure as Code. Le fichier render.yaml (Blueprint) décrit votre stack de manière déclarative — service, disque, variables d’environnement — pour un déploiement en un clic et une infrastructure versionnée aux côtés de votre code.

Prérequis

Un compte Render (offre gratuite disponible)
Une clé API de votre fournisseur de modèle préféré

Déployer avec un Blueprint Render

Deploy to Render

En cliquant sur ce lien :

Render crée un nouveau service à partir du Blueprint render.yaml situé à la racine du dépôt.
Il vous demande de définir SETUP_PASSWORD.
L’image Docker est construite puis déployée.

Une fois en ligne, l’URL de votre service suit le format https://<nom-du-service>.onrender.com.

Comprendre le Blueprint

Les Blueprints Render sont des fichiers YAML qui décrivent votre infrastructure. Le render.yaml de ce dépôt configure tout le nécessaire pour faire tourner OpenClaw :

services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: PORT
        value: "8080"
      - key: SETUP_PASSWORD
        sync: false # demandé lors du déploiement
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true # génère automatiquement un token sécurisé
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1

Points clés du Blueprint :

Fonctionnalité	Rôle
`runtime: docker`	Build à partir du Dockerfile du dépôt
`healthCheckPath`	Render surveille `/health` et redémarre les instances défaillantes
`sync: false`	Demande la valeur au moment du déploiement (pour les secrets)
`generateValue: true`	Génère automatiquement une valeur cryptographiquement sûre
`disk`	Stockage persistant qui survit aux redéploiements

Choisir un plan

Plan	Mise en veille	Disque	Idéal pour
Free	Après 15 min d’inactivité	Non disponible	Tests, démonstrations
Starter	Jamais	1 Go+	Usage personnel, petites équipes
Standard+	Jamais	1 Go+	Production, canaux multiples

Le Blueprint est configuré par défaut sur starter. Pour utiliser l’offre gratuite, modifiez plan: free dans le render.yaml de votre fork (attention : sans disque persistant, la configuration est réinitialisée à chaque déploiement).

Après le déploiement

Finaliser la configuration

Rendez-vous sur https://<votre-service>.onrender.com/setup
Saisissez votre SETUP_PASSWORD
Sélectionnez un fournisseur de modèle et collez votre clé API
(Facultatif) Configurez vos canaux de messagerie (Telegram, Discord, Slack)
Cliquez sur Run setup

Accéder à l’interface de contrôle

Le tableau de bord web est accessible sur https://<votre-service>.onrender.com/openclaw.

Fonctionnalités du Dashboard Render

Logs

Consultez les logs en temps réel dans Dashboard → votre service → Logs. Vous pouvez filtrer par :

Logs de build (création de l’image Docker)
Logs de déploiement (démarrage du service)
Logs d’exécution (sortie de l’application)

Accès shell

Pour le débogage, ouvrez une session shell via Dashboard → votre service → Shell. Le disque persistant est monté sur /data.

Variables d’environnement

Modifiez les variables dans Dashboard → votre service → Environment. Tout changement déclenche un redéploiement automatique.

Déploiement automatique

Si vous utilisez le dépôt OpenClaw d’origine, Render ne déclenche pas de déploiement automatique. Pour mettre à jour, lancez une synchronisation manuelle du Blueprint depuis le tableau de bord.

Domaine personnalisé

Allez dans Dashboard → votre service → Settings → Custom Domains
Ajoutez votre domaine
Configurez le DNS comme indiqué (CNAME vers *.onrender.com)
Render provisionne automatiquement un certificat TLS

Montée en charge

Render propose du scaling horizontal et vertical :

Vertical : changez de plan pour obtenir plus de CPU/RAM
Horizontal : augmentez le nombre d’instances (plan Standard et supérieur)

Pour OpenClaw, le scaling vertical suffit en général. Le scaling horizontal nécessite des sessions persistantes (sticky sessions) ou une gestion d’état externe.

Sauvegardes et migration

Exportez votre configuration et votre workspace à tout moment :

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

Vous obtenez une sauvegarde portable, restaurable sur n’importe quel hôte OpenClaw.

Résolution de problèmes

Le service ne démarre pas

Vérifiez les logs de déploiement dans le Dashboard Render. Causes fréquentes :

SETUP_PASSWORD manquant — le Blueprint le demande normalement, mais vérifiez qu’il est bien défini
Conflit de port — assurez-vous que PORT=8080 correspond au port exposé dans le Dockerfile

Démarrage lent à froid (offre gratuite)

Les services de l’offre gratuite se mettent en veille après 15 minutes d’inactivité. La première requête après la mise en veille prend quelques secondes, le temps que le conteneur redémarre. Passez au plan Starter pour un service toujours actif.

Perte de données après redéploiement

Cela se produit sur l’offre gratuite (pas de disque persistant). Passez à un plan payant, ou exportez régulièrement votre configuration via /setup/export.

Échecs du health check

Render attend une réponse 200 de /health dans les 30 secondes. Si le build réussit mais que le déploiement échoue, c’est probablement que le service met trop de temps à démarrer. Vérifiez :

Les logs de build pour repérer d’éventuelles erreurs
Que le conteneur fonctionne en local avec docker build && docker run