Installer OpenClaw CLI pour le plugin Nylas

Ce que couvre ce guide

OpenClaw est un framework CLI open source pour créer des assistants de messagerie alimentés par l'IA. Il se connecte à l'e-mail, WhatsApp, iMessage et d'autres canaux via un système de plugins qui recense actuellement plus de 40 packages maintenus par la communauté sur npm. Vous installez le CLI globalement depuis npm, ajoutez les plugins pour les intégrations souhaitées et configurez chacun d'eux via un fichier de configuration JSON. L'objectif ici est d'installer OpenClaw et de le préparer à exécuter le plugin Nylas pour l'e-mail, le calendrier et les contacts.

Parcours rapide pour les utilisateurs Nylas

Le moyen le plus rapide de faire fonctionner Nylas dans OpenClaw est une séquence de 7 étapes qui prend moins de 3 minutes sur une machine vierge avec Node.js déjà installé. Les étapes couvrent l'installation du CLI, l'ajout du plugin Nylas, son autorisation pour les sessions d'agent et la vérification de la connexion avec une requête de test sur vos comptes e-mail.

Chaque étape ci-dessous exécute une seule commande. Les appels config set écrivent dans le fichier de configuration JSON d'OpenClaw situé à ~/.openclaw/config.json, et le redémarrage du gateway prend en compte ces modifications sans perdre les sessions actives.

Si vous n'avez pas encore de clé API Nylas, créez un compte Nylas avant l'étape 5, puis copiez la clé API dans la configuration du plugin OpenClaw.

# 1. Installer OpenClaw
npm install -g openclaw

# 2. Vérifier que le binaire est dans le PATH
openclaw --version

# 3. Installer le plugin Nylas
openclaw plugins install @nylas/openclaw-nylas-plugin

# 4. Autoriser le plugin et exposer ses outils aux sessions d'agent
openclaw config set 'plugins.allow' '["nylas"]'
openclaw config set 'tools.alsoAllow' '["nylas"]'

# 5. Configurer votre clé API Nylas
openclaw config set 'plugins.entries.nylas.config.apiKey' 'YOUR_NYLAS_API_KEY'

# 6. Redémarrer le gateway pour recharger la configuration du plugin
openclaw gateway restart

# 7. Vérifier l'intégration
openclaw plugins list
openclaw run "List my connected email accounts" --plugin nylas

Les sections suivantes expliquent chaque étape d'installation en détail, couvrent les corrections de PATH pour les environnements courants et traitent le dépannage pour macOS/Linux et Windows.

Quel est le nom du package npm OpenClaw ?

Le CLI OpenClaw est publié sur npm sous le nom de package non scopé openclaw. Il n'y a pas de préfixe @openclaw/ pour le binaire CLI principal. Les plugins suivent une convention différente et utilisent des noms scopés comme @nylas/openclaw-nylas-plugin, mais le CLI lui-même s'installe depuis le package de premier niveau openclaw. Le package est disponible sur npm depuis début 2025 et dépasse 12 000 téléchargements hebdomadaires en mai 2026.

L'exécution de npm install -g openclaw place le binaire openclaw dans le répertoire global des binaires npm, généralement situé à $(npm config get prefix)/bin/.

# Le nom du package npm est "openclaw"
npm install -g openclaw

Installer OpenClaw CLI

L'installation d'OpenClaw CLI nécessite Node.js 22.12.0 ou ultérieur et une seule commande npm install -g. L'installation globale place le binaire openclaw dans le PATH système pour qu'il soit disponible dans chaque session de terminal. Sur une connexion haut débit classique, l'installation complète prend moins de 60 secondes et télécharge environ 45 Mo de dépendances.

Vérifiez d'abord votre version de Node.js. OpenClaw utilise les modules ES natifs et le test runner intégré de Node.js, qui nécessitent tous deux Node.js 22.12.0 au minimum. Les versions plus anciennes échouent au démarrage avec une erreur de syntaxe.

# Vérifier la version de Node.js (doit être 22.12.0+)
node --version

# Installer OpenClaw CLI globalement
npm install -g openclaw

# Vérifier l'installation
openclaw --version

Si un numéro de version s'affiche, l'installation a réussi. Une erreur "command not found" signifie que le répertoire global des binaires npm n'est pas dans votre PATH — la section de dépannage sur les corrections de PATH traite directement ce problème.

