Render

Render

Déployez OpenClaw sur Render en utilisant l’Infrastructure as Code. Le Blueprint render.yaml inclus définit l’intégralité de votre pile de manière déclarative, service, disque, variables d’environnement, afin que vous puissiez déployer en un seul clic et versionner votre infrastructure aux côtés de votre code.

Prérequis

• Un compte Render (https://render.com) (version gratuite disponible)
• Une clé API de votre model provider préféré

Déployer avec un Render Blueprint

Déployer sur Render

Cliquer sur ce lien va :

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 Render Blueprints sont des fichiers YAML qui définissent votre infrastructure. Le render.yaml dans ce dépôt configure tout ce dont on a besoin 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

Fonctionnalités clés du Blueprint utilisées :

Fonctionnalité	Objectif
runtime: docker	Construit à partir du Dockerfile du dépôt
healthCheckPath	Render surveille /health et redémarre les instances non saines
generateValue: true	Génère automatiquement une valeur cryptographiquement sécurisée
disk	Stockage persistant qui survit aux redéploiements

Choisir un forfait

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

Le Blueprint utilise par défaut starter. Pour utiliser le niveau gratuit, modifiez plan: free dans le render.yaml de votre fork (mais notez : 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 de contrôle

Le tableau de bord web est disponible à 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 (trouvez-le dans Tableau de bord → votre service → Environnement) ; si vous le remplacez par une authentification par mot de passe, utilisez plutôt ce mot de passe.

Fonctionnalités du tableau de bord Render

Journaux

Affichez les journaux en temps réel dans Dashboard → votre 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 → votre service → Shell. Le disque persistant est monté sur /data.

Variables d’environnement

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

Déploiement automatique

Si vous utilisez le dépôt original OpenClaw, Render ne déploiera pas automatiquement votre OpenClaw. Pour le mettre à jour, lancez une synchronisation manuelle de Blueprint depuis le tableau de bord.

Domaine personnalisé

1. Accédez à Dashboard → votre 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 le plan pour obtenir plus de CPU/RAM
• Horizontale : Augmentez le nombre d’instances (plan Standard et supérieur)

Pour OpenClaw, la mise à l’échelle verticale est généralement suffisante. La mise à l’échelle horizontale nécessite des sessions rémanentes 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 tableau de bord Render :

openclaw backup create

Cela crée une archive de sauvegarde portable avec l’état OpenClaw plus tout espace de travail configuré. Voir Backup pour les détails.

Dépannage

Le service ne démarre pas

Vérifiez les journaux de déploiement dans le tableau de bord Render. Problèmes courants :

• Manque de OPENCLAW_GATEWAY_TOKEN — vérifiez qu’il est défini dans Dashboard → Environment
• Inadéquation de port — assurez-vous que OPENCLAW_GATEWAY_PORT=8080 est défini pour que la passerelle se lie au port attendu par Render

Démarrages à froid lents (tier gratuit)

Les services de la tier gratuite s’arrêtent après 15 minutes d’inactivité. La première demande après l’arrêt prend quelques secondes pendant le démarrage du conteneur. Passez au plan Starter pour une disponibilité permanente.

Perte de données après redéploiement

Cela arrive sur la tier gratuite (pas de disque persistant). Passez à un plan payant, ou exportez régulièrement une sauvegarde complète via openclaw backup create dans le shell Render.

Échecs des contrôles de santé

Render s’attend à une réponse 200 de /health dans les 30 secondes. Si les builds réussissent mais que les déploiements échouent, le service peut mettre trop de temps à démarrer. Vérifiez :

• Les logs de build pour les erreurs
• Si le conteneur fonctionne localement avec docker build && docker run

Étapes suivantes

• Configurer les canaux de messagerie : Canaux
• Configurer le Gateway : configuration du Gateway
• Garder OpenClaw à jour : Mise à jour