Tutoriel OpenClaw (Clawdbot)

OpenClaw (anciennement Clawdbot, nom transitoire Moltbot) est un projet open source d'assistant IA personnel qui est soudainement devenu viral en janvier 2026, développé par Peter Steinberger (fondateur de PSPDFKit).

OpenClaw est un agent capable d'exécuter des tâches. Lorsque nous donnons des instructions, il ne se contente pas de répondre, mais agit aussi de manière proactive sur le système, visite des pages web, traite des e-mails, organise des fichiers, définit des rappels, et écrit même du code automatiquement.

OpenClaw est un outil de productivité pour développeurs poussé à l'extrême :puissance de calcul locale + automatisation d'agents par grands modèles.

L'objectif d'OpenClaw est de faire en sorte que l'IA ne se contente pas de donner des conseils, mais accomplisse directement des tâches d'ingénierie complètes.

Parce qu'Anthropic a envoyé une lettre d'avocat le 27 janvier indiquant que Clawd / Clawdbot était trop similaire à Claude, le projet a été renommé d'urgence en Moltbot (signifiant homard en mue, la mascotte étant le petit homard Molty 🦞) le jour même, mais les fonctionnalités restent exactement les mêmes, et l'ancienne commande clawdbot est toujours compatible.

Moltbot est un nom transitoire imaginé par l'équipe du projet pour répondre aux risques de contrefaçon ; OpenClaw est le nom officiel définitif actuel.

Clawbot, Moltbot et OpenClaw sont en fait le même projet open source. La séquence d'évolution du nom est :

Clawdbot → Moltbot → OpenClaw
Name Chronologie Contexte/Raison Relation essentielle
Clawdbot / Clawbot Fin 2025 à début janvier 2026 Nom initial du projet ; inspiré parClaudeetclawle mème (pince de homard) Nom d'origine ; la première identité sur GitHub
Moltbot 27 janvier 2026 Obligation de renommer en raison de préoccupations liées à la marque déposée Anthropic Nom intermédiaire transitoire ; fonctionnalité et code identiques à Clawdbot
OpenClaw Après le 30 janvier 2026 Conflits de droits d'auteur écartés, accent mis sur la nature open source et l'image de marque à long terme Nom officiel actuel ; également l'identifiant unifié pour la future documentation, les dépôts, etc.

Méthodes d'installation

L'installation d'OpenClaw est conçue pour être extrêmement conviviale, permettant même aux non-développeurs de commencer rapidement.

Configuration système requise (pas nécessairement un Mac mini) :

  • Matériel : très faible ; 2GB RAM suffisent pour l'exécuter.
  • Environnement : prend en charge Mac, Windows, Linux ; nécessite Node.js (pnpm) ou Docker.

1. Installation recommandée (script en un clic) :

Exécutez la commande suivante directement dans le terminal.

Systèmes macOS/Linux :

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

Systèmes Windows :

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

#CMD
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Cela installera automatiquement Node.js (≥22) et terminera la configuration de base.

2. Installation manuelle

Vous devez disposer deNode.js ≥22et effectuer la configuration de base :

Avec npm :

npm i -g openclaw

# 如果速度慢可以指定国内镜像
npm i -g openclaw --registry=https://registry.npmmirror.com

Ou avec pnpm :

pnpm add -g openclaw

Après l'installation, initialisez et installez le service en arrière-plan (service utilisateur launchd / systemd) :

openclaw onboard

3. Installer depuis les sources (mode développement)

git clone https://github.com/openclaw/openclaw.git
cd openclaw

pnpm install

pnpm ui:build   # 首次运行会自动安装 UI 相关依赖并构建前端界面
pnpm build      # 构建整个项目(包含后端与相关模块)

# 初始化 OpenClaw 并安装为系统后台服务(开机自动运行)
pnpm openclaw onboard --install-daemon

# 开发模式:监听 TypeScript 代码变更并自动重载网关服务
pnpm gateway:watch


Guide de configuration

Nous recommandons d'installer à l'aide du script en un clic.

