Installer OpenClaw et configurer OmniProxy

OpenClaw est un assistant IA installé sur votre propre ordinateur. Vous pouvez lui parler directement via Telegram, Discord, WhatsApp ou Feishu sans garder une autre fenêtre de clavardage ouverte. Les conversations et les historiques restent sur cet ordinateur, et il peut continuer à exécuter les étapes suivantes localement.

Avant de commencer

OpenClaw requiert Node 24.16 ou une version ultérieure. Vous pouvez aussi utiliser Node 26.1 ou plus récent; Node 26 est recommandé. Node fournit l’environnement d’exécution nécessaire à OpenClaw.

Il peut être installé sur macOS, Linux et Windows. Si l’ordinateur ne dispose pas d’une version appropriée de Node, le script d’installation en préparera une automatiquement : Node 26 sur macOS et Node 24 LTS sur Linux. pnpm n’est requis que lors de la compilation d’OpenClaw à partir du code source.

Si une ancienne version de Node est déjà installée, vous n’avez pas besoin de la désinstaller au préalable. Lors des tests effectués le 2026-10-09, la version système de Node sur cet ordinateur était 24.2.0, soit inférieure à la version 24.16 requise, et le script d’installation non interactif a préparé automatiquement Node 24.21.0.

Vous voulez une fenêtre

Compagnon de bureau

Utilisez l’installateur Hub sous Windows
Utilisez le DMG GitHub sous macOS
La passerelle locale peut être installée lors de la configuration initiale

Recommandé officiellement

Script d’installation

macOS Linux WSL2
Utilisez PowerShell sous Windows
Vous pouvez ajouter --no-onboard

Node déjà installé

Gestionnaire de paquets

npm pnpm ou bun
Exécutez ensuite onboard
Consultez la page d’installation pour la version de Node

Téléchargez le compagnon de bureau si vous souhaitez une fenêtre. Si vous préférez l’utiliser uniquement dans le terminal, exécutez le script d’installation officiel.

Installer et lancer pour la première fois

Vous pouvez installer le compagnon de bureau avec une interface graphique, ou l’installer directement via le terminal. Gateway est le service local chargé de recevoir les messages, d’appeler les modèles et de retourner les résultats. Vous pouvez le configurer lors de la première ouverture du compagnon de bureau.

Si vous voulez une fenêtre

Windows : Téléchargez et exécutez OpenClawCompanion-Setup-x64.exe ou OpenClawCompanion-Setup-arm64.exe. L’installateur est signé et comprend les paramètres, l’état de la barre d’état système, le clavardage et les modes nœud.
macOS : Téléchargez le OpenClaw .dmg depuis les versions GitHub d’OpenClaw. Privilégiez le dmg, bien que vous puissiez aussi utiliser le .zip. Ouvrez OpenClaw.app après l’installation. Si cette version n’inclut pas de fichier macOS, suivez les instructions de la page de l’application macOS.

Lors de la première ouverture, vous pouvez laisser OpenClaw préparer Gateway sur cet ordinateur ou vous connecter à une passerelle distante existante.

Installation via le terminal

Pour macOS, Linux et WSL2, utilisez :

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

Pour Windows PowerShell, utilisez :

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

Le script détecte le système actuel, installe Node si nécessaire, installe OpenClaw, puis lance le processus d’intégration initial. Le flux d’intégration vous guide à travers la configuration de première utilisation.

Si vous ne souhaitez pas encore démarrer l’intégration, utilisez plutôt la commande suivante sur 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 ou npm 11.16 et versions ultérieures, exécutez :

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

Pour npm 11.15 et versions antérieures, retirez --allow-scripts=openclaw. Lorsque vous utilisez pnpm, ajoutez --allow-build=openclaw. Reportez-vous à la page d’installation pour connaître les différences exactes.

Après l’installation, exécutez ces trois commandes dans l’ordre :

openclaw --version
openclaw doctor
openclaw gateway status

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

Si le terminal signale qu’il ne trouve pas openclaw, c’est généralement parce que le répertoire binaire global npm est absent du PATH. Le PATH est la liste des emplacements où le terminal recherche les programmes. Comparez la sortie de node -v, npm prefix -g et echo "$PATH", ajoutez le répertoire bin correspondant au PATH, puis rouvrez le terminal.

Si ~/.openclaw contient déjà une configuration en cours d’utilisation, le script d’installation par défaut utilisera ce répertoire. Pour installer une copie distincte sans modifier la configuration existante, exécutez le script non interactif et spécifiez 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 correspond au comportement par défaut de ce script. Le 2026-10-09, cette commande a installé OpenClaw 2026.9.9. Après l’installation, exécutez l’exécutable openclaw depuis le dossier bin du répertoire.

Obtenir les valeurs de connexion depuis OmniProxy

Confirmez d’abord qu’OmniProxy est en cours d’exécution, puis ouvrez sa liste de modèles et préparez les trois valeurs suivantes :

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: copy the full value from the current OmniProxy model list

baseUrl est l’adresse à laquelle OpenClaw envoie les requêtes de modèle, et elle doit se terminer par /v1. Lors de la connexion à OmniProxy, utilisez openai-completions pour api. Changez-la pour openai-responses uniquement si le modèle fonctionne réellement via /v1/responses.

