Aller au contenu principal

OpenClaw sur Google Cloud Run

OpenClaw sur Google Cloud Run

OpenClaw est une passerelle d'agents IA multi-locataires conçue spécifiquement pour des déploiements d'agents isolés et persistants. Elle permet aux équipes d'exécuter des assistants IA par locataire, basés sur des modèles Anthropic, avec des espaces de travail GCS dédiés et une intégration optionnelle aux canaux Telegram ou Slack — le tout sans état partagé entre les agents. Ce module déploie OpenClaw sur Cloud Run v2 au-dessus de la fondation App_CloudRun, qui provisionne et gère l'infrastructure Google Cloud partagée.

Ce guide se concentre sur les services cloud qu'OpenClaw utilise et sur la manière de les explorer et de les opérer depuis la console Google Cloud et la ligne de commande. Pour les mécaniques communes à toutes les applications Cloud Run — identité de service, ingress et équilibrage de charge, mise à l'échelle et concurrence, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC Service Controls, sauvegardes et cycle de vie du déploiement — référez-vous au guide de la fondation App_CloudRun plutôt que de les répéter ici.


Ce que coûte OpenClaw sur RAD, et comment cela se compare​

OpenClaw sur le module Cloud Run de RAD coûte environ 69 US$ par mois, les frais de module étant facturés une seule fois en crédits RAD. Si vous avez besoin qu'OpenClaw reste opérationnel en continu, qu'il s'adapte à plusieurs pods ou qu'il fonctionne aux côtés d'autres charges de travail Kubernetes, consultez le guide GKE pour cette option. Si vous n'en avez besoin qu'occasionnellement — une démo, un projet saisonnier, quelque chose que vous évaluez — un projet géré par RAD peut être supprimé et restauré dans les 30 jours sans frais supplémentaires au lieu de payer pour qu'il reste inactif. Voir Mettez-le en pause gratuitement, ci-dessous. Les chiffres sont à jour au 8 octobre 2026 ; les sources sont listées à la fin de cette section.

Ce que vous payez sur RAD​

RAD déploie OpenClaw, qui est open source, il n'y a donc pas de frais de licence par utilisateur. Vous payez pour trois choses :

Dans un projet Google Cloud que vous possédezDans un projet que RAD gère pour vous
Frais de module, une fois par déploiement75 crédits (8 US$ au prix de la recharge)67,5 crédits (10 % de moins)
BuildsInclus dans le prix : pas de frais de build pour la création, 5 mises à jour par mois (mois calendaire UTC) gratuites, puis 2 crédits chacune, et rien pour la suppression ou pour un build échoué, dans la limite de 10 builds échoués par jour (UTC). Les sessions de lab et les projets clients sont l'exception : ils sont toujours facturés à la minute pour le temps de buildIdentique
Coût de fonctionnement Google CloudFacturé par Google à votre propre compte de facturation, environ 69 US$ par mois pour la configuration par défaut (tableau ci-dessous)Mesuré à l'heure en crédits ; RAD publie 61 crédits par jour, soit environ 1 830 par mois (environ 183 US$ au prix de la recharge)
Qui possède quoiVous possédez le projet et sa facturation ; RAD le déploie et le met à jourRAD possède le projet, avec des garde-fous, des quotas et des alertes budgétaires ; vous avez accès à la console, et un solde acheté minimum est conservé en réserve

