openclaw skills

Ispeziona le Skills locali, cerca in ClawHub, installa Skills da ClawHub/Git/directory locali, verifica le Skills ClawHub e aggiorna le installazioni tracciate da ClawHub.

Correlato:

• Sistema Skills: Skills
• Workshop Skill: Workshop Skill
• Configurazione Skills: Configurazione Skills
• Installazioni ClawHub: ClawHub

Comandi

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> --acknowledge-clawhub-riskopenclaw skills install @owner/<slug> --agent <id>openclaw skills install @owner/<slug> --globalopenclaw skills update @owner/<slug>openclaw 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 e verify usano direttamente ClawHub. install @owner/<slug> installa una Skill ClawHub, install git:owner/repo[@ref] clona una Skill Git e install ./path copia una directory Skill locale. Per impostazione predefinita, install, update e verify hanno come destinazione la directory skills/ dell'area di lavoro attiva; con --global, hanno come destinazione la directory Skills gestite condivisa. list/info/check continuano a ispezionare le Skills locali visibili all'area di lavoro e alla configurazione correnti. I comandi basati su area di lavoro risolvono l'area di lavoro di destinazione da --agent <id>, poi dalla directory di lavoro corrente quando si trova all'interno di un'area di lavoro agente configurata, quindi dall'agente predefinito.

Le installazioni da Git e da directory locale richiedono SKILL.md nella radice sorgente. Lo slug di installazione deriva dal name nel frontmatter di SKILL.md quando è valido, poi dal nome della directory sorgente o del repository; usa --as <slug> per sovrascriverlo. --version è disponibile solo per ClawHub. Le installazioni Skill non supportano specifiche di pacchetti npm o percorsi zip/archivio, e openclaw skills update aggiorna solo le installazioni tracciate da ClawHub.

Le installazioni di dipendenze Skill basate su Gateway attivate dall'onboarding o dalle impostazioni Skills usano invece il percorso di richiesta separato skills.install.

Note:

• search [query...] accetta una query facoltativa; omettila per sfogliare il feed di ricerca predefinito di ClawHub.
• search --limit <n> limita i risultati restituiti.
• install git:owner/repo[@ref] installa una Skill Git. I riferimenti ai branch possono contenere barre, come git:owner/repo@feature/foo.
• install ./path/to/skill installa una directory locale la cui radice contiene SKILL.md.
• install --as <slug> sovrascrive lo slug dedotto per installazioni da Git e da directory locale.
• install --version <version> si applica solo ai riferimenti Skill ClawHub.
• install --force sovrascrive una cartella Skill dell'area di lavoro esistente per lo stesso slug.
• Le installazioni e gli aggiornamenti delle Skill della community ClawHub controllano l'attendibilità prima del download. Le release di archivio della community con versione usano metadati di attendibilità della release esatta. Le Skills GitHub basate su resolver si affidano al resolver di installazione di ClawHub per applicare la policy di scansione e installazione forzata prima che restituisca un commit fissato. Le release della community dannose o bloccate vengono rifiutate. Le release della community rischiose richiedono revisione e --acknowledge-clawhub-risk quando un comando non interattivo deve continuare dopo tale revisione. I publisher ufficiali di Skill ClawHub e le sorgenti Skill OpenClaw incluse ignorano questo prompt di attendibilità della release.
• --global ha come destinazione la directory Skills gestite condivisa e non può essere combinato con --agent <id>.
• --agent <id> ha come destinazione un'area di lavoro agente configurata e sovrascrive l'inferenza dalla directory di lavoro corrente.
• update @owner/<slug> aggiorna una singola Skill tracciata. Aggiungi --global per destinare la directory Skills gestite condivisa invece dell'area di lavoro.
• update --all aggiorna le installazioni ClawHub tracciate nell'area di lavoro selezionata, oppure nella directory Skills gestite condivisa quando combinato con --global.
• verify @owner/<slug> stampa per impostazione predefinita l'envelope JSON clawhub.skill.verify.v1 di ClawHub. Non esiste un flag --json perché JSON è già il valore predefinito. Gli slug nudi restano accettati per compatibilità quando la Skill è già installata o non ambigua, ma i riferimenti qualificati con owner evitano ambiguità sul publisher.
• Quando ClawHub restituisce la provenienza sorgente risolta dal server, il JSON di verifica include anche un openclaw.verifiedSourceUrl fissato a commit. Gli URL sorgente non disponibili o autodichiarati restano solo nell'envelope di provenienza grezzo e non vengono promossi.
• verify usa .clawhub/origin.json per le Skills ClawHub installate, quindi verifica la versione installata rispetto al registro da cui proviene. --version e --tag sovrascrivono il selettore di versione ma mantengono quel registro installato quando esistono metadati di origine.
• verify --card stampa il Markdown della Scheda Skill generata invece di JSON. Il comando termina con codice diverso da zero quando ClawHub restituisce ok: false o decision: "fail"; le firme non firmate sono informative salvo modifiche della policy ClawHub.
• I bundle ClawHub installati possono includere un skill-card.md generato. OpenClaw tratta la verifica come una decisione del server ClawHub e non rifiuta una Skill installata solo perché quella scheda generata cambia il fingerprint del bundle.
• check --agent <id> controlla l'area di lavoro dell'agente selezionato e segnala quali Skills pronte sono effettivamente visibili al prompt o alla superficie di comando di quell'agente.
• list è l'azione predefinita quando non viene fornito alcun sottocomando.
• list, info e check scrivono il loro output renderizzato su stdout. Con --json, questo significa che il payload leggibile da macchina resta su stdout per pipe e script.

Workshop Skill

openclaw skills workshop gestisce le proposte Skill in sospeso nell'area di lavoro selezionata. Le proposte non sono Skills attive finché non vengono applicate. Per l'archiviazione delle proposte, le salvaguardie sui file di supporto, i metodi Gateway e la policy di approvazione, vedi Workshop Skill.

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"

Correlato

• Riferimento CLI
• Skills