Afficher

Déployez OpenClaw sur Render à l’aide du Blueprint render.yaml du dépôt. Celui-ci déclare le service, le disque et les variables d’environnement dans un seul fichier.

Prérequis

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

Déploiement

Déployer sur Render Cette opération crée un service Render à partir de render.yaml, génère l’image Docker et la déploie. L’URL de votre service suit le format https://<service-name>.onrender.com.

Le 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 # génère automatiquement un jeton sécurisé
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1

Fonctionnalité	Objectif
`runtime: docker`	Génère l’image à partir du Dockerfile du dépôt
`healthCheckPath`	Render surveille `/health` et redémarre les instances défaillantes
`generateValue: true`	Génère automatiquement une valeur sécurisée par cryptographie
`disk`	Stockage persistant qui subsiste après les redéploiements

Choix d’une offre

Offre	Mise en veille	Disque	Usage recommandé
Gratuite	Après 15 min d’inactivité	Non disponible	Tests, démonstrations
Starter	Jamais	1 Go ou plus	Usage personnel, petites équipes
Standard+	Jamais	1 Go ou plus	Production, plusieurs canaux

Le Blueprint utilise starter par défaut. Pour utiliser l’offre gratuite, remplacez plan: starter par plan: free dans le fichier render.yaml de votre fork. Notez que sans disque persistant, l’état d’OpenClaw est réinitialisé à chaque déploiement.

Après le déploiement

Accéder à l’interface de contrôle

Le tableau de bord web est disponible à l’adresse https://<your-service>.onrender.com/. Connectez-vous avec le secret partagé : le OPENCLAW_GATEWAY_TOKEN généré automatiquement (vous le trouverez dans Dashboard → your service → Environment) ou votre mot de passe si vous avez opté pour l’authentification par mot de passe.

Journaux

Dashboard → your service → Logs affiche les journaux de génération (création de l’image Docker), de déploiement (démarrage du service) et d’exécution (sortie de l’application).

Accès au shell

Dashboard → your service → Shell ouvre une session shell. Le disque persistant est monté dans /data.

Variables d’environnement

Modifiez les variables dans Dashboard → your service → Environment. Les modifications déclenchent automatiquement un nouveau déploiement.

Déploiement automatique

Render redéploie automatiquement le service lorsqu’un nouveau commit est ajouté à la branche connectée du dépôt. Si vous avez effectué le déploiement directement depuis openclaw/openclaw plutôt que depuis votre propre fork, vous ne disposez pas d’un accès en écriture permettant de le déclencher. Pour effectuer une mise à jour, lancez manuellement une synchronisation du Blueprint depuis le Dashboard ou associez le service à votre propre fork.

Domaine personnalisé

Dashboard → your service → Settings → Custom Domains
Ajoutez votre domaine
Configurez le DNS conformément aux instructions (CNAME vers *.onrender.com)
Render provisionne automatiquement un certificat TLS

Mise à l’échelle

Verticale : changez d’offre pour obtenir davantage de CPU et de RAM. Cela suffit généralement pour OpenClaw.
Horizontale : augmentez le nombre d’instances (offre Standard ou supérieure). Cette configuration nécessite des sessions persistantes ou une gestion externe de l’état, car OpenClaw conserve son état d’exécution sur le disque local.

Sauvegardes et migration

Depuis le shell du Dashboard Render, exportez à tout moment l’état, la configuration, les profils d’authentification et l’espace de travail :

openclaw backup create

Cette commande crée une archive de sauvegarde portable. Consultez la page Sauvegarde.

Résolution des problèmes

Le service ne démarre pas

Consultez les journaux de déploiement dans le Dashboard Render. Problèmes courants :

OPENCLAW_GATEWAY_TOKEN manquant — vérifiez qu’il est défini dans Dashboard → Environment
Incompatibilité de port — assurez-vous que OPENCLAW_GATEWAY_PORT=8080 afin que le Gateway se lie au port attendu par Render

Démarrages à froid lents (offre gratuite)

Les services de l’offre gratuite sont mis en veille après 15 minutes d’inactivité. La première requête suivant la mise en veille prend quelques secondes, le temps que le conteneur démarre. Passez à l’offre Starter pour que le service reste toujours actif.

Perte de données après un redéploiement

Cela se produit avec l’offre gratuite, qui ne fournit pas de disque persistant. Passez à une offre payante ou exportez régulièrement une sauvegarde depuis le shell Render avec openclaw backup create.

Échec des vérifications d’intégrité

Si les générations réussissent, mais que les déploiements échouent, le service met peut-être trop de temps à démarrer ou /health n’est peut-être pas accessible. Vérifiez :

Les journaux de génération à la recherche d’erreurs
Que le conteneur s’exécute localement avec docker build && docker run

Étapes suivantes

Configurez les canaux de messagerie : Canaux
Configurez le Gateway : Configuration du Gateway
Maintenez OpenClaw à jour : Mise à jour

Install overview

Maintenance

Containers

Hosting

Advanced setup

Prérequis

Déploiement

Le Blueprint

Choix d’une offre

Après le déploiement

Accéder à l’interface de contrôle

Journaux

Accès au shell

Variables d’environnement

Déploiement automatique

Domaine personnalisé

Mise à l’échelle

Sauvegardes et migration

Résolution des problèmes

Le service ne démarre pas

Démarrages à froid lents (offre gratuite)

Perte de données après un redéploiement

Échec des vérifications d’intégrité

Étapes suivantes

​Prérequis

​Déploiement

​Le Blueprint

​Choix d’une offre

​Après le déploiement

​Accéder à l’interface de contrôle

​Journaux

​Accès au shell

​Variables d’environnement

​Déploiement automatique

​Domaine personnalisé

​Mise à l’échelle

​Sauvegardes et migration

​Résolution des problèmes

​Le service ne démarre pas

​Démarrages à froid lents (offre gratuite)

​Perte de données après un redéploiement

​Échec des vérifications d’intégrité

​Étapes suivantes

Prérequis

Déploiement

Le Blueprint

Choix d’une offre

Après le déploiement

Accéder à l’interface de contrôle

Journaux

Accès au shell

Variables d’environnement

Déploiement automatique

Domaine personnalisé

Mise à l’échelle

Sauvegardes et migration

Résolution des problèmes

Le service ne démarre pas

Démarrages à froid lents (offre gratuite)

Perte de données après un redéploiement

Échec des vérifications d’intégrité

Étapes suivantes