Systèmes macOS/Linux :

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

Systèmes Windows :

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

#CMD
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Il effectuera une détection de l'environnement, installera les dépendances nécessaires et lancera le processus d'intégration (assistant de configuration).

Pour relancer l'assistant de configuration plus tard, exécutez la commande suivante :

openclaw onboard --install-daemon

Ensuite, cela vous rappellera que ce homard est très puissant et, bien sûr, que le risque est également élevé. Nous sélectionnonsyes(no signifie qu'il ne sera pas installé) et c'est tout :

Ensuite, nous sélectionnons l'option Quick StartQuickStart:

Ensuite, nous devons configurer un grand modèle. Pour Model/Auth Provider, sélectionnez un fournisseur d'IA ; les fournisseurs nationaux et internationaux sont généralement pris en charge.

Si vous n'avez pas de compte à l'étranger, vous pouvez également configurer des clés API de fournisseurs nationaux comme Qwen, MiniMax et Zhipu. Le fichier de configuration d'authentification (OAuth + clé API) se trouve à~/.openclaw/agents/<agentId>/agent/auth-profiles.json, et vous pourrez le modifier dans ce fichier plus tard.

Ensuite, il y aura une option pour choisir un outil de chat. Si vous n'avez pas d'outils de chat étrangers, vous pouvez sélectionner le dernier :

Pour les autres configurations, telles que les paramètres de portGateway Port, utilisez simplement la valeur par défaut 18789. Par exemple, pour Skills et le gestionnaire de paquets, choisissez npm ou autres ; vous pouvez continuer à appuyer sur Yes jusqu'au bout.

Sélectionnez certaines compétences qui vous plaisent, ou vous pouvez passer directement, et utilisez la toucheespacepour sélectionner :

Pour ces clés API, si vous ne les avez pas, sélectionnez directementno:

Enfin, ces trois hooks peuvent être activés, en utilisant la toucheespacepour sélectionner, principalement pour les journaux de guidage de contenu et les enregistrements de session :

Sélectionnez Open the Web UI pour l'ouvrir dans un navigateur :

Après l'installation, il accédera automatiquement àhttp://127.0.0.1:18789/chat, et vous pouvez ouvrir l'interface de chat pour le laisser commencer à travailler.

Par exemple, recherchez les dernières actualités technologiques :

Après le démarrage, nous pouvons utiliser la commandeopenclaw statuspour vérifier l'état :

openclaw status

Si vous avez installé le service pendant l'onboarding, le Gateway devrait déjà être en cours d'exécution :

openclaw gateway status

Exécution manuelle (au premier plan) :

openclaw gateway --port 18789 --verbose

Commandes pouvant être exécutées après l'installation :

  • Lancer l'onboarding :openclaw onboard --install-daemon
  • Vérification rapide :openclaw doctor
  • Vérifier l'état de santé de Gateway :openclaw status + openclaw health
  • Ouvrir le tableau de bord :openclaw dashboard

Désinstaller

Utiliser le désinstalleur intégré :

openclaw uninstall

Non interactif (automatisation / npx) :

openclaw uninstall --all --yes --non-interactive
npx -y openclaw uninstall --all --yes --non-interactive

Utilisation des Skills

Les Skills sont des dossiers autonomes contenant un fichier SKILL.md. Si vous souhaitez ajouter de nouvelles fonctionnalités pour l'agent OpenClaw, ClawHub est le meilleur choix pour trouver et installer des skills.

Adresse du dépôt de skills ClawHub :https://clawhub.ai/

Miroir chinois de ClawHub :https://skillhub.tencent.com/

Installer l'outil ClawHub :

# 推荐方式(npx 无需全局安装)
npx clawhub@latest --version

# 或全局安装(方便以后直接用 clawhub 命令)
npm install -g clawhub
# 或者用 pnpm
pnpm add -g clawhub

Se connecter :

clawhub login

Rechercher des skills :

clawhub search "postgres backups"

Télécharger et installer de nouvelles compétences:

clawhub install my-skill-pack

Mettre à jour par lots les compétences installées:

clawhub update --all

Gestion des plugins

Les plugins sont des modules de code légers qui peuvent étendre des fonctionnalités supplémentaires pour OpenClaw en ajoutant des commandes, des outils et des capacités RPC de Gateway.

Afficher les plugins chargés:

openclaw plugins list

Installer des plugins officiels (par exemple, plugin d'appel vocal):

openclaw plugins install @openclaw/voice-call

Redémarrer le Gateway après l'installation du plugin pour que les modifications prennent effet:

openclaw gateway restart

Commandes courantes

Référence rapide des commandes courantes d'OpenClaw:

Catégorie Commande Description
Initialisation et installation openclaw onboard Assistant interactif (configurer le modèle, le canal, la passerelle, l'espace de travail)
Initialisation et installation openclaw setup Initialiser la configuration + l'espace de travail (non interactif)
Initialisation et installation openclaw configure Assistant de configuration interactif (modèle, canal, compétences)
Gestion de la passerelle openclaw gateway status Vérifier l'état du service de passerelle + sonde de vivacité RPC
Gestion de la passerelle openclaw gateway start Démarrer le service de passerelle
Gestion de la passerelle openclaw gateway stop Arrêter le service de passerelle
Gestion de la passerelle openclaw gateway restart Redémarrer le service de passerelle
Gestion de la passerelle openclaw gateway run Exécuter la passerelle directement au premier plan (pour le débogage)
Gestion de la passerelle openclaw gateway health Obtenir les informations de santé de la passerelle
Gestion de la configuration openclaw config file Afficher le chemin complet du fichier de configuration actuel
Gestion de la configuration openclaw config get <path> Lire les éléments de configuration
Gestion de la configuration openclaw config set <path> <value> Modifier les éléments de configuration
Gestion de la configuration openclaw config validate Vérifier si le fichier de configuration est valide
Diagnostics et état openclaw doctor Vérification de l'état en un clic + réparation automatique
Diagnostics et état openclaw status Afficher l'état de santé de la session et les contacts récents
Diagnostics et état openclaw health Récupérer les données d'état de la passerelle en cours d'exécution
Diagnostics et état openclaw logs Afficher les journaux de la passerelle en temps réel
Autres opérations fréquemment utilisées openclaw dashboard Ouvrir le panneau de contrôle web
Autres opérations fréquemment utilisées openclaw channels status Afficher les canaux de discussion connectés
Autres opérations fréquemment utilisées openclaw agent run Déclencher manuellement une exécution du proxy

Après avoir modifié la configuration, n'oubliez pas d'exécuteropenclaw gateway restartPour que les modifications prennent effet ~ 🦞

Gestion des canaux

  • WhatsApp:openclaw channels login(ou scanner le QR)
  • Telegram:openclaw channels add --channel telegram(nécessite un Bot Token)
  • Discord:openclaw channels add --channel discord(nécessite un Bot Token)
  • iMessage: pont natif macOS
  • Slack:openclaw channels add --channel slack(nécessite un Bot Token)

Structure de l'espace de travail (Anatomie de l'espace de travail)

  • AGENTS.md: description de l'instruction
  • USER.md: paramètres de préférence
  • MEMORY.md: mémoire à long terme
  • HEARTBEAT.md: liste de contrôle
  • SOUL.md: personnalité/ton
  • IDENTITY.md: nom/sujet
  • BOOT.md: configuration de démarrage
  • Répertoire racine :~/.openclaw/workspace

Commandes slash dans le chat

  • /status: Santé + Contexte
  • /context list: Contributeurs de contexte
  • /model <m>: Changer de modèle
  • /compact: Libérer de l'espace de fenêtre
  • /new: Nouvelle conversation
  • /stop: Interrompre l'exécution en cours
  • /tts on|off: Changer de voix
  • /think: Basculer le mode de raisonnement

Mappage des chemins clés (Plan des chemins essentiels)

  • Configuration principale :~/.openclaw/openclaw.json
  • Espace de travail par défaut :~/.openclaw/workspace/
  • Répertoire d'état de l'agent :~/.openclaw/agents/<cid>/
  • Clés OAuth et API :~/.openclaw/agents/<agentId>/agent/auth-profiles.json, s'il s'agit de l'ancienne version~/.openclaw/credentials/
  • Stockage de l'index vectoriel :~/.openclaw/memory/<cid>.sqlite
  • Compétences partagées globales :~/.openclaw/skills/
  • Journaux de fichiers de la passerelle :/tmp/openclaw/*.log

Voix et TTS

  • Payant : OpenAI / ElevenLabs
  • Gratuit : Edge TTS (aucune clé API requise)
  • TTS automatique :messages.tts.auto: "always"

Mémoire et modèles

  • Recherche vectorielle :memory search "X"
  • Changement de modèle :models set <model>
  • Paramètres d’authentification :models auth setup
  • Journaux :memory/YYYY-MM-DD.md

Hooks et compétences

  • ClawHub :clawhub install <slug>
  • Liste des hooks :openclaw hooks list

Dépannage

  • Aucune réponse aux MP → Liste d’appairage → Approuver
  • En sourdine dans le groupe → Vérifier la configuration du motif de mention
  • Authentification expirée →models auth setup-token
  • Passerelle fermée →doctor --deep
  • Bug de mémoire → Reconstruire l’index de mémoire

Automatisation et recherche

  • Navigateur :browser start/screenshot
  • Sous-agents :/subagents list/info
  • Tâches planifiées :cron list/run <cid>
  • Heartbeat :heartbeat.every: "30m"

Installer et configurer directement via un cloud tiers

Toutes les principales plateformes prennent désormais en charge cet agent. Si vous ne souhaitez pas l'installer localement, vous pouvez déployer OpenClaw dans le cloud en un clic :

Installer via le serveur léger d'Alibaba Cloud :https://www.aliyun.com/activity/ecs/clawdbot。

Vous pouvez utiliser leurs images pour installer en un clic :

Installer via le serveur léger de Tencent Cloud :https://cloud.tencent.com/developer/article/2624973


Commandes courantes

Les commandes OpenClaw courantes sont les suivantes :

================= État de base / Diagnostics ================= ================= Initialisation / Installation ================= ================= Configuration ================= ================= Gestion des canaux ================= ================= Journaux ================= ================= Automatisation / Recherche ================= ================= Désinstallation =================
Commande Objectif Remarques / Paramètres
openclaw status Afficher l'état d'exécution actuel de la passerelle Inclut les informations de santé et de contexte
openclaw health Contrôle de santé Détecter le cœur, les dépendances et l'environnement d'exécution
openclaw doctor Diagnostic complet et recommandations de réparation Assistance--deepVérification approfondie
openclaw onboard Assistant d'initialisation interactif Recommandé pour la première utilisation
openclaw onboard --install-daemon Installer le démon système Exécuter Gateway en arrière-plan en tant que démon
openclaw onboard --uninstall-daemon Désinstaller le démon Ne pas supprimer les données
openclaw configure Assistant de configuration interactif Modèles, canaux, identifiants, etc.
openclaw config get <path> Obtenir la valeur de configuration Chemin JSON
openclaw config set <path> <value> Définir l'élément de configuration Prend en charge JSON5 / texte brut
openclaw config unset <path> Effacer l'élément de configuration Supprimer une paire clé-valeur
openclaw channels list Lister les canaux connectés WhatsApp / Telegram / Discord, etc.
openclaw channels login Se connecter à un nouveau compte de canal Scan de code QR ou flux d'autorisation
openclaw channels add Ajouter un canal Telegram / Discord / Slack
openclaw channels status --probe Vérification de l'état du canal Vérifier l'accessibilité de la connexion
openclaw skills list Lister les compétences Compétences installées / disponibles
openclaw skills info <skill> Détails de la compétence Paramètres, informations de version
clawhub install <slug> Installer une compétence depuis ClawHub Place de marché officielle des compétences
openclaw hooks list Lister les Hooks Mécanisme de hook d’événement
openclaw plugins list Lister les plugins Voir les plugins installés
openclaw plugins install <id> Installer un plugin Par exemple@openclaw/voice-call
openclaw plugins enable <id> Activer un plugin Nécessite généralement un redémarrage de Gateway
openclaw models list Lister les modèles disponibles Inclut le statut d'authentification
openclaw models status Statut du modèle Disponibilité actuelle
openclaw models auth setup-token Configuration de l'authentification du modèle Approche recommandée de l'aide-mémoire
openclaw memory search "X" Rechercher dans la mémoire à long terme Recherche vectorielle
openclaw memory index Reconstruire l'index de mémoire Corriger les anomalies de mémoire
openclaw logs Afficher les journaux Sortie agrégée par défaut
openclaw logs --follow Journaux en temps réel --json / --plain / --limit
openclaw gateway install Installer le service système Gateway Enregistrer en tant que démon système
openclaw gateway start Démarrer le service Gateway Mode service système
openclaw gateway stop Arrêter le service Gateway
openclaw gateway restart Redémarrer le service Gateway À utiliser après des modifications de configuration
openclaw gateway status État du service système Gateway Différent deopenclaw status
openclaw browser start Lancer l’agent de navigateur Capacités d'automatisation
openclaw browser screenshot Capture d'écran de page web
openclaw subagents list Lister les sous-agents
openclaw cron list Lister les tâches planifiées
openclaw cron run <id> Exécuter les tâches planifiées
openclaw uninstall Désinstaller le service Gateway et les données Recommandation officielle
openclaw uninstall --all --yes --non-interactive Désinstallation entièrement automatique Statut / espace de travail / plugins
openclaw uninstall --state Supprimer les fichiers d'état Ne pas supprimer l'espace de travail
openclaw uninstall --workspace Supprimer l'espace de travail données de l'agent / de l'espace de travail
openclaw uninstall --service Désinstaller uniquement le service système Ne pas supprimer les données
openclaw uninstall --dry-run Simuler la désinstallation Afficher uniquement les résultats

Pourquoi est-il si populaire récemment ?

  • Il atteint vraiment "comme JARVIS" : peut lire/écrire des fichiers, exécuter des commandes terminal, piloter des navigateurs, envoyer/recevoir des e-mails, gérer le calendrier, écrire du code, réserver des vols, vider la boîte de réception...
  • Local-first + mémoire à long terme : toutes les conversations partagent le contexte entre les plateformes, et les répertoires USER.md et memory/ deviennent plus intelligents à l'usage
  • Prend en charge presque tous les principaux modèles : Claude, Gemini, OpenAI, les modèles locaux Ollama, Pi, etc.
  • Explosion de l'écosystème de compétences communautaires : ClawdHub compte déjà plus de 500 compétences communautaires (Slack, Discord, GitHub, contrôle du navigateur, automatisation de l'interface macOS...)
  • L'installation est aussi simple que npm install, mais les capacités réelles sont plutôt épicées (dixit le développeur)

Ses capacités principales incluent :

  • Décomposer des objectifs en langage naturel en étapes exécutables
  • Invoquer automatiquement des commandes du terminal
  • Créer et modifier des fichiers de projet
  • Exécuter du code et vérifier les résultats
  • Corriger automatiquement en fonction des messages d'erreur

Comparé aux outils de complétion de code comme Claude Code/OpenCode, OpenClaw est plus proche d'un agent d'ingénierie avec des permissions d'exécution.

  • Claude Code et OpenCode excellent dans la qualité et la compréhension du code
  • OpenClaw excelle dans l'accomplissement automatique de l'ensemble du processus d'ingénierie
Dimension de capacité OpenClaw Claude Code OpenCode
Planification des tâches Forte Moyenne Moyenne
Exécution automatique Complet Partielle Partielle
Auto-réparation Oui Aucune Aucune
Opérations de niveau ingénierie Forte Forte Moyenne
Automatisation locale Prise en charge native Relativement faible Relativement faible
Autres extensions