GCP

Exécutez un OpenClaw Gateway persistant sur une VM Compute Engine GCP en utilisant Docker, avec un état durable, des binaires intégrés et un comportement de redémarrage sûr.

Si vous voulez “OpenClaw 24/7 pour ~$5-12/mo”, c’est une configuration fiable sur Google Cloud. La tarification varie selon le type de machine et la région ; choisissez la plus petite VM adaptée à votre charge de travail et augmentez l’échelle si vous rencontrez des erreurs de mémoire insuffisante (OOM).

Que faisons-nous (termes simples) ?

Créez un projet GCP et activez la facturation
Créez une VM Compute Engine
Installez Docker (environnement d’exécution d’application isolé)
Démarrez le OpenClaw Gateway dans Docker
Rendez persistant ~/.openclaw + ~/.openclaw/workspace sur l’hôte (survit aux redémarrages/reconstructions)
Accédez à l’interface de contrôle depuis votre ordinateur portable via un tunnel SSH

Cet état ~/.openclaw monté inclut openclaw.json, agents/<agentId>/agent/auth-profiles.json par agent, et .env.

Le Gateway est accessible via :

Transfert de port SSH depuis votre ordinateur portable
Exposition directe du port si vous gérez vous-même le pare-feu et les jetons

Ce guide utilise Debian sur Compute Engine GCP. Ubuntu fonctionne également ; adaptez les packages en conséquence. Pour le flux générique Docker, voir Docker.

Chemin rapide (opérateurs expérimentés)

Créez un projet GCP + activez l’API Compute Engine
Créez une VM Compute Engine (e2-small, Debian 12, 20 Go)
Connectez-vous en SSH à la VM
Installez Docker
Clonez le dépôt OpenClaw
Créez des répertoires persistants sur l’hôte
Configurez .env et docker-compose.yml
Intégrez les binaires requis, construisez et lancez

Ce dont vous avez besoin

Compte GCP (éligible au niveau gratuit pour e2-micro)
gcloud CLI installé (ou utilisez Cloud Console)
Accès SSH depuis votre ordinateur portable
Confort de base avec SSH + copier/coller
~20-30 minutes
Docker et Docker Compose
Identifiants d’authentification du modèle
Identifiants de fournisseur facultatifs
- QR WhatsApp
- Jeton de bot Telegram
- OAuth Gmail

Installer la gcloud CLI (ou utiliser la Console)
Option A : gcloud CLI (recommandé pour l’automatisation)

Installer à partir de https://cloud.google.com/sdk/docs/install

Initialiser et authentifier :
Fenêtre de terminal
```
gcloud init
gcloud auth login
```
Option B : Cloud Console

Toutes les étapes peuvent être effectuées via l’interface Web sur https://console.cloud.google.com
Créer un projet GCP
CLI :
Fenêtre de terminal
```
gcloud projects create my-openclaw-project --name="OpenClaw Gateway"
gcloud config set project my-openclaw-project
```
Activer la facturation sur https://console.cloud.google.com/billing (requis pour Compute Engine).

Activer le Compute Engine API :
Fenêtre de terminal
```
gcloud services enable compute.googleapis.com
```
Console :
1. Aller dans IAM et administration > Créer un projet
2. Nommer le projet et le créer
3. Activer la facturation pour le projet
4. Naviguer vers API et services > Activer les API > rechercher “Compute Engine API” > Activer

Créer la VM

Types de machines :

Type	Spécifications	Coût	Notes
e2-medium	2 vCPU, 4 Go RAM	~25 $/mo	Le plus fiable pour les builds Docker locaux
e2-small	2 vCPU, 2 Go RAM	~12 $/mo	Minimum recommandé pour le build Docker
e2-micro	2 vCPU (partagés), 1 Go RAM	Éligible au niveau gratuit	Échoue souvent avec le build Docker OOM (exit 137)

CLI :

gcloud compute instances create openclaw-gateway \
  --zone=us-central1-a \
  --machine-type=e2-small \
  --boot-disk-size=20GB \
  --image-family=debian-12 \
  --image-project=debian-cloud

Console :

Aller dans Compute Engine > Instances de VM > Créer une instance
Nom : openclaw-gateway
Région : us-central1, Zone : us-central1-a
Type de machine : e2-small
Disque de démarrage : Debian 12, 20 Go
Créer