Sur les systèmes où vous gérez Node.js avec nvm, assurez-vous que votre version active de Node est 22.12.0 ou supérieure avant de lancer l'installation :

# Passer à Node.js 22 avec nvm
nvm install 22
nvm use 22

# Puis installer openclaw
npm install -g openclaw

Quels sont les prérequis système ?

OpenClaw fonctionne sur macOS (Intel et Apple Silicon), Linux (x64 et arm64) et Windows 10 ou ultérieur. La seule dépendance stricte est Node.js 22.12.0+, qui nécessite environ 80 Mo d'espace disque. OpenClaw ajoute environ 45 Mo supplémentaires pour ses propres dépendances. Aucune chaîne de compilation native n'est nécessaire car le CLI est entièrement en JavaScript sans extensions natives.

Installer les plugins OpenClaw

Les plugins OpenClaw sont des packages npm qui enregistrent de nouveaux outils, intégrations et commandes dans le CLI. Le gestionnaire de plugins intégré gère le téléchargement, la résolution de versions et l'enregistrement des outils. En mai 2026, l'écosystème OpenClaw compte plus de 40 plugins publiés couvrant l'e-mail, la messagerie, le CRM et les outils de développement. Chaque plugin s'installe en quelques secondes et s'active après un redémarrage du gateway.

Les sous-commandes openclaw plugins gèrent le cycle de vie complet des plugins : installation, liste, mise à jour et désinstallation. Après avoir installé un plugin ou modifié sa configuration, exécutez openclaw gateway restart pour que le processus gateway charge le nouvel état du plugin.

# Installer un plugin
openclaw plugins install <package-name>

# Exemple : installer le plugin Nylas pour l'e-mail, le calendrier et les contacts
openclaw plugins install @nylas/openclaw-nylas-plugin

# Vérifier qu'il a été installé
openclaw plugins list

# Redémarrer le gateway pour charger les nouveaux plugins
openclaw gateway restart

Référence des commandes de gestion des plugins

Lister les plugins installés

La commande openclaw plugins list affiche chaque plugin installé avec son numéro de version et son statut actif/inactif. La sortie est un tableau à 3 colonnes : NAME, VERSION et STATUS. Le flag --json produit du JSON exploitable par jq ou un script — utile pour les vérifications CI qui valident un ensemble de plugins requis avant de déployer un agent.

Un plugin affiche "active" lorsque ses outils sont chargés et disponibles pour les sessions d'agent. Un statut "inactive" signifie que le plugin est installé mais soit désactivé dans la configuration, soit en échec d'initialisation lors du dernier démarrage du gateway.

# Lister tous les plugins installés
openclaw plugins list

# Exemple de sortie :
# NAME                              VERSION  STATUS
# @nylas/openclaw-nylas-plugin      1.2.0    active
# openclaw-whatsapp-bridge          0.9.1    active
# openclaw-imsg                     0.8.3    active

# Sortie JSON pour le scripting
openclaw plugins list --json

Désinstaller des plugins

La commande openclaw plugins uninstall supprime un plugin et désenregistre tous ses outils du CLI en une seule étape. La désinstallation prend effet immédiatement sans redémarrage du gateway, contrairement à l'installation qui en nécessite un. Le package npm du plugin est supprimé du répertoire local ~/.openclaw/plugins/, libérant l'espace disque occupé — généralement 5 à 15 Mo par plugin selon les dépendances.

Indiquez le nom complet du package npm tel qu'il apparaissait lors de l'installation. Exécutez openclaw plugins list ensuite pour confirmer que le plugin n'apparaît plus.

# Désinstaller un plugin
openclaw plugins uninstall @nylas/openclaw-nylas-plugin

# Vérifier qu'il a été supprimé
openclaw plugins list

OpenClaw sur Windows

OpenClaw fonctionne nativement sur Windows 10 et ultérieur via PowerShell 5.1+. La procédure d'installation sous Windows est identique à celle de macOS et Linux : installez Node.js 22.12.0 ou ultérieur, puis exécutez npm install -g openclaw. Selon la Node.js Foundation, l'installeur Windows .msi de nodejs.org ajoute automatiquement Node.js et npm au PATH système, ce qui signifie que le binaire OpenClaw est disponible sans modification manuelle du PATH dans la plupart des cas.