Votre premier déploiement réussi sur RAD est exempt de frais de module, quel que soit le montant : une fois par compte, pour un module que vous déployez et payez vous-même (dans une solution, les frais d'une application : la première à réussir ; jamais une session de lab ou un projet client).

10 crédits coûtent 1 US$ pour une recharge ponctuelle, et moins sur un plan mensuel. Dans un projet géré par RAD, la base de données, le serveur de fichiers et le réseau sont partagés par toutes les applications du projet, de sorte qu'une deuxième application n'ajoute pas un deuxième ensemble de ces éléments.

Coût de fonctionnement par défaut dans votre propre projet (us-central1, prix catalogue Google) :

Ressource (par défaut du module)Par mois
Cloud Run, 1x vCPU / 1 GiB (scaleToZero)11,58 US$
Cloud SQL pour PostgreSQL, 1 vCPU / 3,75 GB, zonal, 10 GB SSD51,02 US$
Cloud NAT et réseau5 US$
Cloud Storage (modules complémentaires, sauvegardes)1 US$
Totalenviron 69 US$

Comment cela se compare​

  • Aucun SaaS géré clé en main n'a été vérifié pour OpenClaw lui-même, la comparaison honnête est donc un serveur autogéré : un Hetzner CPX22 (2 vCPU/4 Go) coûte environ 24 $/mois, un DigitalOcean 2 vCPU/4 Go Droplet environ 24 $/mois, et un GCP Compute Engine e2-standard-2 (2 vCPU/8 Go) environ 49 $/mois.
  • Il s'agit d'une charge de travail légère — une classe de VPS moins chère et plus petite que les boîtiers de référence ci-dessous ferait également l'affaire ; les chiffres sont présentés pour une comparaison similaire.
  • OpenClaw est une passerelle d'agents IA multi-locataires sur mesure sans équivalent SaaS prêt à l'emploi à comparer. L'alternative réaliste est de construire vous-même la même isolation par locataire (espaces de travail séparés, secrets, intégrations de canaux) sur un VPS ou un Kubernetes géré, ce qui représente un effort d'ingénierie matériellement plus important que le déploiement en un clic de RAD, en plus de nécessiter votre propre PostgreSQL géré.
  • Le prix du VPS n'est pas le coût total. Sur un VPS nu, c'est aussi vous qui corrigez le système d'exploitation, faites tourner les sauvegardes et maintenez la base de données (le cas échéant) en bonne santé. Cloud SQL géré par RAD, Secret Manager et la surveillance couvrent cela pour vous, ce qui est le véritable argument en faveur de RAD par rapport à une boîte moins chère — pas le prix affiché.

Mettez-le en pause gratuitement : supprimez un projet géré par RAD, restaurez-le quand vous en avez besoin​

Si OpenClaw s'exécute dans un projet que RAD gère pour vous, vous avez une deuxième option qui va bien au-delà de la mise à l'échelle à zéro : supprimez l'ensemble du projet et restaurez-le dans les 30 jours pour presque rien. Cela convient bien mieux à OpenClaw dont vous n'avez besoin qu'occasionnellement — une démo, une évaluation, un projet saisonnier — que de le faire fonctionner en continu.

Une restauration n'est pas garantie — conservez vos propres sauvegardes. Les conditions de Google Cloud ne garantissent pas qu'un projet restauré, ou les ressources qu'il contient, sera utilisable après sa restauration. Il ne faut donc pas compter sur la restauration comme moyen de récupérer un projet supprimé. Avant de supprimer, assurez-vous d'avoir effectué des sauvegardes appropriées des données et de la configuration de l'application et de les avoir stockées en dehors du projet. Si une restauration échoue, ou si le projet restauré ne fonctionne pas, la solution de repli consiste à redéployer l'application (voir la section suivante) et à restaurer sa configuration et ses données à partir de ces sauvegardes.

  • Comment ça marche. La suppression d'un projet géré par RAD délie d'abord sa facturation, puis demande à Google de supprimer le projet. Google ne supprime pas le projet immédiatement : il le conserve, récupérable, pendant 30 jours. Comme la facturation est déjà déliée, rien n'est facturé pendant cette attente. Contrairement à la suppression d'un module, cela ne détruit pas la base de données ou la ressource de calcul une par une — l'ensemble du projet, et tout ce qu'il contient, s'arrête simplement.
  • La restauration est une vérification, pas une reconstruction. Dans les 30 jours, le propriétaire du projet peut le restaurer. RAD demande à Google de récupérer le projet et de rattacher son compte de facturation, puis vous demande d'exécuter Mettre à jour sur chaque déploiement pour confirmer que tout est revenu. Comme rien n'a été détruit individuellement, cette mise à jour trouve les mêmes ressources déjà présentes — c'est une vérification, pas une reconstruction, et une mise à jour ne facture jamais les frais de module à nouveau. Les mises à jour sont incluses dans le prix (5 par mois pour chaque déploiement), donc une restauration ne coûte normalement aucun crédit.
  • Ainsi, un mois d'utilisation occasionnelle peut coûter quelques dollars, et non les 183 US$ par mois pour le maintenir en fonctionnement. Déployez OpenClaw, utilisez-le un certain temps, supprimez le projet. Restaurez-le la prochaine fois que vous en avez besoin, confirmez avec Mettre à jour, et supprimez-le à nouveau lorsque vous avez terminé. Vous ne payez que les frais de module une seule fois et le temps pendant lequel OpenClaw a été réellement actif.
  • Ce que cela nécessite. Vous devez être propriétaire du projet (pas un projet que vous apportez et dont RAD ne gère que la facturation), et vous le restaurez vous-même dans les 30 jours — après cela, Google le supprime définitivement. La restauration est admise comme la création d'un nouveau projet : votre solde de crédits achetés doit toujours atteindre le seuil du palier (100 crédits pour le palier sandbox qui convient à la plupart des utilisations d'étude et de démo). Google indique que la plupart des services sont pleinement fonctionnels dans les 36 heures suivant une restauration.
  • Un véritable manque : les sauvegardes nocturnes ne survivent pas. Les sauvegardes sont écrites dans un bucket à l'intérieur du projet, et ce bucket n'est pas protégé par la suppression logicielle de Cloud Storage, il est donc très probable qu'il disparaisse dès que vous supprimez le projet — même si le projet lui-même est récupérable pendant 30 jours. Si vous avez personnalisé OpenClaw et que vous souhaitez conserver ce travail, copiez une sauvegarde (vers Google Drive ou un bucket en dehors du projet) avant de supprimer. Pour une installation par défaut sans rien d'irremplaçable, cela n'a pas d'importance.