SSH dans la VM
CLI :
Fenêtre de terminal
```
gcloud compute ssh openclaw-gateway --zone=us-central1-a
```
Console :

Cliquez sur le bouton “SSH” à côté de votre VM dans le tableau de bord Compute Engine.

Remarque : La propagation de la clé SSH peut prendre 1 à 2 minutes après la création de la VM. Si la connexion est refusée, attendez et réessayez.

Installer Docker (sur la VM)

sudo apt-get update
sudo apt-get install -y git curl ca-certificates
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER

Déconnectez-vous puis reconnectez-vous pour que le changement de groupe prenne effet :

exit

Puis SSH à nouveau :

gcloud compute ssh openclaw-gateway --zone=us-central1-a

Vérifiez :

docker --version
docker compose version

Cloner le dépôt OpenClaw
Fenêtre de terminal
```
git clone https://github.com/openclaw/openclaw.git
cd openclaw
```
Ce guide suppose que vous allez construire une image personnalisée pour garantir la persistance des binaires.
Créer des répertoires persistants sur l'hôte
Les conteneurs Docker sont éphémères. Tout état de longue durée doit résider sur l’hôte.
Fenêtre de terminal
```
mkdir -p ~/.openclaw
mkdir -p ~/.openclaw/workspace
```
Configurer les variables d'environnement
Créez .env à la racine du dépôt.
Fenêtre de terminal
```
OPENCLAW_IMAGE=openclaw:latest
OPENCLAW_GATEWAY_TOKEN=
OPENCLAW_GATEWAY_BIND=lan
OPENCLAW_GATEWAY_PORT=18789

OPENCLAW_CONFIG_DIR=/home/$USER/.openclaw
OPENCLAW_WORKSPACE_DIR=/home/$USER/.openclaw/workspace

GOG_KEYRING_PASSWORD=
XDG_CONFIG_HOME=/home/node/.openclaw
```
Définissez OPENCLAW_GATEWAY_TOKEN lorsque vous souhaitez gérer le jeton de passerelle stable via .env ; sinon configurez gateway.auth.token avant de dépendre des clients après les redémarrages. Si aucune source n’existe, OpenClaw utilise un jeton d’exécution uniquement pour ce démarrage. Générez un mot de passe de trousseau et collez-le dans GOG_KEYRING_PASSWORD :
Fenêtre de terminal
```
openssl rand -hex 32
```
Ne commitez pas ce fichier.

Ce fichier .env est pour l’environnement de conteneur/d’exécution tel que OPENCLAW_GATEWAY_TOKEN. L’authentification stockée du fournisseur OAuth/clé API réside dans le `~/.openclaw/agents/
/agent/auth-profiles.json` monté.

DockerConfiguration Docker Compose

Créez ou mettez à jour docker-compose.yml.

services:
  openclaw-gateway:
    image: ${OPENCLAW_IMAGE}
    build: .
    restart: unless-stopped
    env_file:
      - .env
    environment:
      - HOME=/home/node
      - NODE_ENV=production
      - TERM=xterm-256color
      - OPENCLAW_GATEWAY_BIND=${OPENCLAW_GATEWAY_BIND}
      - OPENCLAW_GATEWAY_PORT=${OPENCLAW_GATEWAY_PORT}
      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
      - GOG_KEYRING_PASSWORD=${GOG_KEYRING_PASSWORD}
      - XDG_CONFIG_HOME=${XDG_CONFIG_HOME}
      - PATH=/home/linuxbrew/.linuxbrew/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
    volumes:
      - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw
      - ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace
    ports:
      # Recommended: keep the Gateway loopback-only on the VM; access via SSH tunnel.
      # To expose it publicly, remove the `127.0.0.1:` prefix and firewall accordingly.
      - "127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789"
    command:
      [
        "node",
        "dist/index.js",
        "gateway",
        "--bind",
        "${OPENCLAW_GATEWAY_BIND}",
        "--port",
        "${OPENCLAW_GATEWAY_PORT}",
        "--allow-unconfigured",
      ]