# Configuration Windows PowerShell
# 1. Installer Node.js 22+ depuis https://nodejs.org (utiliser l'installeur LTS)

# 2. Ouvrir PowerShell et vérifier Node.js
node --version

# 3. Installer OpenClaw globalement
npm install -g openclaw

# 4. Vérifier
openclaw --version

# 5. En cas d'erreur EACCES ou de permissions, lancez PowerShell en administrateur :
# Clic droit sur PowerShell → "Exécuter en tant qu'administrateur"
# Puis relancez : npm install -g openclaw

Sous Windows, le répertoire de configuration d'OpenClaw est %USERPROFILE%\.openclaw\. Les plugins et fichiers de configuration se trouvent dans ce répertoire. Assurez-vous que votre PATH inclut le répertoire global des binaires npm, que l'installeur Node.js configure normalement automatiquement.

Optionnel : configuration du chemin CLI iMessage

Le plugin openclaw-imsg connecte OpenClaw à iMessage sur macOS. En raison du sandboxing des applications macOS qui restreint l'emplacement des binaires, le plugin ne peut pas détecter automatiquement le binaire CLI iMessage — vous devez définir le chemin explicitement via openclaw config set imsg.cliPath. Cette étape supplémentaire prend environ 30 secondes et n'est nécessaire qu'une seule fois par machine.

Le binaire CLI iMessage (imsg-cli) est un outil open source distinct. Si vous l'avez installé via Homebrew, le binaire se trouve sous $(brew --prefix)/bin/. Les installations manuelles le placent généralement à /usr/local/bin/imsg-cli.

# Installer le plugin iMessage
openclaw plugins install openclaw-imsg

# Définir le chemin du binaire CLI iMessage
openclaw config set imsg.cliPath "/usr/local/bin/imsg-cli"

# Si vous avez installé imsg-cli via Homebrew :
openclaw config set imsg.cliPath "$(brew --prefix)/bin/imsg-cli"

# Vérifier que le chemin est défini
openclaw config get imsg.cliPath

# Tester la connexion iMessage
openclaw imsg status

La valeur de configuration imsg.cliPath doit pointer vers le binaire réel. Si le plugin renvoie des erreurs "command not found", le chemin est incorrect ou le binaire n'existe pas à cet emplacement. Utilisez which imsg-cli pour trouver le chemin correct sur votre système.

Optionnel : intégration WhatsApp

Le plugin openclaw-whatsapp-bridge connecte OpenClaw à l'API WhatsApp Business, qui dessert plus de 2 milliards d'utilisateurs actifs mensuels selon le rapport financier 2025 de Meta. Le plugin gère l'envoi et la réception de messages ainsi que l'enregistrement des webhooks via l'API Cloud de Meta. Vous avez besoin d'un compte WhatsApp Business et d'un token d'accès depuis le tableau de bord développeur Meta. La configuration prend environ 5 minutes une fois vos identifiants prêts.

Trois valeurs de configuration sont requises : le token d'accès, l'identifiant du numéro de téléphone et l'identifiant du compte Business. Les trois sont disponibles dans le portail développeur Meta dans les paramètres de votre application WhatsApp.

# Installer le plugin WhatsApp bridge
openclaw plugins install openclaw-whatsapp-bridge

# Configurer vos identifiants WhatsApp Business
openclaw config set whatsapp.accessToken "YOUR_ACCESS_TOKEN"
openclaw config set whatsapp.phoneNumberId "YOUR_PHONE_NUMBER_ID"
openclaw config set whatsapp.businessAccountId "YOUR_BUSINESS_ACCOUNT_ID"

# Vérifier la configuration
openclaw whatsapp status

# Envoyer un message de test
openclaw whatsapp send --to "+1234567890" --message "Hello from OpenClaw"

L'identifiant du numéro de téléphone détermine quel numéro WhatsApp envoie les messages au nom de votre agent. Les tokens d'accès générés dans le portail développeur Meta expirent après 24 heures, sauf si vous créez un token permanent via la page System Users dans les paramètres Business. Pour les déploiements en production, utilisez un token permanent pour éviter les échecs d'authentification.

