Installation d’OpenClaw et configuration d’OmniProxy

OpenClaw est un assistant IA installé sur votre propre ordinateur. Vous pouvez lui parler directement dans Telegram, Discord, WhatsApp ou Lark, sans devoir garder une autre fenêtre de discussion ouverte. Les conversations et leur historique restent sur cet ordinateur, où OpenClaw peut également exécuter les étapes suivantes.

Préparation avant l’installation

OpenClaw nécessite Node 24.16 ou une version ultérieure. Vous pouvez également utiliser Node 26.1 ou une version ultérieure ; Node 26 est recommandé. Node constitue l’environnement de base nécessaire à l’exécution d’OpenClaw.

L’installation est possible sous macOS, Linux et Windows. Si aucune version compatible de Node n’est présente sur l’ordinateur, le script d’installation la prépare automatiquement : Node 26 sous macOS et Node 24 LTS sous Linux. pnpm n’est nécessaire que pour compiler OpenClaw depuis le code source.

Si une ancienne version de Node est déjà installée, il n’est pas nécessaire de la désinstaller immédiatement. Lors du test du 2026-10-09, la version système de Node sur cet ordinateur était la 24.2.0, donc inférieure à la version 24.16 requise. Le script d’installation non interactif a préparé automatiquement Node 24.21.0.

Pour une interface graphique

Application de bureau

Sous Windows, utiliser le programme d’installation Hub
Sous macOS, utiliser le DMG de GitHub
Une passerelle locale peut être installée au premier lancement

Méthode officiellement recommandée

Script d’installation

macOS, Linux et WSL2
Sous Windows, utiliser PowerShell
L’option --no-onboard peut être ajoutée

Node est déjà installé

Gestionnaire de paquets

npm, pnpm ou bun
Puis exécuter onboard
Consulter la page d’installation pour la version de Node

Téléchargez l’application compagnon de bureau si vous souhaitez une interface graphique. Si vous utilisez uniquement le terminal, exécutez le script d’installation officiel.

Installation et premier démarrage

Vous pouvez installer l’application compagnon de bureau dotée d’une interface graphique, ou procéder directement depuis le terminal. Gateway est le service local chargé de recevoir les messages, d’appeler le modèle et de renvoyer les résultats. Vous pouvez le préparer lors du premier lancement de l’application compagnon de bureau.

Pour disposer d’une interface graphique

Windows : téléchargez et exécutez OpenClawCompanion-Setup-x64.exe ou OpenClawCompanion-Setup-arm64.exe. Le programme d’installation est signé et comprend les réglages, l’état dans la zone de notification, la messagerie et le mode node.
macOS : téléchargez le fichier .dmg d’OpenClaw depuis les releases GitHub d’OpenClaw. Utilisez de préférence le dmg, mais vous pouvez aussi employer le fichier .zip. Après l’installation, ouvrez OpenClaw.app. Si cette version ne propose aucun fichier macOS, suivez les indications de la page de l’application macOS.

Lors du premier lancement, vous pouvez demander à OpenClaw de préparer Gateway sur cet ordinateur ou vous connecter à un Gateway distant existant.

Installation depuis le terminal

Sous macOS, Linux et WSL2, utilisez :

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

Sous Windows PowerShell, utilisez :

iwr -useb https://openclaw.ai/install.ps1 | iex

Le script détecte le système actuel, installe Node si nécessaire, puis installe OpenClaw et lance l’assistant de configuration initiale. Cet assistant vous accompagne pendant la première configuration.

Si vous ne souhaitez pas lancer immédiatement l’assistant, utilisez plutôt cette commande sous macOS, Linux et WSL2 :

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

Sous Windows, utilisez l’option officielle -NoOnboard :

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Si vous gérez déjà Node vous-même, vous pouvez également utiliser npm, pnpm ou bun. Avec npm 12 ainsi que npm 11.16 ou une version ultérieure, exécutez :

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Avec npm 11.15 ou une version antérieure, retirez --allow-scripts=openclaw. Avec pnpm, ajoutez --allow-build=openclaw. Consultez la page d’installation pour connaître les différences précises.

Une fois l’installation terminée, exécutez successivement les trois commandes suivantes :

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version affiche la version, openclaw doctor recherche les problèmes courants liés à l’environnement et openclaw gateway status indique si Gateway est en cours d’exécution. L’installation de base n’est terminée que si les trois commandes produisent une sortie normale.

