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

Choix d’une offre

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é

1. Dashboard → your service → Settings → Custom Domains
2. Ajoutez votre domaine
3. Configurez le DNS conformément aux instructions (CNAME vers *.onrender.com)
4. 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