Passer au contenu principal
Déployez OpenClaw sur Render en utilisant l’infrastructure en tant que code. Le Blueprint render.yaml inclus définit toute votre pile de manière déclarative, service, disque, variables d’environnement, afin que vous puissiez déployer en un clic et versionner votre infrastructure aux côtés de votre code.

​
Prérequis

​
Déployer avec un Blueprint Render

Déployer sur Render Cliquer sur ce lien permet de :
  1. Créer un nouveau service Render à partir du Blueprint render.yaml à la racine de ce dépôt.
  2. Construire l’image Docker et déployer
Une fois déployé, l’URL de votre service suit le modèle https://<service-name>.onrender.com.

​
Comprendre le Blueprint

Les Blueprints Render sont des fichiers YAML qui définissent votre infrastructure. Le fichier render.yaml de ce dépôt configure tout ce qui est nécessaire pour exécuter OpenClaw : 
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 # auto-generates a secure token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1
Principales fonctionnalités Blueprint utilisées :
FonctionnalitéObjectif
runtime: dockerConstruit à partir du Dockerfile du dépôt
healthCheckPathRender surveille /health et redémarre les instances non saines
generateValue: trueGénère automatiquement une valeur cryptographiquement sûre
diskStockage persistant qui survit aux redéploiements

​
Choisir une offre

OffreMise en veilleDisqueIdéal pour
FreeAprès 15 min d’inactivitéNon disponibleTests, démonstrations
StarterJamais1 Go+Usage personnel, petites équipes
Standard+Jamais1 Go+Production, plusieurs canaux
Le Blueprint utilise starter par défaut. Pour utiliser le niveau gratuit, remplacez plan: starter par plan: free dans le render.yaml de votre fork (mais notez que l’absence de disque persistant signifie que l’état d’OpenClaw est réinitialisé à chaque déploiement).

​
Après le déploiement

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

Le dashboard web est disponible à l’adresse https://<your-service>.onrender.com/. Connectez-vous en utilisant le secret partagé configuré. Ce modèle de déploiement génère automatiquement OPENCLAW_GATEWAY_TOKEN (retrouvez-le dans Dashboard → your service → Environment) ; si vous le remplacez par une authentification par mot de passe, utilisez ce mot de passe à la place.

​
Fonctionnalités du dashboard Render

​
Journaux

Consultez les journaux en temps réel dans Dashboard → your service → Logs. Filtrez par :
  • Journaux de build (création de l’image Docker)
  • Journaux de déploiement (démarrage du service)
  • Journaux d’exécution (sortie de l’application)

​
Accès shell

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

​
Variables d’environnement

Modifiez les variables dans Dashboard → your service → Environment. Les changements déclenchent un redéploiement automatique.

​
Déploiement automatique

Si vous utilisez le dépôt OpenClaw d’origine, Render ne redéploiera pas automatiquement votre OpenClaw. Pour le mettre à jour, lancez une synchronisation manuelle du Blueprint depuis le dashboard.

​
Domaine personnalisé

  1. Accédez à Dashboard → your service → Settings → Custom Domains
  2. Ajoutez votre domaine
  3. Configurez le DNS comme indiqué (CNAME vers *.onrender.com)
  4. Render provisionne automatiquement un certificat TLS

​
Mise à l’échelle

Render prend en charge la mise à l’échelle horizontale et verticale :
  • Verticale : changez d’offre pour obtenir plus de CPU/RAM
  • Horizontale : augmentez le nombre d’instances (offre Standard et supérieure)
Pour OpenClaw, la mise à l’échelle verticale est généralement suffisante. La mise à l’échelle horizontale nécessite des sessions persistantes ou une gestion d’état externe.

​
Sauvegardes et migration

Exportez votre état, votre configuration, vos profils d’authentification et votre espace de travail à tout moment en utilisant l’accès shell dans le dashboard Render : 
openclaw backup create
Cela crée une archive de sauvegarde portable avec l’état OpenClaw ainsi que tout espace de travail configuré. Voir Backup pour plus de détails.

​
Dépannage

​
Le service ne démarre pas

Vérifiez 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 est défini afin que la gateway se lie au port attendu par Render

​
Démarrages à froid lents (niveau gratuit)

Les services du niveau gratuit se mettent en veille après 15 minutes d’inactivité. La première requête après cette mise en veille prend quelques secondes pendant le démarrage du conteneur. Passez à l’offre Starter pour un service toujours actif.

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

Cela se produit sur le niveau gratuit (pas de disque persistant). Passez à une offre payante, ou exportez régulièrement une sauvegarde complète via openclaw backup create dans le shell Render.

​
Échecs de vérification d’état

Render attend une réponse 200 de /health en moins de 30 secondes. Si les builds réussissent mais que les déploiements échouent, le service met peut-être trop de temps à démarrer. Vérifiez :
  • Les journaux de build pour les erreurs
  • Si le conteneur fonctionne localement avec docker build && docker run

​
Étapes suivantes