Aller au contenu

Skills

Inspecter les compétences locales, rechercher ClawHub, installer des compétences depuis ClawHub/Git/les répertoires locaux, vérifier les compétences ClawHub, et mettre à jour les installations suivies par ClawHub.

Connexes :

Fenêtre de terminal
openclaw skills search "calendar"
openclaw skills search --limit 20 --json
openclaw skills install <slug>
openclaw skills install <slug> --version <version>
openclaw skills install git:owner/repo
openclaw skills install git:owner/repo@main
openclaw skills install ./path/to/skill --as custom-name
openclaw skills install <slug> --force
openclaw skills install <slug> --agent <id>
openclaw skills install <slug> --global
openclaw skills update <slug>
openclaw skills update <slug> --global
openclaw skills update --all
openclaw skills update --all --agent <id>
openclaw skills update --all --global
openclaw skills verify <slug>
openclaw skills verify <slug> --version <version>
openclaw skills verify <slug> --tag <tag>
openclaw skills verify <slug> --card
openclaw skills verify <slug> --global
openclaw skills list
openclaw skills list --eligible
openclaw skills list --json
openclaw skills list --verbose
openclaw skills list --agent <id>
openclaw skills info <name>
openclaw skills info <name> --json
openclaw skills info <name> --agent <id>
openclaw skills check
openclaw skills check --agent <id>
openclaw skills check --json
openclaw skills workshop propose-create --name "qa-check" --description "QA checklist" --proposal ./PROPOSAL.md
openclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.md
openclaw skills workshop list
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.md
openclaw 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 verifyClawHub utilisent directement ClawHub. install <slug>ClawHub installe une Skill ClawHub, install git:owner/repo[@ref] clone une Skill Git, et install ./path copie un répertoire de Skill local. 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 géré partagé des Skills. list/info/check inspectent toujours les Skills locales visibles pour l’espace de travail et la configuration actuels. Les commandes basées sur l’espace de travail résolvent l’espace de travail cible à partir de --agent <id>, puis le répertoire de travail actuel lorsqu’il se trouve dans un espace de travail d’agent configuré, puis l’agent par défaut.

Les installations depuis Git et des répertoires locaux attendent SKILL.md à la racine de la source. L’identifiant d’installation provient de SKILL.md frontmatter name lorsqu’il est valide, puis du nom du répertoire source ou du dépôt ; utilisez --as <slug> pour le remplacer. --versionClawHubnpm est exclusif à ClawHub. Les installations de Skills ne prennent pas en charge les spécifications de paquets npm ou les chemins de zip/archives, et openclaw skills updateClawHub met à jour uniquement les installations suivies par ClawHub.

Les installations de dépendances de compétences prises en charge par Gateway et déclenchées depuis le processus d’intégration ou les paramètres des Skills utilisent le chemin de requête séparé skills.install à la place.

Notes :

  • search [query...] accepte une requête facultative ; omettez-la pour parcourir le flux de recherche par défaut de ClawHub.
  • search --limit <n> limite les 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, telles que 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 Git et de répertoire local.
  • install --version <version> s’applique uniquement aux slugs de compétences ClawHub.
  • install --force écrase un dossier de compétence existant dans l’espace de travail pour le même slug.
  • --global cible le répertoire partagé des compétences gérées et ne peut être combiné avec --agent <id>.
  • --agent <id> cible un espace de travail d’agent configuré et remplace l’inférence du répertoire de travail actuel.
  • update <slug> met à jour une seule compétence suivie. Ajoutez --global pour cibler le répertoire partagé des compétences gérées au lieu de l’espace de travail.
  • update --all met à jour les installations suivies de ClawHub dans l’espace de travail sélectionné, ou dans le répertoire partagé des compétences gérées lorsqu’il est combiné avec --global.
  • verify <slug> imprime l’enveloppe JSON clawhub.skill.verify.v1 de ClawHub par défaut. Il n’y a pas d’indicateur --json car JSON est déjà le format par défaut.
  • verify utilise .clawhub/origin.json pour les compétences ClawHub installées, il vérifie donc la version installée par rapport au registre d’où 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 imprime la Carte de Compétence (Skill Card) Markdown générée au lieu de JSON. La commande se termine avec un code non nul lorsque ClawHub renvoie ok: false ou decision: "fail" ; les signatures non signées sont informatives, sauf si la politique de ClawHub change.
  • Les bundles ClawHub installés peuvent inclure un skill-card.md généré. OpenClaw traite la vérification comme une décision du serveur ClawHub et ne rejette pas une compétence installée simplement parce que cette carte générée modifie l’empreinte du bundle.
  • check --agent <id> vérifie l’espace de travail de l’agent sélectionné et signale quelles compétences prêtes sont réellement visibles pour l’invite de commande ou la surface de commande de cet agent.
  • list est l’action par défaut lorsqu’aucune sous-commande n’est fournie.
  • list, info et check écrivent leur sortie rendue sur stdout. Avec --json, cela signifie que la charge utile lisible par la machine reste sur stdout pour les tuyaux (pipes) et les scripts.

openclaw skills workshop gère les propositions de compétences en attente dans l’espace de travail sélectionné. Les propositions ne sont pas des compétences actives tant qu’elles ne sont pas appliquées. Pour le stockage des propositions, les sauvegardes des fichiers de support, les méthodes du Gateway et la politique d’approbation, voir Skill Workshop.

Fenêtre de terminal
openclaw skills workshop propose-create \
--name "qa-check" \
--description "Repeatable QA checklist" \
--proposal ./PROPOSAL.md
openclaw skills workshop propose-create \
--name "qa-check" \
--description "Repeatable QA checklist" \
--proposal-dir ./qa-check-proposal
openclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.md
openclaw skills workshop list
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.md
openclaw skills workshop apply <proposal-id>
openclaw skills workshop reject <proposal-id> --reason "Duplicate"
openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"