Optionnel : configurer exec-approvals.json

Le système d'approbation des exécutions d'OpenClaw contrôle quelles commandes shell les plugins sont autorisés à exécuter sur votre machine. Le fichier exec-approvals.json définit des règles basées sur des motifs avec 3 actions possibles : allow, deny ou ask (demander avant d'exécuter). Sans ce fichier, OpenClaw demande une confirmation pour chaque commande shell, ce qui signifie que les plugins ne peuvent rien exécuter silencieusement sauf approbation explicite de votre part.

Le fichier de configuration se trouve à ~/.openclaw/exec-approvals.json sur macOS et Linux, ou %USERPROFILE%\.openclaw\exec-approvals.json sur Windows. Les règles sont évaluées de haut en bas ; le premier motif correspondant l'emporte. L'exemple ci-dessous montre une configuration type avec 3 règles couvrant Nylas CLI, curl et la suppression de fichiers.

// Example exec-approvals.json
{
  "version": 1,
  "rules": [
    {
      "pattern": "nylas *",
      "action": "allow",
      "comment": "Allow all Nylas CLI commands"
    },
    {
      "pattern": "curl *",
      "action": "ask",
      "comment": "Prompt before running curl"
    },
    {
      "pattern": "rm *",
      "action": "deny",
      "comment": "Never allow file deletion"
    }
  ],
  "default": "ask"
}

Le champ default contrôle le comportement lorsqu'aucune règle ne correspond. Définissez-le à "ask" pour être invité à confirmer les commandes inconnues, "deny" pour bloquer tout ce qui n'est pas explicitement autorisé, ou "allow" si vous faites entièrement confiance à tous les plugins. Pour la plupart des utilisateurs, "ask" est la valeur par défaut la plus sûre.

Vous pouvez inspecter la configuration actuelle avec cat ou la réinitialiser aux valeurs par défaut d'OpenClaw. La commande de réinitialisation restaure le fichier exec-approvals.json d'usine avec une action par défaut ask et aucune règle personnalisée.

# Afficher votre configuration exec approvals actuelle
cat ~/.openclaw/exec-approvals.json

# Réinitialiser aux valeurs par défaut
openclaw config reset exec-approvals

Ajouter le plugin Nylas

Le @nylas/openclaw-nylas-plugin ajoute des outils natifs d'e-mail, de calendrier et de contacts à OpenClaw. Le plugin Nylas prend en charge 6 fournisseurs de messagerie — Gmail, Outlook, Exchange, Yahoo, iCloud et IMAP — via une API unique. Il enregistre plus de 20 outils dans OpenClaw couvrant le CRUD de messages, la gestion des événements de calendrier, la recherche de contacts et la gestion des pièces jointes.

L'installation nécessite le nom du package npm, une clé API Nylas (depuis dashboard.nylas.com) et un redémarrage du gateway. La clé API est stockée dans le fichier de configuration local d'OpenClaw et ne quitte jamais votre machine.

# Installer le plugin Nylas
openclaw plugins install @nylas/openclaw-nylas-plugin

# Configurer votre clé API Nylas
openclaw config set 'plugins.entries.nylas.config.apiKey' 'YOUR_NYLAS_API_KEY'

# Redémarrer le gateway pour recharger la configuration du plugin
openclaw gateway restart

# Vérifier que le plugin peut voir vos comptes connectés
openclaw run "List my connected email accounts" --plugin nylas

Pour la configuration multi-comptes, le tableau de référence complet des outils et le dépannage par fournisseur, consultez le guide Installer le plugin Nylas pour OpenClaw.

Dépannage : "command not found" après npm install -g

Une erreur "command not found" après npm install -g openclawsignifie que le répertoire global des binaires npm n'est pas dans le PATH du shell. C'est le problème post-installation le plus fréquent, affectant environ 1 utilisateur sur 5 sous Linux et macOS lorsque Node.js a été installé via nvm ou un tarball manuel. La solution consiste à trouver le répertoire préfixe npm et à ajouter son sous-répertoire bin/ à votre profil shell.

Exécutez npm config get prefix pour afficher le répertoire. Sur une installation nvm par défaut, le préfixe est généralement ~/.nvm/versions/node/v22.x.x. Le binaire openclaw se trouve à <prefix>/bin/openclaw.

# Trouver où npm installe les binaires globaux
npm config get prefix

# Le binaire sera à <prefix>/bin/openclaw
# Ajouter le répertoire bin à votre PATH

# Pour bash (~/.bashrc) :
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Pour zsh (~/.zshrc) :
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Vérifier que ça fonctionne
openclaw --version

Si vous utilisez nvm, le préfixe global change lorsque vous changez de version de Node. Assurez-vous d'installer OpenClaw sous la version de Node que vous utilisez au quotidien. L'exécution de nvm use 22 && npm install -g openclaw garantit que le binaire est disponible chaque fois que Node 22 est actif.

Dépannage : échec de l'installation d'un plugin

Les échecs d'installation de plugins avec openclaw plugins install se répartissent en 3 catégories : incompatibilité de version npm, erreurs réseau/proxy et erreurs de permissions de fichiers. La cause la plus courante est l'utilisation de npm 9 ou antérieur, qui ne dispose pas des fonctionnalités de résolution de dépendances dont les plugins OpenClaw ont besoin. npm 10+ est livré avec Node.js 22 par défaut. Les étapes ci-dessous traitent chaque type d'échec par ordre de probabilité.

Commencez par vérifier vos versions de Node.js et npm. Si les deux sont à jour, videz le cache npm et réessayez. Les problèmes de proxy d'entreprise et de propriété de fichiers sont moins fréquents mais représentent environ 15 % des échecs d'installation signalés sur le tracker GitHub d'OpenClaw.

# 1. Vérifier vos versions de Node.js et npm
node --version   # Must be 22.12.0+
npm --version    # Must be 10+

# 2. Vider le cache npm
npm cache clean --force

# 3. Réessayer l'installation
openclaw plugins install @nylas/openclaw-nylas-plugin

# 4. Si vous êtes derrière un proxy d'entreprise, configurer npm
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080

# 5. En cas d'erreur de permissions sur macOS/Linux, corriger la propriété du préfixe npm
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

Dépannage : plugin installé mais ne se charge pas

Lorsque openclaw plugins list affiche un plugin comme "active" mais que ses outils ou commandes sont indisponibles pendant les sessions d'agent, le plugin a probablement échoué à s'initialiser au démarrage. Cela peut se produire lorsque les valeurs de configuration requises par le plugin sont manquantes ou lorsqu'un conflit de dépendances empêche le point d'entrée du plugin de se charger. Le flag --debug écrit des logs d'initialisation détaillés sur stderr, incluant le message d'erreur exact du plugin en échec.

Réinstaller le plugin force un nouveau téléchargement et réenregistre les outils du plugin dans OpenClaw. Le cycle désinstallation + installation prend moins de 10 secondes sur la plupart des connexions.

# Vérifier les logs de débogage pour les erreurs de plugin
openclaw --debug 2>&1 | grep -i plugin

# Réinstaller le plugin problématique
openclaw plugins uninstall <package-name>
openclaw plugins install <package-name>

# Vérifier qu'il se charge correctement
openclaw plugins list

Prochaines étapes

Avec OpenClaw installé et le plugin Nylas enregistré, le CLI est prêt pour l'automatisation de l'e-mail, du calendrier et des contacts. Les guides ci-dessous couvrent la configuration des plugins en profondeur, les modèles de construction d'agents et la résolution des erreurs les plus courantes d'OpenClaw.

• Installer le plugin Nylas pour OpenClaw — ajouter des outils e-mail, calendrier et contacts avec des schémas typés et la découverte automatique
• Créer un assistant personnel avec Nylas CLI et OpenClaw — l'approche basée sur exec utilisant directement les commandes shell
• Sécuriser l'accès e-mail d'OpenClaw — verrouiller les listes d'autorisation des plugins, les identifiants, les politiques et les approbations d'envoi
• CLI d'agent IA pour l'e-mail et le calendrier — créer des outils e-mail et calendrier basés sur des sous-processus pour des agents personnalisés
• Corriger les erreurs OpenClaw CLI — dépanner le PATH, les permissions npm, la version Node.js et les problèmes de configuration Windows
• Référence des commandes Nylas CLI — référence complète de toutes les commandes, flags et options