Payez uniquement pendant que vous l'utilisez, l'autre méthode : supprimer et redéployer​

L'option ci-dessus ne s'applique qu'à un projet géré par RAD ; dans votre propre projet, ou une fois la fenêtre de 30 jours passée, la manière d'arrêter de payer est de supprimer le déploiement et de le redéployer lorsque vous en avez besoin.

  • Ce que coûte un redéploiement. Les frais de module à nouveau (les builds sont inclus) : 75 crédits (7,50 US$) dans votre propre projet, ou 67,5 crédits dans un projet géré par RAD. La suppression permet d'économiser de l'argent une fois qu'OpenClaw resterait inutilisé pendant environ 3 jours ou plus dans votre propre projet (environ 2,29 US$ par jour), ou environ 2 jours ou plus dans un projet géré par RAD (61 crédits par jour).
  • La majeure partie du coût de fonctionnement est généralement la base de données et toute VM de fichier/cache partagée. Elles ne s'arrêtent que si rien d'autre dans le projet ne les utilise, donc la suppression d'OpenClaw alors que quelque chose d'autre partage le projet n'économise que la partie calcul de cette application.
  • Conservez d'abord vos données. Les sauvegardes nocturnes vont dans un bucket à l'intérieur du déploiement et sont supprimées avec lui, alors copiez la dernière sauvegarde avant de la supprimer si vous voulez la conserver.

Sessions de lab et environnements gérés​

  • Sessions de lab, pour la formation. Un formateur anime une session pour une classe. Chaque participant reçoit OpenClaw dans son propre projet Google Cloud pendant 15 minutes à 24 heures, dans la limite d'une allocation définie par le formateur. Le formateur peut aussi créer un seul environnement partagé pour toute la classe, et chacun utilise alors la même application et ses données. Soit le formateur finance toutes les places, soit chaque participant paie la sienne. Tout est supprimé à la fin de la session et les crédits non utilisés sont restitués au formateur.
  • Environnements gérés, pour les cabinets de conseil. Un partenaire exécute OpenClaw pour un client à partir d'un portefeuille cloisonné qu'il finance, et règle directement avec le client. Si le portefeuille est faible, la facturation est suspendue et les données sont conservées, de sorte que personne ne reçoit de frais inattendus. À la fin, le partenaire transfère le projet et les déploiements deviennent la propriété du client.
  • Les crédits peuvent être achetés dans plus de 20 devises, y compris XAF, XOF, NGN, GHS, KES et ZAR, par carte, virement bancaire ou argent mobile.

Sources (8 octobre 2026) : Prix catalogue Google Cloud de l'API Cloud Billing Catalog ; Supprimer et restaurer des projets pour la fenêtre de récupération de 30 jours et ce qu'elle dit sur les objets Cloud Storage sans suppression logicielle ; frais RAD et estimations de crédits quotidiens de radmodules.dev/pricing. Les prix changent ; vérifiez chaque source avant de vous fier à un chiffre.

1. Vue d'ensemble​

OpenClaw s'exécute comme un conteneur Node.js sur Cloud Run v2 (Gen2). Le déploiement connecte un ensemble ciblé de services Google Cloud :

