OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Hosting

exe.dev

Objectif : faire fonctionner le Gateway OpenClaw sur une VM exe.dev, accessible à l’adresse https://<vm-name>.exe.xyz.

Ce guide suppose l’utilisation de l’image exeuntu par défaut d’exe.dev. Adaptez les paquets en conséquence sur les autres distributions.

Prérequis

  • Un compte exe.dev
  • Un accès ssh exe.dev aux VM exe.dev (facultatif, pour une configuration manuelle)

Parcours rapide pour débutants

  1. Ouvrez https://exe.new/openclaw
  2. Renseignez votre clé ou jeton d’authentification selon les besoins
  3. Cliquez sur "Agent" à côté de votre VM et attendez que Shelley termine le provisionnement
  4. Ouvrez https://<vm-name>.exe.xyz/ et authentifiez-vous avec le secret partagé configuré (authentification par jeton par défaut ; l’authentification par mot de passe fonctionne également si vous modifiez gateway.auth.mode)
  5. Approuvez les demandes d’association d’appareils en attente avec openclaw devices approve <requestId>

Installation automatisée avec Shelley

Shelley, l’agent d’exe.dev, peut installer OpenClaw à partir d’une invite :

text
Set up OpenClaw (https://docs.openclaw.ai/install) on this VM. Use the non-interactive and accept-risk flags for openclaw onboarding. Add the supplied auth or token as needed. Configure nginx to forward from the default port 18789 to the root location on the default enabled site config, making sure to enable Websocket support. Pairing is done by "openclaw devices list" and "openclaw devices approve <request id>". Make sure the dashboard shows that OpenClaw's health is OK. exe.dev handles forwarding from port 8000 to port 80/443 and HTTPS for us, so the final "reachable" should be <vm-name>.exe.xyz, without port specification.

Installation manuelle

  • Create the VM

    Depuis votre appareil :

    bash
    ssh exe.dev new

    Connectez-vous ensuite :

    bash
    ssh <vm-name>.exe.xyz

  • Install prerequisites (on the VM)

    bash
    sudo apt-get updatesudo apt-get install -y git curl jq ca-certificates openssl

  • Install OpenClaw

    bash
    curl -fsSL https://openclaw.ai/install.sh | bash

  • Configure nginx to proxy to port 8000

    Modifiez /etc/nginx/sites-enabled/default :

    nginx
    server {    listen 80 default_server;    listen [::]:80 default_server;    listen 8000;    listen [::]:8000;     server_name _;     location / {        proxy_pass http://127.0.0.1:18789;        proxy_http_version 1.1;         # WebSocket support        proxy_set_header Upgrade $http_upgrade;        proxy_set_header Connection "upgrade";         # Standard proxy headers        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $remote_addr;        proxy_set_header X-Forwarded-Proto $scheme;         # Timeout settings for long-lived connections        proxy_read_timeout 86400s;        proxy_send_timeout 86400s;    }}

    Remplacez les en-têtes de transfert au lieu de conserver les chaînes fournies par le client. OpenClaw n’accorde sa confiance aux métadonnées d’adresse IP transférées que lorsqu’elles proviennent de proxys explicitement configurés, et les chaînes X-Forwarded-For construites par ajout successif sont considérées comme un risque pour le durcissement de la sécurité.

  • Access OpenClaw and approve devices

    Ouvrez https://<vm-name>.exe.xyz/ (consultez la sortie de l’interface de contrôle lors de la configuration initiale). Si une authentification est demandée, collez le secret partagé configuré sur la VM.

    Ce guide utilise l’authentification par jeton par défaut. Récupérez donc gateway.auth.token avec openclaw config get gateway.auth.token, ou générez-en un nouveau avec openclaw doctor --n. Si vous avez configuré le Gateway pour utiliser l’authentification par mot de passe, utilisez plutôt gateway.auth.password / OPENCLAW_GATEWAY_PASSWORD.

    Approuvez les appareils avec openclaw devices list et openclaw devices approve <requestId>. En cas de doute, utilisez Shelley depuis votre navigateur.

    • Configuration des canaux à distance

    Pour les hôtes distants, privilégiez un seul appel à config patch plutôt que de nombreux appels SSH à config set. Conservez les véritables jetons dans l’environnement de la VM ou dans ~/.openclaw/.env, et placez uniquement des SecretRefs dans openclaw.json. Consultez Gestion des secrets pour connaître le contrat SecretRef complet.

    Sur la VM, ajoutez au contexte d’exécution du service les secrets dont il a besoin :

    bash
    cat >> ~/.openclaw/.env <<'EOF'SLACK_BOT_TOKEN=xoxb-...SLACK_APP_TOKEN=xapp-...DISCORD_BOT_TOKEN=...OPENAI_API_KEY=sk-...EOF

    Depuis votre machine locale, créez un fichier de correctif et transmettez-le à la VM par un tube :

    json5
    // openclaw.remote.patch.json5{  secrets: {    providers: {      default: { source: "env" },    },  },  channels: {    slack: {      enabled: true,      mode: "socket",      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },      groupPolicy: "open",      requireMention: false,    },    discord: {      enabled: true,      token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" },      dmPolicy: "disabled",      dm: { enabled: false },      groupPolicy: "allowlist",    },  },  agents: {    defaults: {      model: { primary: "openai/gpt-5.6-sol" },      models: {        "openai/gpt-5.6-sol": { params: { fastMode: true } },      },    },  },}
    bash
    ssh <vm-name>.exe.xyz 'openclaw config patch --stdin --dry-run' < ./openclaw.remote.patch.json5ssh <vm-name>.exe.xyz 'openclaw config patch --stdin' < ./openclaw.remote.patch.json5ssh <vm-name>.exe.xyz 'openclaw gateway restart && openclaw health'

    Utilisez --replace-path lorsqu’une liste d’autorisation imbriquée doit correspondre exactement à la valeur du correctif, par exemple pour remplacer la liste d’autorisation d’un canal Discord :

    bash
    ssh <vm-name>.exe.xyz 'openclaw config patch --stdin --replace-path "channels.discord.guilds[\"123\"].channels"' < ./discord.patch.json5

    Consultez Discord et Slack pour obtenir la documentation complète de la configuration des canaux.

    Accès distant

    exe.dev gère l’authentification pour l’accès distant. Par défaut, le trafic HTTP du port 8000 est transféré vers https://<vm-name>.exe.xyz avec une authentification par e-mail.

    Mise à jour

    bash
    openclaw update

    Consultez Mise à jour pour le changement de canal et la récupération manuelle.

    Pages connexes

    Was this useful?
    On this page

    On this page