Si le terminal indique que la commande openclaw est introuvable, le répertoire bin global de npm n’est généralement pas inclus dans PATH. PATH est la liste des emplacements où le terminal recherche les programmes. Comparez les résultats de node -v, npm prefix -g et echo "$PATH", ajoutez à PATH le répertoire bin correspondant, puis rouvrez le terminal.

Si le répertoire ~/.openclaw contient déjà une configuration en cours d’utilisation, le script d’installation emploie ce répertoire par défaut. Pour effectuer une installation distincte sans modifier la configuration existante, exécutez le script non interactif en indiquant un nouveau répertoire :

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix "$HOME/openclaw-omniproxy" --no-onboard

--no-onboard est le comportement par défaut de ce script. Le 2026-10-09, cette commande a installé OpenClaw 2026.9.9. Une fois l’installation terminée, vous devez exécuter le programme openclaw situé dans le répertoire bin de cette installation.

Obtention des paramètres de connexion depuis OmniProxy

Vérifiez d’abord qu’OmniProxy est en cours d’exécution, puis ouvrez sa liste de modèles et préparez les trois éléments suivants :

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: copiez l’identifiant complet depuis la liste actuelle des modèles OmniProxy

baseUrl est l’adresse à laquelle OpenClaw envoie les requêtes destinées aux modèles. Elle doit se terminer par /v1. Pour une connexion à OmniProxy, définissez api sur openai-completions. Ne choisissez openai-responses que si ce modèle fonctionne effectivement via /v1/responses.

Le Model ID est l’identifiant complet du modèle dans la liste. Copiez-le à l’identique, en conservant toutes les barres obliques qu’il contient. Les deux noms suivants ne sont fournis qu’à titre de comparaison avec la documentation des fournisseurs au 2026-10-09. Ne les utilisez pas s’ils ne figurent pas dans la liste : claude-sonnet-5-5, gpt-6-luna.

Même si la passerelle ne vérifie pas la clé, apiKey doit contenir une valeur. Vous pouvez employer une chaîne de substitution utilisée uniquement sur cet ordinateur. Ne validez jamais une véritable clé dans le dépôt.

Saisie de la configuration de l’outil

Un Provider peut être considéré comme un ensemble de paramètres de connexion permettant à OpenClaw de trouver un service de modèles. Ici, le Provider est nommé omniproxy.

Exécutez la commande suivante dans le terminal, puis remplacez l’adresse, la clé et les deux Model ID par vos propres valeurs :

openclaw config set models.providers.omniproxy '{"baseUrl":"https://your-omniproxy-origin.example/v1","apiKey":"<YOUR_OMNIPROXY_API_KEY>","api":"openai-completions","models":[{"id":"claude-sonnet-5-5","name":"Claude Sonnet 5.5"},{"id":"gpt-6-luna","name":"GPT-6 Luna"}]}' --strict-json --merge

Cette commande écrit le Provider et la liste des modèles dans la configuration. Une fois la commande exécutée avec succès, il n’est pas nécessaire de redémarrer Gateway.

Définissez ensuite le modèle par défaut. La référence du modèle se compose de omniproxy/ suivi du Model ID. Conservez toutes les barres obliques déjà présentes dans l’ID. Si l’ID affiché dans la liste des modèles est plus long que le nom abrégé ci-dessous, utilisez l’identifiant complet de la liste :

openclaw config set agents.defaults.model.primary '"omniproxy/claude-sonnet-5-5"' --strict-json

Vous pouvez omettre reasoning, input, cost, contextWindow et maxTokens. Lorsqu’ils ne sont pas renseignés, les modèles de texte utilisent le comportement par défaut.

Vous pouvez également écrire directement ces paramètres dans le fichier de configuration. Dans la configuration principale, le Provider se trouve sous models.providers. Chaque agent peut aussi disposer de son propre fichier models.json ; un agent est l’instance de l’assistant qui reçoit effectivement les tâches et appelle le modèle. Ce fichier se trouve sous ~/.openclaw/agents/, dans le chemin agent/models.json du répertoire correspondant à l’agent.

Si ce fichier models.json contient une valeur baseUrl non vide, celle-ci remplace l’adresse de la configuration principale.

Vérifier l’installation

Trois commandes

openclaw --version
openclaw doctor
gateway status

Configuration

models.providers

baseUrl se termine par /v1
Définir api sur completions
Indiquer au moins id pour le modèle

Sélection

fournisseur/modèle

