Installer et configurer le Gateway

À retenir — Installer OpenClaw tient en trois temps : un paquet npm global, la commande d'onboarding qui installe le daemon, puis une config où chaque secret est référencé par variable d'environnement.

Installation

OpenClaw se distribue comme un paquet npm global. Vérifiez d'abord votre version de Node, puis installez :

# Node 24 recommandé (22.19+ accepté)
node --version

# Installation globale d'OpenClaw
npm install -g openclaw@latest

# Vérifier que la CLI répond
openclaw --version

Onboarding et installation du daemon

Le Gateway est conçu pour tourner en permanence. La commande d'onboarding vous guide pas à pas et installe le service système :

openclaw onboard --install-daemon

Cet assistant fait trois choses : il crée la configuration initiale, il connecte un premier provider LLM, et il installe le Gateway comme daemon (service qui redémarre tout seul). Sans configuration manuelle, OpenClaw démarre déjà avec un agent par défaut et des sessions par expéditeur.

Daemon = disponibilité permanente

Installer le Gateway en daemon, c'est ce qui permet à votre agent de répondre à 3 h du matin sur Telegram sans que votre terminal soit ouvert. Le service redémarre automatiquement au reboot de la machine.

Le tableau de bord

OpenClaw fournit une interface de contrôle web pour visualiser l'état du Gateway, les agents et les canaux :

openclaw dashboard

Le tableau de bord est accessible en local sur http://127.0.0.1:18789/. À distance, on l'expose via une surface web ou un réseau privé type Tailscale (voir le chapitre 4 pour le faire proprement).

Le fichier de configuration

Toute la configuration vit dans un seul fichier :

~/.openclaw/openclaw.json

Il est au format JSON5 (commentaires et virgules finales autorisés), ce qui le rend agréable à éditer à la main. C'est ici que vous décrivez vos providers, vos agents et vos canaux. On peut l'éditer directement, ou appliquer des modifications par patch :

# Appliquer un fragment de config depuis un fichier
openclaw config patch --file ./mon-patch.json5

Une seule source de vérité

openclaw.json centralise tout. Versionnez-le dans Git (en gardant les secrets à l'écart, voir plus bas) pour suivre l'évolution de votre configuration et la restaurer en cas de pépin.

Connecter un provider LLM

OpenClaw référence les modèles au format provider/model (par exemple anthropic/claude-opus-4-8, openai/gpt-5.4, ollama/llama3). Les clés API ne sont jamais écrites en clair dans la config : on les déclare comme des références vers des variables d'environnement.

Le pattern est le même partout — un objet { source, provider, id } qui pointe vers une variable d'env :

{
  // Clé exposée comme variable d'environnement, jamais en dur
  providers: {
    anthropic: {
      apiKey: { source: "env", provider: "default", id: "ANTHROPIC_API_KEY" },
    },
  },
}

Côté shell, vous fournissez la valeur réelle via l'environnement :

export ANTHROPIC_API_KEY="sk-ant-..."

Pour piloter le modèle utilisé lors d'un tour, on passe --model au format provider/model :

openclaw agent --agent main --model anthropic/claude-opus-4-8 --message "Bonjour"

Les secrets ne se commitent pas

La règle d'or : la config (openclaw.json) décrit où trouver la clé (id: "ANTHROPIC_API_KEY"), jamais sa valeur. La valeur vit dans l'environnement ou un gestionnaire de secrets. On y revient au chapitre 4.

Premier lancement et test

Une fois le provider branché, démarrez le Gateway et envoyez un premier message à l'agent par défaut :

# Démarrer le Gateway (si pas déjà en daemon)
openclaw gateway

# Dans un autre terminal : un tour de conversation en local
openclaw agent --agent main --message "Résume-moi ce que tu sais faire" --local

Le flag --local force l'exécution de l'agent embarqué directement, sans passer par un canal — pratique pour tester. Ajoutez --json pour obtenir une réponse structurée, ou --verbose on pour des logs détaillés sur la session.

À retenir

L'installation tient en trois temps : npm install -g openclaw@latest, puis openclaw onboard --install-daemon pour mettre en place le service, et enfin la configuration dans ~/.openclaw/openclaw.json. Les providers se branchent au format provider/model avec des clés référencées par variable d'environnement, jamais en clair. Un openclaw agent --local --message "..." valide que tout fonctionne. Au chapitre suivant, on crée des agents spécialisés et on les connecte à de vrais canaux.