CLI commands
Référence CLI
openclaw est le point d’entrée principal de la CLI. Chaque commande principale dispose soit d’une page de référence dédiée, soit d’une documentation avec la commande dont elle est l’alias ; cet index liste les commandes, les indicateurs globaux et les règles de style de sortie qui s’appliquent à toute la CLI.
Utilisez les commandes de configuration selon l’intention :
openclaw setupcrée la configuration de base et l’espace de travail sans parcourir le flux complet d’intégration guidée.openclaw onboardest le parcours complet guidé de première exécution pour le gateway, l’authentification des modèles, l’espace de travail, les canaux, les skills et l’état de santé.openclaw configuremodifie des parties ciblées d’une configuration existante, comme l’authentification des modèles, le gateway, les canaux, les plugins ou les skills.openclaw channels addconfigure les comptes de canal une fois la configuration de base en place ; exécutez-la sans indicateurs pour une configuration guidée des canaux ou avec des indicateurs propres au canal pour les scripts.
Pages de commandes
| Zone | Commandes |
|---|---|
| Configuration et intégration | crestodian · setup · onboard · configure · config · completion · doctor · dashboard |
| Réinitialisation et désinstallation | backup · reset · uninstall · update |
| Messagerie et agents | message · agent · agents · acp · mcp |
| Santé et sessions | status · health · sessions |
| Gateway et journaux | gateway · logs · system |
| Modèles et inférence | models · infer · capability (alias de infer) · memory · commitments · wiki |
| Réseau et nœuds | directory · nodes · devices · node |
| Runtime et bac à sable | approvals · exec-policy (voir approvals) · sandbox · tui · chat/terminal (alias de tui --local) · browser |
| Automatisation | cron · tasks · hooks · webhooks |
| Découverte et documentation | dns · docs |
| Appairage et canaux | pairing · qr · channels |
| Sécurité et plugins | security · secrets · skills · plugins · proxy |
| Alias hérités | daemon (service gateway) · clawbot (espace de noms) |
| Plugins (facultatifs) | path · voicecall (si installé) |
Indicateurs globaux
| Indicateur | Objectif |
|---|---|
--dev |
Isole l’état sous ~/.openclaw-dev et décale les ports par défaut |
--profile <name> |
Isole l’état sous ~/.openclaw-<name> |
--container <name> |
Cible un conteneur nommé pour l’exécution |
--no-color |
Désactive les couleurs ANSI (NO_COLOR=1 est aussi respecté) |
--update |
Raccourci pour openclaw update (installations depuis les sources uniquement) |
-V, --version, -v |
Affiche la version et quitte |
Modes de sortie
- Les couleurs ANSI et les indicateurs de progression ne s’affichent que dans les sessions TTY.
- Les liens hypertexte OSC-8 s’affichent comme des liens cliquables lorsque c’est pris en charge ; sinon, la CLI revient à des URL simples.
--json(et--plainlorsque pris en charge) désactive le style pour une sortie propre.- Les commandes de longue durée affichent un indicateur de progression (OSC 9;4 lorsque pris en charge).
Source de vérité de la palette : src/terminal/palette.ts.
Arborescence des commandes
Arborescence complète des commandes
openclaw [--dev] [--profile <name>] <command>crestodiansetuponboardconfigureconfig get set unset file schema validatecompletiondoctordashboardbackup create verifysecurity auditsecrets reload audit configure applyresetuninstallupdate wizard statuschannels list status capabilities resolve logs add remove login logoutdirectory self peers list groups list|membersskills search install update list info checkplugins list inspect install uninstall update enable disable doctor marketplace listmemory status index searchpath resolve find set validate emitcommitments list dismisswiki status doctor init ingest compile lint search get apply bridge import unsafe-local import obsidian status|search|open|command|dailymessage send broadcast poll react reactions read edit delete pin unpin pins permissions search thread create|list|reply emoji list|upload sticker send|upload role info|add|remove channel info|list member info voice status event list|create timeout kick banagentagents list add delete bindings bind unbind set-identityacpmcp serve list show set unsetstatushealthsessions cleanuptasks list audit maintenance show notify cancel flow list|show|cancelgateway call usage-cost health status probe discover install uninstall start stop restart rundaemon status install uninstall start stop restartlogssystem event heartbeat last|enable|disable presencemodels list status set set-image aliases list|add|remove fallbacks list|add|remove|clear image-fallbacks list|add|remove|clear scaninfer (alias: capability) list inspect model run|list|inspect|providers|auth login|logout|status image generate|edit|describe|describe-many|providers audio transcribe|providers tts convert|voices|providers|status|enable|disable|set-provider video generate|describe|providers web search|fetch|providers embedding create|providers auth add|login|login-github-copilot|setup-token|paste-token auth order get|set|clearsandbox list recreate explaincron status list get add edit rm enable disable runs runnodes status describe list pending approve reject rename invoke notify push canvas snapshot|present|hide|navigate|eval canvas a2ui push|reset camera list|snap|clip screen record location getdevices list remove clear approve reject rotate revokenode run status install uninstall stop restartapprovals get set allowlist add|removeexec-policy show preset setbrowser status start stop reset-profile tabs open focus close profiles create-profile delete-profile screenshot snapshot navigate resize click type press hover drag select upload fill dialog wait evaluate console pdfhooks list info check enable disable install updatewebhooks gmail setup|runproxy start run coverage sessions query blob purgepairing list approveqrclawbot qrdocsdns setuptuichat (alias: tui --local)terminal (alias: tui --local)Les plugins peuvent ajouter des commandes supplémentaires de premier niveau (par exemple openclaw voicecall).
Commandes slash du chat
Les messages de chat prennent en charge les commandes /.... Consultez les commandes slash.
Points forts :
/status— diagnostics rapides./trace— lignes de trace/débogage du plugin limitées à la session./config— modifications de configuration persistées./debug— remplacements de configuration limités au runtime (mémoire, pas le disque ; nécessitecommands.debug: true).
Suivi de l’utilisation
openclaw status --usage et l’interface Control affichent l’utilisation/le quota des fournisseurs lorsque les identifiants OAuth/API sont disponibles. Les données proviennent directement des points de terminaison d’utilisation des fournisseurs et sont normalisées en X% left. Fournisseurs avec des fenêtres d’utilisation actuelles : Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi et z.ai.
Consultez le suivi de l’utilisation pour plus de détails.