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.
-
Site officiel d'OpenClaw :https://openclaw.ai/
Documentation chinoise :https://docs.openclaw.ai/zh-CN
-
Adresse GitHub :https://github.com/openclaw/openclaw
Collection de compétences OpenClaw :https://github.com/VoltAgent/awesome-openclaw-skills
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'instructionUSER.md: paramètres de préférenceMEMORY.md: mémoire à long termeHEARTBEAT.md: liste de contrôleSOUL.md: personnalité/tonIDENTITY.md: nom/sujetBOOT.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 :
- Alibaba Cloud :https://www.aliyun.com/activity/ecs/clawdbot
- Tencent Cloud :https://cloud.tencent.com/developer/article/2624973
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 :
| 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 |