L’identifiant du modèle (Model ID) est l’identificateur complet du modèle dans la liste. Copiez-le exactement tel qu’affiché, y compris les barres obliques. Les deux noms suivants ne sont que des références tirées de la documentation du fournisseur en date du 2026-10-09; ne les utilisez pas s’ils n’apparaissent pas dans la liste : claude-sonnet-5-5, gpt-6-luna.

Même si la passerelle ne valide pas la clé, apiKey doit tout de même contenir une valeur. Vous pouvez utiliser une chaîne d’espace réservé utilisée uniquement sur cet ordinateur. Ne validez jamais une vraie clé dans un dépôt.

Saisir la configuration de l’outil

Un Provider peut être compris comme un ensemble de paramètres de connexion qu’OpenClaw utilise pour localiser un service de modèle. Ici, le Provider est nommé omniproxy.

Exécutez la commande suivante dans le terminal, en remplaçant l’adresse, la clé et les deux identifiants de modèle 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. Vous n’avez pas besoin de redémarrer Gateway après l’exécution réussie de la commande.

Ensuite, spécifiez le modèle par défaut. La référence du modèle consiste en omniproxy/ suivi de l’identifiant du modèle. Conservez chaque barre oblique déjà présente dans l’identifiant. Si l’identifiant dans la liste des modèles est plus long que le nom court ci-dessous, utilisez la valeur complète de la liste :

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

reasoning, input, cost, contextWindow et maxTokens peuvent tous être omis. Lorsqu’ils ne sont pas fournis, les modèles de texte sont traités selon les valeurs par défaut.

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

Si ce models.json contient un baseUrl non vide, il remplace l’adresse définie dans 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 à completions
Spécifier au moins l’identifiant du modèle

Sélectionner

provider/model

Utiliser cette référence pour le modèle principal
Privilégier une variable d’environnement pour la clé
Utiliser la liste de la passerelle comme source de vérité

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

Vérifier une tâche réelle

Placez-vous dans un répertoire de projet habituel et envoyez un message très court. Remplacez la référence du modèle dans la commande par votre identifiant de modèle complet :

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Reply with one word."

--local exécute cette tâche d’agent localement, --model spécifie le modèle à utiliser pour cette exécution, et --timeout 300 définit le temps d’attente maximal à 300 secondes.

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

Si l’erreur originale Request timed out before a response was generated apparaît, augmentez --timeout et renvoyez la requête. Cela signifie généralement que le temps d’attente était insuffisant et n’indique pas nécessairement que l’adresse est incorrecte.

Une fois la courte réponse obtenue avec succès, demandez-lui de lire un fichier local que vous spécifiez. Ouvrez ensuite les journaux de requêtes d’OmniProxy et confirmez la source et l’identifiant du modèle affichés dans le journal. Une sortie provenant uniquement de la commande de version ou de doctor ne signifie pas 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 blocage
L’état de Gateway est lisible

Tâche

Elle a accompli une petite tâche

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

Journaux

Visibles dans la passerelle

La source est OpenClaw
L’identifiant du modèle correspond
La clé n’a pas été ajoutée au dépôt

Après que la commande de version produit une sortie, vous devez également recevoir une vraie réponse.

Erreurs courantes

Impossible de trouver openclaw : Ajoutez le répertoire binaire global npm au PATH, puis rouvrez le terminal. Si vous avez installé dans un répertoire spécifié, exécutez l’exécutable depuis le dossier bin de ce répertoire.
node -v est inférieure à 24.16 : Vous n’avez pas besoin de désinstaller l’ancienne version au préalable. Vérifiez la version de Node préparée par le script d’installation, ou utilisez 24.16+ ou 26.1+ comme décrit sur la page d’installation. Node 26 est recommandé.
Le modèle n’apparaît pas : Le modèle doit être inclus dans le tableau models sous models.providers et doit au moins avoir le même id. Définir uniquement agents.defaults.models n’enregistre pas un nouveau modèle par lui-même.
Une réponse 400 mentionne le rôle développeur : Lorsque l’hôte de l’adresse n’est pas api.openai.com, conservez la valeur par défaut et ne définissez pas supportsDeveloperRole à true. Même s’il est défini à true, il sera tout de même remplacé.
L’expiration est rapide : Augmentez --timeout à plus de 300 secondes avant de changer l’adresse.
Les appels d’outils échouent après avoir sélectionné gpt-6-luna : Il prend en charge Chat Completions; l’appel de fonctions dans Chat Completions n’est pris en charge que lorsque reasoning_effort est none. Si l’identifiant dans la liste diffère de celui-ci, utilisez l’identifiant affiché dans la liste.
L’adresse est inaccessible : Confirmez qu’OmniProxy est en cours d’exécution, que baseUrl se termine par /v1, et que l’adresse écrite dans la configuration est accessible. D’autres adresses de réseau privé doivent être autorisées séparément.
Les requêtes vont toujours vers une autre adresse après la configuration : Vérifiez si le models.json de cet agent contient un baseUrl différent.

Références officielles

Pour les étapes d’installation, consultez Installation d’OpenClaw. Pour la configuration personnalisée des Providers, consultez Providers personnalisés et champs de configuration. Pour les identifiants de modèle utilisés dans les exemples, comparez avec Aperçu 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 la compatibilité complète de l'Agent. Vérifiez la source et le modèle dans le journal d'appels d'OmniProxy.

Sources officielles · OpenClaw ↗