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

Hosting

Raspberry Pi

Exécutez un Gateway OpenClaw persistant et toujours actif sur un Raspberry Pi. Comme le Pi sert uniquement de Gateway (les modèles s’exécutent dans le cloud via une API), même un Pi modeste gère bien la charge de travail — le coût matériel habituel est de 35 à 80 $ en une seule fois, sans frais mensuels.

Compatibilité matérielle

Modèle de Pi RAM Fonctionne ? Remarques
Pi 5 4/8 Go Idéal Le plus rapide, recommandé.
Pi 4 4 Go Bien Le meilleur compromis pour la plupart des utilisateurs.
Pi 4 2 Go Correct Ajoutez de l’espace d’échange.
Pi 4 1 Go Limite Possible avec de l’espace d’échange et une configuration minimale.
Pi 3B+ 1 Go Lent Fonctionne, mais avec lenteur.
Pi Zero 2 W 512 Mo Non Non recommandé.

Minimum : 1 Go de RAM, 1 cœur, 500 Mo d’espace disque libre, système d’exploitation 64 bits. Recommandé : au moins 2 Go de RAM, carte SD d’au moins 16 Go (ou SSD USB), Ethernet.

Prérequis

  • Raspberry Pi 4 ou 5 avec au moins 2 Go de RAM (4 Go recommandés)
  • Carte microSD (au moins 16 Go) ou SSD USB (meilleures performances)
  • Alimentation officielle pour Pi
  • Connexion réseau (Ethernet ou Wi-Fi)
  • Raspberry Pi OS 64 bits (obligatoire — n’utilisez pas la version 32 bits)
  • Environ 30 minutes

