Passer au contenu principal
EasyRunner peut héberger le Gateway OpenClaw sous forme de petite application conteneurisée derrière son proxy Caddy. Ce guide suppose un hôte EasyRunner qui exécute des applications Compose compatibles avec Podman et expose HTTPS via Caddy.

​
Avant de commencer

  • Un serveur EasyRunner avec un domaine qui pointe vers lui.
  • Une image de conteneur OpenClaw construite ou publiée.
  • Un volume de configuration persistant pour /home/node/.openclaw.
  • Un volume d’espace de travail persistant pour /workspace.
  • Un jeton ou mot de passe Gateway robuste.
Gardez l’authentification des appareils activée lorsque c’est possible. Si votre déploiement de proxy inverse ne peut pas transmettre correctement l’identité de l’appareil, corrigez d’abord les paramètres de proxy approuvé ; n’utilisez les contournements d’authentification dangereux que pour un réseau entièrement privé et contrôlé par l’opérateur.

​
Application Compose

Créez une application EasyRunner avec un fichier Compose structuré comme ceci : 
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    restart: unless-stopped
    environment:
      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
      OPENCLAW_HOME: /home/node
      OPENCLAW_STATE_DIR: /home/node/.openclaw
      OPENCLAW_CONFIG_PATH: /home/node/.openclaw/openclaw.json
      OPENCLAW_WORKSPACE_DIR: /workspace
    volumes:
      - openclaw-config:/home/node/.openclaw
      - openclaw-workspace:/workspace
    labels:
      caddy: openclaw.example.com
      caddy.reverse_proxy: "{{upstreams 1455}}"
    command: ["openclaw", "gateway", "--bind", "lan", "--port", "1455"]

volumes:
  openclaw-config:
  openclaw-workspace:
Remplacez openclaw.example.com par le nom d’hôte de votre Gateway. Stockez OPENCLAW_GATEWAY_TOKEN dans le gestionnaire de secrets/environnement d’EasyRunner au lieu de le valider dans la définition de l’application.

​
Configurer OpenClaw

Dans le volume de configuration persistant, gardez le Gateway accessible uniquement via le proxy et exigez l’authentification : 
{
  gateway: {
    bind: "lan",
    port: 1455,
    auth: {
      token: "${OPENCLAW_GATEWAY_TOKEN}",
    },
  },
}
Si Caddy termine TLS pour le Gateway, configurez les paramètres de proxy approuvé pour le chemin de proxy exact plutôt que de désactiver globalement les vérifications d’authentification. Consultez Authentification par proxy approuvé.

​
Vérifier

Depuis votre poste de travail : 
openclaw gateway probe --url https://openclaw.example.com --token <token>
openclaw gateway status --url https://openclaw.example.com --token <token>
Depuis l’hôte EasyRunner, vérifiez dans les journaux de l’application que le Gateway est à l’écoute et qu’il n’y a aucun échec au démarrage lié à SecretRef, aux Plugins ou à l’authentification des canaux.

​
Mises à jour et sauvegardes

  • Récupérez ou construisez la nouvelle image OpenClaw, puis redéployez l’application EasyRunner.
  • Sauvegardez le volume openclaw-config avant les mises à jour.
  • Sauvegardez openclaw-workspace si les agents y écrivent des données de projet durables.
  • Exécutez openclaw doctor après les mises à jour majeures pour détecter les migrations de configuration et les avertissements de service.

​
Dépannage

  • gateway probe ne peut pas se connecter : confirmez que le nom d’hôte Caddy pointe vers l’application et que le conteneur écoute sur 0.0.0.0:1455.
  • L’authentification échoue : effectuez une rotation du jeton dans les secrets EasyRunner et dans la commande du client local en même temps.
  • Les fichiers appartiennent à root après la restauration : réparez les volumes montés afin que l’utilisateur du conteneur puisse écrire dans /home/node/.openclaw et /workspace.
  • Les Plugins de navigateur ou de canal échouent : vérifiez si les binaires externes requis, la sortie réseau et les identifiants montés sont disponibles dans le conteneur.