Aller au contenu
OpenClaw Docs

DigitalOcean

Exécutez un OpenClaw Gateway persistant sur un Droplet DigitalOcean (environ 6 $/mois pour le plan Basic de 1 Go).

DigitalOcean est le chemin VPS payant le plus simple. Si vous préférez des options moins chères ou gratuites :

  • Hetzner — 3,79 €/mois, plus de cœurs/RAM par dollar.
  • Oracle Cloud — Always Free ARM (jusqu’à 4 OCPU, 24 Go de RAM), mais l’inscription peut être capricieuse et limitée à ARM.

Prérequis

Section intitulée « Prérequis »
  • Compte DigitalOcean (inscription)
  • Paire de clés SSH (ou volonté d’utiliser l’authentification par mot de passe)
  • Environ 20 minutes

Configuration

Section intitulée « Configuration »

  1. Créer un Droplet

    1. Connectez-vous à DigitalOcean.
    2. Cliquez sur Create > Droplets.
    3. Choisissez :
      • Region : La plus proche de chez vous
      • Image : Ubuntu 24.04 LTS
      • Size : Basic, Regular, 1 vCPU / 1 Go de RAM / 25 Go SSD
      • Authentication : Clé SSH (recommandé) ou mot de passe
    4. Cliquez sur Create Droplet et notez l’adresse IP.

  2. Se connecter et installer

    Fenêtre de terminal
    ssh root@YOUR_DROPLET_IP
    

    apt update && apt upgrade -y
    

    # Install Node.js 24
    curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
    apt install -y nodejs
    

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

    # Create the non-root user that will own OpenClaw state and services.
    adduser openclaw
    usermod -aG sudo openclaw
    loginctl enable-linger openclaw
    

    su - openclaw
    openclaw --version

    N’utilisez le shell root que pour l’amorçage du système. Exécutez les commandes OpenClaw en tant qu’utilisateur openclaw non root afin que l’état soit stocké sous /home/openclaw/.openclaw/ et que le Gateway s’installe en tant que service systemd de cet utilisateur.

  3. Exécuter l'intégration

    Fenêtre de terminal
    openclaw onboard --install-daemon

    L’assistant vous guide à travers l’authentification du modèle, la configuration du canal, la génération de jetons de passerelle et l’installation du démon (systemd).

  4. Ajouter du swap (recommandé pour les Droplets de 1 Go)

    Fenêtre de terminal
    fallocate -l 2G /swapfile
    chmod 600 /swapfile
    mkswap /swapfile
    swapon /swapfile
    echo '/swapfile none swap sw 0 0' >> /etc/fstab

  5. Vérifier la passerelle

    bash openclaw status systemctl --user status openclaw-gateway.service journalctl --user -u openclaw-gateway.service -f

  6. Accéder à l'interface de contrôle

    Par défaut, la passerelle est liée à l’adresse locale (loopback). Choisissez l’une de ces options.

    Option A : Tunnel SSH (le plus simple)

    Fenêtre de terminal
    # From your local machine
    ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP

    Puis ouvrez http://localhost:18789Tailscale.

    Option B : Tailscale Serve

    Fenêtre de terminal
    curl -fsSL https://tailscale.com/install.sh | sudo sh
    sudo tailscale up
    openclaw config set gateway.tailscale.mode serve
    openclaw gateway restart

    Puis ouvrez `https://

    /`TailscaleAPI depuis n’importe quel appareil de votre tailnet.

    Tailscale Serve authentifie le trafic de l'interface de contrôle et des WebSockets via les en-têtes d'identité du tailnet, ce qui suppose que l'hôte de la passerelle lui-même est fiable. Les points de terminaison de l'HTTP API suivent le mode d'authentification normal de la passerelle (jeton/mot de passe) quoi qu'il en soit. Pour exiger des identifiants de secret partagé explicites via Serve, définissez `gateway.auth.allowTailscale: false` et utilisez `gateway.auth.mode: "token"` ou `"password"`.
    

    **Option C : Liaison Tailnet (sans Serve)**
    

    ```bash
    openclaw config set gateway.bind tailnet
    openclaw gateway restart
    ```
    

    Puis ouvrez `http://

    :18789` (jeton requis).

Persistance et sauvegardes

Section intitulée « Persistance et sauvegardes »

L’état d’OpenClaw se trouve sous :

  • ~/.openclaw/ — openclaw.json, auth-profiles.json par agent, état du channel/fournisseur, et données de session.
  • ~/.openclaw/workspace/ — l’espace de travail de l’agent (SOUL.md, mémoire, artefacts).

Ces éléments survivent aux redémarrages du Droplet. Pour créer un instantané portable :

Fenêtre de terminal
openclaw backup create

Les instantanés DigitalOcean sauvegardent l’intégralité du Droplet ; DigitalOceanopenclaw backup create est portable entre les hôtes.

Conseils pour 1 Go de RAM

Section intitulée « Conseils pour 1 Go de RAM »

Le Droplet à 6 $ n’a que 1 Go de RAM. Pour garder le système fluide :

  • Assurez-vous que l’étape de swap ci-dessus est dans /etc/fstab afin qu’elle survive aux redémarrages.
  • Préférez les modèles basés sur une API (Claude, GPT) aux modèles locaux — l’inférence locale de LLM ne tient pas dans 1 Go.
  • Réglez agents.defaults.model.primary sur un modèle plus petit si vous rencontrez des erreurs de mémoire (OOM) sur de grandes invites.
  • Surveillez avec free -h et htop.

Dépannage

Section intitulée « Dépannage »

Le Gateway ne démarre pas — Exécutez openclaw doctor --non-interactive et vérifiez les journaux avec journalctl --user -u openclaw-gateway.service -n 50.

Port déjà utilisé — Exécutez lsof -i :18789 pour trouver le processus, puis arrêtez-le.

Mémoire insuffisante — Vérifiez que le swap est actif avec free -h. Si vous rencontrez toujours des erreurs OOM, utilisez des modèles basés sur une API (Claude, GPT) plutôt que des modèles locaux, ou passez à un Droplet de 2 Go.

Étapes suivantes

Section intitulée « Étapes suivantes »

Connexes

Section intitulée « Connexes »