CapacitéService Google CloudNotes
CalculCloud Run v2 (Gen2)Service Node.js, 1 vCPU / 1 GiB par défaut, CPU toujours alloué
Stockage de l'espace de travailCloud Storage (GCS Fuse)Bucket d'espace de travail par locataire monté à /data via GCS Fuse
Identifiants IASecret ManagerClé API Anthropic et jeton de passerelle toujours stockés ; secrets Telegram et Slack optionnels
IngressURL Cloud Run / Cloud Load BalancingPublic (all) par défaut ; LB HTTPS externe + domaine personnalisé optionnels
SecretsSecret ManagerTous les identifiants injectés à l'exécution ; texte en clair jamais dans la configuration

Valeurs par défaut judicieuses à connaître d'emblée :

  • Pas de base de données, pas de Redis. OpenClaw est une passerelle Node.js avec état entièrement basée sur GCS Fuse à /data. Cloud SQL et Redis ne sont jamais provisionnés.
  • Le CPU est toujours alloué. cpu_always_allocated = true est requis. Les connexions WebSocket et les opérations d'agent asynchrones échouent en cas de limitation du CPU. Ne pas définir sur false.
  • L'environnement d'exécution Gen2 est requis. Les montages de volume GCS Fuse ne sont pas disponibles en Gen1 et échoueront silencieusement.
  • L'image de conteneur personnalisée est toujours construite. Le module superpose un entrypoint.sh à l'image amont ghcr.io/openclaw/openclaw.
  • L'espace de travail GCS à /data est toujours monté. Un bucket <prefix>-storage dédié est toujours provisionné et monté. L'état persistant de l'agent y réside lors des redémarrages de conteneur.
  • OPENCLAW_STATE_DIR est sur le disque local. La mise en scène npm et le répertoire de configuration XDG sont redirigés vers /tmp/openclaw pour éviter les limitations de liens physiques de GCS Fuse au démarrage.
  • min_instance_count = 0 par défaut (mise à l'échelle à zéro). Définir sur 1 pour les déploiements d'agents sensibles à la latence afin d'éviter des démarrages à froid de 15 à 20 s.
  • max_instance_count = 1 par locataire. OpenClaw est avec état ; plusieurs instances pour le même locataire répartissent l'état entre les réplicas, sauf si un routage persistant est en place.
  • L'ingress est par défaut all (accès public direct). Définir ingress_settings = "internal" pour restreindre le service au trafic VPC lors de son positionnement devant un routeur OpenClaw.

2. Services Google Cloud et comment les explorer​

Toutes les commandes supposent que PROJECT et REGION sont définis. Les noms de services et de ressources sont rapportés dans les Sorties du déploiement.

A. Cloud Run — le service OpenClaw​

OpenClaw s'exécute comme un service Cloud Run v2 sur l'environnement d'exécution Gen2. Le CPU est toujours alloué pour prendre en charge les connexions WebSocket et les opérations d'agent asynchrones. Chaque déploiement crée une révision immuable ; le trafic peut être réparti entre les révisions pour des déploiements sûrs.

  • Console : Cloud Run → sélectionnez le service pour les révisions, le trafic, les journaux et les métriques.
  • CLI :
    gcloud run services list --project "$PROJECT" --region "$REGION"
    gcloud run services describe <service-name> --project "$PROJECT" --region "$REGION"
    gcloud run revisions list --service <service-name> --project "$PROJECT" --region "$REGION"

Voir App_CloudRun pour la mise à l'échelle, la concurrence, l'environnement d'exécution et la répartition du trafic.

B. Cloud Storage — espace de travail GCS Fuse​

Tout l'état durable de l'agent est stocké dans un bucket Cloud Storage dédié et monté dans le service à /data par GCS Fuse. La disposition de l'espace de travail est la suivante :

<prefix>-storage/
├── workspace/ ← agent workspace (/data/workspace)
│ └── skill-library/ ← shared skills repo (when skills_repo_url is set)
├── agents/main/agent/ ← agent state directory
└── ...
  • Console : Cloud Storage → Buckets → sélectionnez le bucket <prefix>-storage.
  • CLI :
    gcloud storage buckets list --project "$PROJECT"
    gcloud storage ls gs://<prefix>-storage/

Voir App_CloudRun pour le montage GCS Fuse, les options CMEK et le cycle de vie du bucket.

C. Secret Manager — identifiants​

La clé API Anthropic et le jeton de passerelle sont toujours stockés dans Secret Manager. Lorsque l'intégration Telegram ou Slack est activée, les jetons de bot et les secrets de webhook/signature y sont également stockés. Tous les identifiants sont injectés dans le service à l'exécution.

  • Console : Sécurité → Secret Manager.
  • CLI :
    gcloud secrets list --project "$PROJECT"
    # Retrieve the Anthropic key (initial deploy only; manage via Secret Manager thereafter):
    gcloud secrets versions access latest --secret=<prefix>-anthropic-api-key --project "$PROJECT"
    # Retrieve the gateway token (needed to register clients):
    gcloud secrets versions access latest --secret=<prefix>-gateway-token --project "$PROJECT"

Voir App_CloudRun pour les détails d'injection et de rotation.

D. Réseau et ingress​

Le service est accessible à son URL run.app par défaut, ouvert au trafic Internet public (ingress_settings = "all"). Définissez ingress_settings = "internal" pour le restreindre au trafic VPC lorsque vous le placez devant un routeur OpenClaw. Un équilibreur de charge HTTPS externe avec un domaine personnalisé, Cloud CDN et Cloud Armor peuvent être superposés.

  • Console : Cloud Run (URL du service) ; Services réseau → Équilibrage de charge.
  • CLI :
    gcloud run services describe <service-name> --region "$REGION" --format='value(status.url)'
    gcloud compute addresses list --project "$PROJECT"

Voir App_CloudRun.

E. Cloud Logging et surveillance​

Les journaux des conteneurs sont acheminés vers Cloud Logging ; les métriques Cloud Run sont acheminées vers Cloud Monitoring, avec des tests de disponibilité et des politiques d'alerte optionnels.

  • Console : Logging → Explorateur de journaux ; Monitoring → Tableaux de bord / Alertes.
  • CLI :
    gcloud run services logs read <service-name> --project "$PROJECT" --region "$REGION" --limit 50

3. Comportement de l'application OpenClaw​

  • Pas de job de configuration de base de données. OpenClaw ne nécessite pas de Cloud SQL ni de job d'initialisation. L'état de l'agent réside entièrement sur GCS ; le premier démarrage du conteneur crée automatiquement les répertoires de l'espace de travail via entrypoint.sh.
  • Configuration régénérée à chaque démarrage. entrypoint.sh réécrit toujours openclaw.json dans $OPENCLAW_STATE_DIR, garantissant que les variables d'environnement gérées par Terraform (clés API, jeton de passerelle, paramètres de canal) l'emportent sur toute valeur obsolète précédemment persistée sur GCS.
  • Synchronisation du dépôt de compétences (optionnel). Lorsque skills_repo_url est défini, entrypoint.sh effectue un clone superficiel ou une mise à jour du dépôt dans /data/workspace/skill-library à chaque démarrage du conteneur. La synchronisation n'est pas fatale — la passerelle démarre même si le clone échoue. Vérifiez Cloud Logging pour les entrées skill-library afin de vérifier l'état de la synchronisation.
  • Chemin de santé. Les sondes de démarrage et de vivacité ciblent toutes deux GET /health sur le port 8080. La sonde de démarrage alloue environ 2 minutes pour le montage GCS Fuse et le démarrage de Node.js.
  • Telegram et Slack. Lorsque enable_telegram est défini, le jeton du bot est injecté en tant que TELEGRAM_BOT_TOKEN. Lorsque enable_slack est défini, le jeton du bot et le jeton au niveau de l'application sont injectés en tant que SLACK_BOT_TOKEN et SLACK_APP_TOKEN, et le point d'entrée connecte l'agent à Slack via le mode Socket : un WebSocket sortant qui ne nécessite pas d'ingress public ni de routeur. Slack est livré en tant que plugin séparé @openclaw/slack, que le point d'entrée installe à chaque démarrage. L'accès est fermé en cas d'échec : les messages directs uniquement des ID de membre dans SLACK_ALLOW_FROM, les canaux uniquement des ID dans SLACK_CHANNELS (mention-gated), tous passés par environment_variables. Le secret du webhook Telegram et le secret de signature Slack optionnel sont stockés dans Secret Manager pour un service de routeur compagnon et ne sont pas injectés dans le conteneur de l'agent.
  • Mise à l'échelle à zéro et démarrages à froid. Avec min_instance_count = 0, les événements de webhook Telegram/Slack arrivant pendant un démarrage à froid (15-20 s) peuvent être perdus. Définissez min_instance_count = 1 pour les déploiements d'agents en production.

4. Variables de configuration​

Les variables sont regroupées exactement comme elles apparaissent sur la plateforme de déploiement. Seuls les paramètres spécifiques ou notables pour OpenClaw sont listés ; toute autre entrée est héritée de App_CloudRun avec son comportement standard.

Groupe 1 — Projet et identité​

VariableValeur par défautDescription
project_id(requis)Projet Google Cloud cible.
regionus-central1Région pour le service et les ressources régionales.
anthropic_api_key(requis au premier déploiement)Clé API Anthropic. Stockée dans Secret Manager et injectée en tant que ANTHROPIC_API_KEY. Omettre lors des mises à jour pour conserver la valeur stockée. Sensible.
gateway_token(auto-généré)Jeton d'authentification de la passerelle. Un jeton hexadécimal sécurisé de 64 caractères est généré s'il est laissé vide. Stocké dans Secret Manager en tant que OPENCLAW_GATEWAY_TOKEN. Sensible.

Groupe 2 — Environnement de déploiement​

VariableValeur par défautDescription
tenant_iddemoSuffixe court qui rend les noms de ressources uniques par environnement.
support_users[]Adresses e-mail autorisées à accéder au projet et aux alertes de surveillance.
resource_labels{}Étiquettes appliquées à toutes les ressources.

Groupe 3 — Identité de l'application​

VariableValeur par défautDescription
application_nameopenclawNom de base des ressources. Ne pas modifier après le premier déploiement.
application_display_nameOpenClaw GatewayNom convivial affiché dans la console.
descriptionOpenClaw AI Gateway - Serverless multi-tenant AI agent gateway on Cloud RunDescription du service.
application_versionlatestTag d'image OpenClaw utilisé comme argument de build BASE_IMAGE. Épinglez à une version spécifique pour des builds reproductibles.

Groupe 4 — Exécution et mise à l'échelle​

VariableValeur par défautDescription
deploy_applicationtrueDéfinissez false pour provisionner l'infrastructure uniquement.
cpu_limit1000mCPU par instance.
memory_limit1GiMémoire par instance. Dimensionné pour une utilisation légère/typique (pic observé ~400 Mi) ; augmentez à 2Gi pour des sessions d'agent concurrentes plus lourdes.
min_instance_count00 active la mise à l'échelle à zéro (démarrage à froid de 15 à 20 s). Définissez ≥ 1 pour éliminer les démarrages à froid.
max_instance_count1Maintenez à 1 par locataire pour éviter les états fractionnés. N'augmentez qu'avec un routage persistant.
container_port8080Port sur lequel la passerelle OpenClaw écoute. Doit correspondre à la variable d'environnement PORT.
execution_environmentgen2Gen2 requis pour GCS Fuse. Ne pas changer en gen1.
cpu_always_allocatedtrueRequis pour les connexions WebSocket et les opérations asynchrones. Ne pas définir sur false.
timeout_seconds3600Durée maximale de la requête. Les sessions d'agent sont de longue durée ; 3600 s est le maximum.
enable_cloudsql_volumefalseOpenClaw n'utilise pas Cloud SQL. Laissez false.
traffic_split[]Allocation de trafic Canary/blue-green. Toutes les entrées doivent totaliser 100.
max_revisions_to_retain7Anciennes révisions à conserver après chaque déploiement.

Groupe 5 — Contrôle d'accès et d'ingress​

VariableValeur par défautDescription
ingress_settingsallinternal pour VPC uniquement (recommandé derrière un routeur) ; all pour un accès public direct.
vpc_egress_settingPRIVATE_RANGES_ONLYRoutage d'égression VPC.
enable_iapfalseExiger la connexion Google via Identity-Aware Proxy.
iap_authorized_users / iap_authorized_groups[]Qui peut accéder via IAP.

Groupe 6 — Variables d'environnement et secrets​

VariableValeur par défautDescription
environment_variables{}Paramètres supplémentaires non secrets. Les variables gérées par le module (OPENCLAW_STATE_DIR, NODE_ENV, etc.) ont toujours la priorité.
secret_environment_variables{}Mappage de la variable d'environnement → nom du secret Secret Manager existant. Les identifiants de base sont gérés automatiquement.
secret_propagation_delay30Secondes à attendre après la création du secret avant de continuer.
secret_rotation_period2592000sFréquence de notification de rotation (30 jours).

Groupe 7 — Sauvegarde et restauration​

VariableValeur par défautDescription
backup_schedule0 2 * * *Cron pour la sauvegarde automatisée de l'espace de travail (UTC).
backup_retention_days7Jours de rétention ; augmentez pour la production/conformité.
enable_backup_import / backup_source / backup_formatoptions de restaurationImporte une sauvegarde de l'espace de travail lors du déploiement. backup_format par défaut à tar.

Groupe 8 — CI/CD et Binary Authorization​

Intégration standard App_CloudRun Cloud Build / Cloud Deploy — voir App_CloudRun. Entrées clés : enable_cicd_trigger, github_repository_url, github_token, enable_cloud_deploy, enable_binary_authorization.

Groupe 10 — Équilibreur de charge, CDN et rétention d'images​

VariableValeur par défautDescription
enable_cloud_armorfalseProvisionne un LB HTTPS global + WAF Cloud Armor.
admin_ip_ranges[]CIDR exemptés des règles WAF.
application_domains[]Noms de domaine personnalisés pour le LB HTTPS.
enable_cdnfalseActive Cloud CDN sur le backend du LB.
max_images_to_retain / delete_untagged_images / image_retention_days(défini)Politique de nettoyage d'Artifact Registry.

Groupe 11 — Stockage et système de fichiers​

VariableValeur par défautDescription
create_cloud_storagetrueProvisionne des buckets supplémentaires définis dans storage_buckets. Le bucket de l'espace de travail est toujours créé.
storage_buckets[]Buckets GCS supplémentaires au-delà du bucket d'espace de travail auto-provisionné.
enable_nfsfalseOpenClaw utilise GCS Fuse pour l'état. NFS n'est pas requis et est désactivé par défaut.
gcs_volumes[]Montages GCS Fuse supplémentaires. Le volume openclaw-data à /data est toujours ajouté.
manage_storage_kms_iam / enable_artifact_registry_cmekfalseOptions CMEK.

Groupe 13 — Jobs et tâches planifiées​

VariableValeur par défautDescription
initialization_jobs[]OpenClaw n'a pas de job d'initialisation par défaut. Utilisez pour l'amorçage personnalisé de l'espace de travail.
cron_jobs[]Jobs Cloud Run récurrents déclenchés par Cloud Scheduler.

Groupe 14 — Observabilité et santé​

VariableValeur par défautDescription
startup_probe / startup_probe_configHTTP /health, seuil de 24 tentativesPermet environ 2 minutes pour le montage GCS Fuse et le démarrage de Node.js.
liveness_probe / health_check_configHTTP /healthRedémarre le conteneur si la passerelle ne répond plus.
uptime_check_config{ enabled = false, path = "/health" }Test de disponibilité Cloud Monitoring. Désactivé par défaut ; activez pour la surveillance de production.
alert_policies[]Politiques d'alerte métrique.

Groupe 15 — Configuration OpenClaw​

VariableValeur par défautDescription
skills_repo_url""URL GitHub d'un dépôt de compétences partagé. Cloné dans /data/workspace/skill-library à chaque démarrage du conteneur. Laissez vide pour ignorer.
skills_repo_refmainRéférence Git (branche, tag ou SHA) à extraire.
enable_telegramfalseProvisionne un secret de jeton de bot Telegram et injecte TELEGRAM_BOT_TOKEN. Nécessite telegram_bot_token.
telegram_bot_token""Jeton de bot Telegram de @BotFather. Sensible.
telegram_webhook_secret""Secret de validation de webhook pour le routeur (non injecté dans l'agent). Générer avec openssl rand -hex 32. Sensible.
enable_slackfalseConnecte l'agent à Slack via le mode Socket (WebSocket sortant — pas d'ingress ni de routeur). Provisionne les secrets Slack et injecte SLACK_BOT_TOKEN + SLACK_APP_TOKEN. Nécessite slack_bot_token et slack_app_token.
slack_bot_token""Jeton de bot Slack (xoxb-...). Sensible.
slack_app_token""Jeton au niveau de l'application Slack (xapp-..., portée connections:write) pour le mode Socket. Sensible.
slack_signing_secret""Optionnel. Secret de signature Slack pour un routeur d'URL de requête HTTP uniquement (non injecté ; le mode Socket ne l'utilise pas). Sensible.