--allow-unconfigured n’est destiné qu’à la commodité du démarrage initial, il ne remplace pas une configuration de passerelle appropriée. Définissez toujours l’authentification (gateway.auth.token ou mot de passe) et utilisez des paramètres de liaison sûrs pour votre déploiement.

DockerÉtapes d'exécution VM partagée Docker
Utilisez le guide d’exécution partagée pour le flux d’hôte Docker courant :

<Step title=“GCPNotes de lancement spécifiques au GCP”GCP> Sur GCP, si la construction échoue avec Killed ou exit code 137 pendant pnpm install --frozen-lockfile, la VM n’a plus de mémoire. Utilisez e2-small minimum, ou e2-medium pour des premières constructions plus fiables.

Lors de la liaison au LAN (`OPENCLAW_GATEWAY_BIND=lan`), configurez une origine de navigateur approuvée avant de continuer :

```bash
docker compose run --rm openclaw-cli config set gateway.controlUi.allowedOrigins '["http://127.0.0.1:18789"]' --strict-json
```

Si vous avez modifié le port de la passerelle, remplacez `18789` par votre port configuré.

Accès depuis votre ordinateur portable

Créez un tunnel SSH pour transférer le port du Gateway :

gcloud compute ssh openclaw-gateway --zone=us-central1-a -- -L 18789:127.0.0.1:18789

Ouvrez dans votre navigateur :

http://127.0.0.1:18789/

Réimprimez un lien propre vers le tableau de bord :

docker compose run --rm openclaw-cli dashboard --no-open

Si l’interface utilisateur demande une authentification par secret partagé, collez le jeton ou le mot de passe configuré dans les paramètres de l’interface de contrôle. Ce flux Docker écrit un jeton par défaut ; si vous modifiez la configuration du conteneur pour utiliser une authentification par mot de passe, utilisez plutôt ce mot de passe.

Si l’interface de contrôle affiche unauthorized ou disconnected (1008): pairing required, approuvez l’appareil du navigateur :

docker compose run --rm openclaw-cli devices list
docker compose run --rm openclaw-cli devices approve

Vous avez besoin à nouveau de la référence de persistance partagée et de mise à jour ?
Voir [Docker VM Runtime](/fr/install/docker-vm-runtime#what-persists-where) et [Mises à jour du runtime de VM Docker](/fr/install/docker-vm-runtime#updates).

Dépannage

Connexion SSH refusée

La propagation de la clé SSH peut prendre 1 à 2 minutes après la création de la VM. Attendez et réessayez.

Problèmes de connexion OS

Vérifiez votre profil de connexion OS :

gcloud compute os-login describe-profile

Assurez-vous que votre compte dispose des autorisations IAM requises (Compute OS Login ou Compute OS Admin Login).

Mémoire insuffisante (OOM)

Si la build Docker échoue avec Killed et exit code 137, la VM a été arrêtée pour manque de mémoire. Passez à e2-small (minimum) ou e2-medium (recommandé pour des builds locales fiables) :

# Stop the VM first
gcloud compute instances stop openclaw-gateway --zone=us-central1-a

# Change machine type
gcloud compute instances set-machine-type openclaw-gateway \
  --zone=us-central1-a \
  --machine-type=e2-small

# Start the VM
gcloud compute instances start openclaw-gateway --zone=us-central1-a

Comptes de service (bonne pratique de sécurité)

Pour un usage personnel, votre compte utilisateur par défaut fonctionne parfaitement.

Pour l’automatisation ou les pipelines CI/CD, créez un compte de service dédié avec des autorisations minimales :

Créez un compte de service :

gcloud iam service-accounts create openclaw-deploy \
  --display-name="OpenClaw Deployment"

Accordez le rôle Administrateur d’instance de calcul (ou un rôle personnalisé plus restreint) :

gcloud projects add-iam-policy-binding my-openclaw-project \
  --member="serviceAccount:[email protected]" \
  --role="roles/compute.instanceAdmin.v1"

Évitez d’utiliser le rôle Propriétaire pour l’automatisation. Appliquez le principe du moindre privilège.

Voir https://cloud.google.com/iam/docs/understanding-roles pour les détails sur les rôles IAM.

Étapes suivantes

Configurez les canaux de messagerie : Canaux
Associez des appareils locaux en tant que nœuds : Nœuds
Configurez le Gateway : Configuration du Gateway

GCP