Installation d'OpenClaw et configuration d'OmniProxy

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

Avant de commencer

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 étant recommandé. Node fournit l’environnement d’exécution requis par 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 des sources.

Si une version plus ancienne 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 09/10/2026, la version de Node du système sur cet ordinateur était 24.2.0, inférieure aux 24.16 requis, et le script d’installation non interactif a préparé Node 24.21.0 automatiquement.

Vous voulez une fenêtre

Compagnon de bureau

Utilisez l'installateur Hub sur Windows
Utilisez le DMG GitHub sur macOS
La passerelle (Gateway) locale peut être installée lors de la configuration initiale

Recommandé officiellement

Script d'installation

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

Node déjà installé

Gestionnaire de paquets

npm pnpm ou bun
Ensuite, exécutez 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 voulez seulement l'utiliser dans le terminal, exécutez le script d'installation officiel.

Installation et premier lancement

Vous pouvez installer le compagnon de bureau avec une fenêtre graphique, ou installer directement via le terminal. Gateway est le service local responsable de la réception des messages, de l’appel des modèles et du renvoi des résultats. Vous pouvez le configurer lors de l’ouverture du compagnon de bureau pour la première fois.

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 inclut les paramètres, l’état de la barre d’état système, le chat et les modes de nœud.
macOS : Téléchargez le OpenClaw .dmg depuis les releases GitHub d’OpenClaw. Préférez le dmg, bien que vous puissiez également utiliser le .zip. Ouvrez OpenClaw.app après l’installation. Si cette version n’inclut pas de fichier macOS, suivez 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 Gateway 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 démarre le processus d’intégration initial. Le flux d’intégration vous guide à travers la configuration initiale.

Si vous ne souhaitez pas encore démarrer l’intégration, utilisez plutôt ce qui suit sur macOS, Linux et WSL2 :

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

Sur 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, supprimez --allow-scripts=openclaw. Lors de l’utilisation de 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 d’environnement courants, 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 peut pas trouver openclaw, le répertoire bin global de npm est généralement absent du PATH. PATH est la liste des emplacements où le terminal recherche des 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 actuellement utilisée, le script d’installation par défaut utilisera ce répertoire. Pour installer une copie séparée 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 est le comportement par défaut de ce script. Le 09/10/2026, 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-le pour openai-responses uniquement si le modèle fonctionne réellement via /v1/responses.

L’ID du modèle est l’identifiant complet du modèle dans la liste. Copiez-le exactement comme indiqué, y compris les barres obliques. Les deux noms suivants ne sont que des références issues de la documentation du fournisseur au 09/10/2026 ; 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 toujours contenir une valeur. Vous pouvez utiliser une chaîne de caractères générique (placeholder) utilisée uniquement sur cet ordinateur. Ne validez pas une vraie clé dans un dépôt.

Saisir la configuration de l’outil

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

Exécutez la commande suivante dans le terminal, en remplaçant l’adresse, la clé et les deux ID 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 fournisseur et la liste des modèles dans la configuration. Vous n’avez pas besoin de redémarrer Gateway après la réussite 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’ID du modèle. Conservez chaque barre oblique déjà présente dans l’ID. Si l’ID 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 gérés en utilisant les valeurs par défaut.

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

Si ce models.json contient un baseUrlnon vide, il remplace l’adresse 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 sur completions
Spécifiez au moins l'id du modèle

Sélectionner

provider/model

Utilisez cette référence pour le principal
Préférez une variable d'environnement pour la clé
Utilisez la liste de la passerelle comme source de vérité

Confirmez d'abord que la commande peut être trouvée, puis entrez l'adresse et le modèle. La référence du modèle doit inclure le nom du fournisseur.

Vérifier une tâche réelle

Entrez dans un répertoire de projet régulier et envoyez un message très court. Remplacez la référence du modèle dans la commande par votre ID 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 maximum à 300 secondes.

Une réponse réelle du modèle doit apparaître dans le terminal. Le 09/10/2026, 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 réussie, demandez-lui de lire un fichier local que vous spécifiez. Ensuite, ouvrez les enregistrements de requêtes d’OmniProxy et confirmez la source et l’ID du modèle affichés dans l’enregistrement. La sortie de la commande de version ou de doctor seule ne signifie pas que la connexion au modèle a été entièrement configurée.

Installation

La commande répond

Le numéro de version est affiché
doctor ne signale aucun blocage
L'état de la passerelle est lisible

Tâche

Il a terminé 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

Visible dans la passerelle

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

Une fois que la commande de version produit une sortie, vous devez également recevoir une réponse réelle.

Erreurs courantes

Impossible de trouver openclaw: Ajoutez le répertoire bin global de 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érieur à 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, gardez la valeur par défaut et ne définissez pas supportsDeveloperRole sur true. Même s’il est défini sur true, il sera quand même remplacé.
Il expire rapidement : 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 fonction dans Chat Completions n’est pris en charge que lorsque reasoning_effort est none. Si l’ID dans la liste diffère de celui-ci, utilisez l’ID indiqué dans la liste.
L’adresse ne peut pas être atteinte : 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. Les 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, voir OpenClaw install. Pour la configuration personnalisée du fournisseur, voir Custom providers et configuration fields. Pour les ID de modèle utilisés dans les exemples, comparez avec Claude model overview 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 ↗