5. Sorties​

Retourné lors d'un déploiement réussi — le moyen le plus rapide de localiser et d'explorer les ressources en cours d'exécution.

SortieDescription
service_nameNom du service Cloud Run.
service_urlURL run.app par défaut du service.
service_locationRégion dans laquelle le service s'exécute.
stage_servicesURL de service spécifiques à l'étape (Cloud Deploy).
storage_bucketsBuckets Cloud Storage créés (y compris le bucket de l'espace de travail).
network_name / network_exists / regionsRéseau VPC, présence, régions.
container_image / container_registryImage déployée et dépôt Artifact Registry.
monitoring_enabled / monitoring_notification_channels / uptime_check_namesÉtat de la surveillance, canaux, tests de disponibilité.
deployment_id / tenant_id / resource_prefixIdentifiants de nommage.
project_id / project_numberIdentifiants de projet.
initialization_jobsNoms des jobs d'initialisation personnalisés.
cicd_enabled / cicd_configurationÉtat et détails CI/CD.
github_repository_url / github_repository_owner / github_repository_nameDépôt GitHub connecté.
artifact_registry_repository / cloudbuild_trigger_name / cloudbuild_trigger_idRegistre et déclencheur de build.

6. Pièges de configuration et valeurs par défaut judicieuses​

Risque : Critique (perte de données / panne / sécurité) — Élevé (service dégradé) — Moyen (coût ou dégradation partielle) — Faible (mineur).

ParamètreValeur judicieuseRisqueConséquence en cas d'erreur
anthropic_api_keyDéfinir au premier déploiementCritiqueSans clé valide, l'agent démarre mais toutes les requêtes IA échouent avec des erreurs 401.
Cohérence gateway_tokenAuto-généré ou défini une foisCritiqueLa rotation du jeton dans Secret Manager sans redéployer le service entraîne le rejet de toutes les requêtes client jusqu'à ce que le service soit redéployé.
enable_backup_importfalse sauf en cas de restaurationCritiqueL'activation sans backup_uri valide fait échouer le job d'importation.
execution_environmentgen2ÉlevéGen1 ne prend pas en charge GCS Fuse ; le montage de l'espace de travail échoue silencieusement.
cpu_always_allocatedtrueÉlevéLa limitation du CPU interrompt les connexions WebSocket et les opérations d'agent asynchrones.
telegram_bot_token / slack_bot_tokendéfini lorsque l'intégration est activéeÉlevéUn jeton vide fait échouer tous les appels API ; les messages sont perdus.
telegram_webhook_secret / slack_signing_secretdéfini lorsque l'intégration est activéeÉlevéUne valeur vide désactive la vérification de la signature, permettant l'injection de faux webhooks.
min_instance_count1 pour les agents de productionÉlevé0 signifie que les événements de webhook de Telegram/Slack sont perdus pendant le démarrage à froid (15-20 s).
skills_repo_urlURL accessible ou videÉlevéUne URL inaccessible fait échouer le clone git au démarrage, redémarrant le conteneur.
skills_repo_refréférence existanteÉlevéUne branche ou un tag inexistant fait échouer le clone à chaque démarrage.
max_instance_count1 par locataireÉlevéPlusieurs instances pour le même locataire répartissent l'état de l'agent entre les réplicas.
enable_iapactiver pour l'administrationMoyenLa passerelle est autrement accessible à son URL run.app. Les points de terminaison de webhook Telegram/Slack ne peuvent pas s'authentifier avec l'identité Google — assurez-vous qu'ils ne sont pas derrière IAP.
backup_retention_days7 (augmenter pour la production)MoyenTrop court pour la conformité ; une purge accidentelle du bucket entraîne une perte permanente de l'état de l'agent.
enable_vpc_sc sans organization_iddéfini explicitementMoyenVPC-SC est silencieusement ignoré, laissant les identifiants sans protection périmétrique.

Pour le comportement de la fondation référencé tout au long — identité de service, mise à l'échelle et concurrence, ingress et équilibrage de charge, CI/CD, Cloud Armor, IAP, Binary Authorization, VPC-SC, sauvegardes et mise en miroir d'images — voir App_CloudRun. La configuration d'application spécifique à OpenClaw partagée avec la variante GKE est décrite dans OpenClaw_Common.

Need RAD to do something it does not do yet? Request it on the roadmap, or vote on what is already there.