# Render

Déployez OpenClaw sur Render à l’aide de l’infrastructure en tant que code. Le Blueprint render.yaml inclus définit déclarativement toute votre pile — service, disque, variables d’environnement — afin que vous puissiez déployer en un clic et versionner votre infrastructure avec votre code.

# Prérequis

• Un compte Render (niveau gratuit disponible)
• Une clé API de votre fournisseur de modèles préféré

# Déployer avec un Blueprint Render

Deploy to Render

Cliquer sur ce lien permettra 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ée, 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 render.yaml de ce dépôt configure tout le 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 # génère automatiquement un token sécurisé
    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 en mauvaise santé
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émos
Starter	Jamais	1 Go+	Usage personnel, petites équipes
Standard+	Jamais	1 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 : 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 à l’aide du secret partagé configuré. Ce modèle de déploiement génère automatiquement OPENCLAW_GATEWAY_TOKEN (trouvez-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 Render Dashboard

# 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 modifications 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, exécutez une synchronisation manuelle du Blueprint depuis le tableau de bord.

# Domaine personnalisé

1. Allez dans 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 de plan pour obtenir plus de CPU/RAM
• Horizontale : augmentez le nombre d’instances (plan Standard et plus)

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 Render Dashboard :

openclaw backup create

Cela crée une archive de sauvegarde portable avec l’état d’OpenClaw ainsi que 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 Render Dashboard. 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 le 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 la mise en veille prend quelques secondes pendant le démarrage du conteneur. Passez au plan Starter pour un service toujours actif.

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

Cela arrive 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 du health check

Render attend une réponse 200 de /health dans les 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 détecter des erreurs
• Si le conteneur s’exécute localement avec docker build && docker run

# Étapes suivantes

• Configurez les canaux de messagerie : Channels
• Configurez le Gateway : Configuration du Gateway
• Gardez OpenClaw à jour : Updating