Configuration

  • Flasher le système d’exploitation

    Utilisez Raspberry Pi OS Lite (64-bit) — aucun environnement de bureau n’est nécessaire pour un serveur sans écran.

    1. Téléchargez Raspberry Pi Imager.
    2. Choisissez le système d’exploitation : Raspberry Pi OS Lite (64-bit).
    3. Dans la boîte de dialogue des paramètres, préconfigurez :
      • Nom d’hôte : gateway-host
      • Activez SSH
      • Définissez le nom d’utilisateur et le mot de passe
      • Configurez le Wi-Fi (si vous n’utilisez pas Ethernet)
    4. Flashez votre carte SD ou votre disque USB, insérez-le, puis démarrez le Pi.

  • Se connecter via SSH

    bash
    ssh user@gateway-host

  • Mettre à jour le système

    bash
    sudo apt update && sudo apt upgrade -ysudo apt install -y git curl build-essential # Définir le fuseau horaire (important pour cron et les rappels)sudo timedatectl set-timezone America/Chicago

  • Installer Node.js 24

    bash
    curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt install -y nodejsnode --version

  • Ajouter de l’espace d’échange (important avec 2 Go ou moins)

    bash
    sudo fallocate -l 2G /swapfilesudo chmod 600 /swapfilesudo mkswap /swapfilesudo swapon /swapfileecho '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab # Réduire la propension à utiliser l’espace d’échange sur les appareils disposant de peu de RAMecho 'vm.swappiness=10' | sudo tee -a /etc/sysctl.confsudo sysctl -p

  • Installer OpenClaw

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

  • Exécuter la configuration initiale

    bash
    openclaw onboard --install-daemon

    Suivez l’assistant. Les clés d’API sont recommandées plutôt qu’OAuth pour les appareils sans écran. Telegram est le canal le plus simple pour commencer.

  • Vérifier

    bash
    openclaw statussystemctl --user status openclaw-gateway.servicejournalctl --user -u openclaw-gateway.service -f

  • Accéder à l’interface de contrôle

    Sur votre ordinateur, obtenez une URL du tableau de bord depuis le Pi :

    bash
    ssh user@gateway-host 'openclaw dashboard --no-open'

    Créez ensuite un tunnel SSH dans un autre terminal :

    bash
    ssh -N -L 18789:127.0.0.1:18789 user@gateway-host

    Ouvrez l’URL affichée dans votre navigateur local. Pour un accès distant permanent, consultez l’intégration Tailscale.

    • Conseils de performance

    Utilisez un SSD USB — les cartes SD sont lentes et s’usent. Un SSD USB améliore considérablement les performances et supporte davantage de cycles d’écriture ; utilisez-le pour OPENCLAW_STATE_DIR si vous conservez le système d’exploitation sur la carte SD. Consultez le guide de démarrage USB du Pi.

    Activez le cache de compilation des modules — cela accélère les appels répétés à la CLI sur les hôtes Pi moins puissants. OPENCLAW_NO_RESPAWN=1 maintient les redémarrages courants du Gateway dans le même processus, évitant ainsi des transferts supplémentaires entre processus et simplifiant le suivi du PID sur les petits hôtes :

    bash
    grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secretexport NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cachemkdir -p /var/tmp/openclaw-compile-cacheexport OPENCLAW_NO_RESPAWN=1EOFsource ~/.bashrc

    Utilisez /var/tmp, et non /tmp — certaines distributions effacent /tmp au démarrage, ce qui supprime le cache préchauffé.

    Réduisez l’utilisation de la mémoire — pour les installations sans écran, libérez de la mémoire GPU et désactivez les services inutilisés :

    bash
    echo 'gpu_mem=16' | sudo tee -a /boot/config.txtsudo systemctl disable bluetooth

    Surcharge systemd pour des redémarrages stables — si ce Pi exécute principalement OpenClaw, ajoutez une surcharge au service :

    bash
    systemctl --user edit openclaw-gateway.service
    ini
    [Service]Environment=OPENCLAW_NO_RESPAWN=1Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cacheRestart=alwaysRestartSec=2TimeoutStartSec=90

    Exécutez ensuite systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. Sur un Pi sans écran, activez également une fois la persistance de session afin que le service utilisateur reste actif après la déconnexion : sudo loginctl enable-linger "$(whoami)".

    Configuration de modèle recommandée

    Comme le Pi exécute uniquement le Gateway, utilisez des modèles d’API hébergés dans le cloud — n’exécutez pas de LLM locaux sur un Pi, car même les petits modèles sont trop lents pour être utiles :

    json
    {  "agents": {    "defaults": {      "model": {        "primary": "anthropic/claude-sonnet-4-6",        "fallbacks": ["openai/gpt-5.4-mini"]      }    }  }}

    Remarques sur les binaires ARM

    La plupart des fonctionnalités d’OpenClaw fonctionnent sur ARM64 sans modification (Node.js, Telegram, WhatsApp/Baileys, Chromium). Les binaires pour lesquels une version ARM est parfois indisponible sont généralement des outils CLI facultatifs en Go ou Rust fournis par des Skills. Vérifiez l’architecture avec uname -m (qui doit afficher aarch64), puis consultez la page des versions du binaire manquant pour rechercher des artefacts linux-arm64 / aarch64 avant de vous rabattre sur une compilation depuis le code source.

    Persistance et sauvegardes

    L’état d’OpenClaw se trouve dans :

    • ~/.openclaw/ — openclaw.json, fichiers auth-profiles.json propres à chaque agent, état des canaux et fournisseurs, sessions.
    • ~/.openclaw/workspace/ — espace de travail de l’agent (SOUL.md, mémoire, artefacts).

    Ces données persistent après les redémarrages et bénéficient de l’utilisation d’un SSD plutôt que d’une carte SD, tant pour les performances que pour la longévité. Créez un instantané portable avec :

    bash
    openclaw backup create

    Dépannage

    Mémoire insuffisante — vérifiez que l’espace d’échange est actif avec free -h. Désactivez les services inutilisés (sudo systemctl disable cups bluetooth avahi-daemon). Utilisez uniquement des modèles accessibles via API.

    Performances lentes — utilisez un SSD USB plutôt qu’une carte SD. Vérifiez si le processeur est bridé avec vcgencmd get_throttled (la commande doit renvoyer 0x0).

    Le service ne démarre pas — consultez les journaux avec journalctl --user -u openclaw-gateway.service --no-pager -n 100 et exécutez openclaw doctor --non-interactive. S’il s’agit d’un Pi sans écran, vérifiez également que la persistance de session est activée : sudo loginctl enable-linger "$(whoami)".

    Problèmes de binaires ARM — si une skill échoue avec « exec format error », vérifiez si le binaire dispose d’une version ARM64. Vérifiez l’architecture avec uname -m (qui doit afficher aarch64).

    Déconnexions Wi-Fi — désactivez la gestion de l’alimentation Wi-Fi : sudo iwconfig wlan0 power off.

    Étapes suivantes

    Pages connexes

    Was this useful?
    On this page

    On this page