Utiliser cette référence pour primary
Utiliser de préférence une variable d’environnement pour la clé
Se fier à la liste de la passerelle

Vérifiez d’abord que la commande est accessible, puis saisissez l’adresse et le modèle. La référence du modèle doit inclure le nom du Provider.

Vérification avec une tâche réelle

Ouvrez un répertoire de projet ordinaire et envoyez un message très court. Remplacez la référence du modèle dans la commande par votre Model ID complet :

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Répondez en un mot."

--local exécute cette tâche d’agent localement, --model sélectionne le modèle utilisé pour cette exécution et --timeout 300 fixe le temps d’attente maximal à 300 secondes.

Une véritable réponse du modèle doit apparaître dans le terminal. Le 2026-10-09, OpenClaw 2026.9.9 a reçu une réponse avec cette commande. Le premier appel peut prendre une à deux minutes.

Si le message d’erreur exact Request timed out before a response was generated apparaît, augmentez d’abord la valeur de --timeout, puis renvoyez la requête. Ce message indique généralement que le délai d’attente était insuffisant ; il ne signifie pas nécessairement que l’adresse est incorrecte.

Après avoir obtenu une réponse courte, demandez au modèle de lire un fichier local de votre choix. Ouvrez ensuite l’historique des appels d’OmniProxy et vérifiez la source ainsi que le Model ID indiqués dans l’enregistrement. L’affichage du numéro de version ou d’une sortie de doctor ne suffit pas à confirmer que la connexion au modèle est entièrement configurée.

Installation

La commande répond

Le numéro de version s’affiche
doctor ne signale aucun problème bloquant
L’état de la passerelle est lisible

Tâche

Il a effectué une petite action

Par exemple, lire un fichier local
La réponse n’est pas une erreur
La référence du modèle est correcte

Journaux

La passerelle reçoit l’appel

La source est OpenClaw
L’ID du modèle correspond
La clé n’a pas été enregistrée dans le dépôt

Après avoir obtenu une sortie de la commande de version, vous devez encore recevoir une véritable réponse.

Erreurs courantes

openclaw est introuvable : ajoutez le répertoire bin global de npm à PATH, puis rouvrez le terminal. Si vous avez effectué l’installation dans un répertoire précis, exécutez le programme situé dans son répertoire bin.
node -v indique une version antérieure à 24.16 : il n’est pas nécessaire de désinstaller d’abord l’ancienne version. Vérifiez la version de Node préparée par le script d’installation ou utilisez une version 24.16+ ou 26.1+ conformément à la page d’installation. Node 26 est recommandé.
Le modèle n’apparaît pas : le modèle doit figurer dans le tableau models de models.providers et comporter au minimum le même id. Définir uniquement agents.defaults.models n’enregistre pas séparément un nouveau modèle.
Une erreur 400 mentionne le rôle developer : lorsque l’hôte de l’adresse n’est pas api.openai.com, conservez le réglage par défaut et ne définissez pas supportsDeveloperRole sur true. Cette valeur serait malgré tout remplacée.
Le délai expire très rapidement : augmentez --timeout à plus de 300 secondes avant de modifier l’adresse.
Les appels d’outils échouent après la sélection de gpt-6-luna : ce modèle prend en charge Chat Completions. Dans Chat Completions, l’appel de fonctions n’est pris en charge que lorsque reasoning_effort vaut none. Si l’ID affiché dans la liste est différent, utilisez celui de la liste.
Impossible de joindre l’adresse : vérifiez qu’OmniProxy est en cours d’exécution, que baseUrl se termine par /v1 et que l’adresse enregistrée dans la configuration est accessible. Les autres adresses de réseau privé doivent être autorisées séparément.
Les requêtes sont toujours envoyées à une autre adresse après la configuration : vérifiez si le fichier models.json de cet agent contient un autre baseUrl.

Références officielles

Consultez OpenClaw install pour les étapes d’installation. La configuration d’un Provider personnalisé est décrite dans Custom providers et champs de configuration. Pour comparer les Model ID utilisés dans les exemples, consultez vue d’ensemble des modèles Claude et GPT-6 Luna.

Remplacez chaque espace réservé par des valeurs de votre propre configuration OmniProxy. Ne publiez jamais une vraie clé.

Un résultat sauvegardé ou un HTTP 200 seul ne prouve pas une compatibilité complète de l'Agent. Vérifiez la source et le modèle dans l'enregistrement d'appel d'OmniProxy.

Sources officielles · OpenClaw ↗