CLI commands
Skills
openclaw skills
Inspectez les Skills locales, recherchez dans ClawHub, installez des compétences depuis ClawHub, Git ou des répertoires locaux, vérifiez les compétences ClawHub et mettez à jour les installations suivies par ClawHub.
Voir aussi :
- Système de Skills : Skills
- Atelier de compétences : Atelier de compétences
- Configuration des Skills : Configuration des Skills
- Installations ClawHub : ClawHub
Commandes
openclaw skills search "calendar"openclaw skills search --limit 20 --jsonopenclaw skills install @owner/<slug>openclaw skills install @owner/<slug> --version <version>openclaw skills install git:owner/repoopenclaw skills install git:owner/repo@mainopenclaw skills install ./path/to/skill --as custom-nameopenclaw skills install @owner/<slug> --forceopenclaw skills install @owner/<slug> --force-installopenclaw skills install @owner/<slug> --acknowledge-clawhub-riskopenclaw skills install @owner/<slug> --agent <id>openclaw skills install @owner/<slug> --globalopenclaw skills update @owner/<slug>openclaw skills update @owner/<slug> --force-installopenclaw skills update @owner/<slug> --acknowledge-clawhub-riskopenclaw skills update @owner/<slug> --globalopenclaw skills update --allopenclaw skills update --all --agent <id>openclaw skills update --all --globalopenclaw skills verify @owner/<slug>openclaw skills verify @owner/<slug> --version <version>openclaw skills verify @owner/<slug> --tag <tag>openclaw skills verify @owner/<slug> --cardopenclaw skills verify @owner/<slug> --globalopenclaw skills listopenclaw skills list --eligibleopenclaw skills list --jsonopenclaw skills list --verboseopenclaw skills list --agent <id>openclaw skills info <name>openclaw skills info <name> --jsonopenclaw skills info <name> --agent <id>openclaw skills checkopenclaw skills check --agent <id>openclaw skills check --jsonopenclaw skills workshop propose-create --name "qa-check" --description "QA checklist" --proposal ./PROPOSAL.mdopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Not reusable"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"search, update et verify utilisent directement ClawHub. install @owner/<slug>
installe une compétence ClawHub, install git:owner/repo[@ref] clone une
compétence Git et install ./path copie un répertoire local de compétence. Par
défaut, install, update et verify ciblent le répertoire skills/ de
l’espace de travail actif ; avec --global, ils ciblent le répertoire partagé
des Skills gérées. list/info/check inspectent toujours les Skills locales
visibles pour l’espace de travail et la configuration actuels. Les commandes
liées à un espace de travail déterminent l’espace de travail cible à partir de
--agent <id>, puis du répertoire de travail actuel lorsqu’il se trouve dans
l’espace de travail d’un agent configuré, puis de l’agent par défaut.
Les installations depuis Git et des répertoires locaux exigent que SKILL.md
se trouve à la racine de la source. Le slug d’installation provient du champ
name du frontmatter de SKILL.md lorsqu’il est valide, puis du nom du
répertoire source ou du dépôt ; utilisez --as <slug> pour le remplacer.
--version est réservé à ClawHub. Les installations de compétences ne prennent
pas en charge les spécifications de paquets npm ni les chemins d’archives ZIP
ou autres, et openclaw skills update met uniquement à jour les installations
suivies par ClawHub.
Les installations de dépendances de compétences adossées au Gateway et
déclenchées depuis l’intégration initiale ou les paramètres des Skills utilisent
à la place le chemin de requête distinct skills.install.
Remarques :
| Option/comportement | Description |
|---|---|
search [query...] |
Requête facultative ; omettez-la pour parcourir le flux de recherche ClawHub par défaut. |
search --limit <n> |
Limite le nombre de résultats renvoyés. |
install git:owner/repo[@ref] |
Installe une compétence Git. Les références de branche peuvent contenir des barres obliques, comme git:owner/repo@feature/foo. |
install ./path/to/skill |
Installe un répertoire local dont la racine contient SKILL.md. |
install --as <slug> |
Remplace le slug déduit pour les installations depuis Git et des répertoires locaux. |
install --version <version> |
S’applique uniquement aux références de compétences ClawHub. |
install --force |
Écrase un dossier de compétence existant dans l’espace de travail pour le même slug. |
install/update --force-install |
Installe une compétence ClawHub en attente et adossée à GitHub avant la fin de l’analyse de ClawHub. |
--global |
Cible le répertoire partagé des Skills gérées ; ne peut pas être combiné avec --agent <id>. |
--agent <id> |
Cible l’espace de travail d’un agent configuré ; remplace la déduction fondée sur le répertoire de travail actuel. |
update @owner/<slug> |
Met à jour une seule compétence suivie. Ajoutez --global pour cibler le répertoire partagé des Skills gérées plutôt que l’espace de travail. |
update --all |
Met à jour les installations ClawHub suivies dans l’espace de travail sélectionné, ou dans le répertoire partagé des Skills gérées avec --global. |
verify @owner/<slug> |
Affiche par défaut l’enveloppe JSON clawhub.skill.verify.v1 de ClawHub. Il n’existe pas d’option --json, car JSON est déjà le format par défaut. Les slugs seuls sont acceptés pour compatibilité lorsque la compétence est déjà installée ou ne présente aucune ambiguïté ; les références qualifiées par le propriétaire évitent toute ambiguïté sur l’éditeur. |
Provenance de verify |
Lorsque ClawHub renvoie une provenance de source déterminée par le serveur, le JSON de vérification inclut également une valeur openclaw.verifiedSourceUrl épinglée à un commit. Les URL sources indisponibles ou autodéclarées restent uniquement dans l’enveloppe de provenance brute et ne sont pas promues. |
Sélecteur de version de verify |
verify utilise .clawhub/origin.json pour les compétences ClawHub installées et vérifie donc la version installée auprès du registre dont elle provient. --version et --tag remplacent le sélecteur de version, mais conservent ce registre installé lorsque les métadonnées d’origine existent. |
verify --card |
Affiche la fiche Markdown générée de la compétence plutôt que le JSON. Renvoie un code de sortie non nul lorsque ClawHub renvoie ok: false ou decision: "fail" ; les signatures non signées sont fournies à titre informatif, sauf modification de la politique de ClawHub. |
| Empreinte de la fiche de compétence | Les lots ClawHub installés peuvent inclure un fichier skill-card.md généré. OpenClaw considère la vérification comme une décision du serveur ClawHub et ne rejette pas une compétence installée uniquement parce que cette fiche générée modifie l’empreinte du lot. |
check --agent <id> |
Vérifie l’espace de travail de l’agent sélectionné et indique quelles compétences prêtes sont réellement visibles dans le prompt ou l’interface de commande de cet agent. |
list |
Action par défaut lorsqu’aucune sous-commande n’est fournie. |
Sortie de list/info/check |
La sortie mise en forme est envoyée vers stdout. Avec --json, la charge utile exploitable par machine reste sur stdout pour les pipelines et les scripts. |
Les installations et mises à jour de compétences communautaires ClawHub
vérifient la confiance avant le téléchargement. Les versions archivées et
versionnées de la communauté utilisent les métadonnées de confiance propres à
la version exacte. Les compétences GitHub adossées au résolveur s’appuient sur
le résolveur d’installation de ClawHub pour appliquer la politique d’analyse et
d’installation forcée avant qu’il ne renvoie un commit épinglé ; utilisez
--force-install pour installer une compétence GitHub en attente avant la fin
de cette analyse. Les versions communautaires malveillantes ou bloquées sont
refusées. Les versions communautaires risquées nécessitent une vérification et
--acknowledge-clawhub-risk lorsqu’une commande non interactive doit continuer
après cette vérification. Les éditeurs officiels de compétences ClawHub et les
sources de compétences intégrées à OpenClaw ignorent cette demande de
confirmation liée à la confiance accordée à la version.
Atelier de compétences
openclaw skills workshop gère les propositions de compétences en attente dans
l’espace de travail sélectionné. Les propositions ne deviennent pas des
compétences actives tant qu’elles ne sont pas appliquées. Pour le stockage des
propositions, les protections des fichiers auxiliaires, les méthodes du Gateway
et la politique d’approbation, consultez
Atelier de compétences.
openclaw skills workshop propose-create \ --name "qa-check" \ --description "Repeatable QA checklist" \ --proposal ./PROPOSAL.mdopenclaw skills workshop propose-create \ --name "qa-check" \ --description "Repeatable QA checklist" \ --proposal-dir ./qa-check-proposalopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Duplicate"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"propose-create, propose-update et revise acceptent également --goal <text>
et --evidence <text> pour consigner la motivation de la proposition et les notes
justificatives avec le contenu de --proposal/--proposal-dir.
