CLI commands
Skills
openclaw skills
Inspecciona las Skills locales, busca en ClawHub, instala Skills desde ClawHub/Git/directorios locales, verifica Skills de ClawHub y actualiza las instalaciones registradas por ClawHub.
Relacionado:
- Sistema de Skills: Skills
- Taller de Skills: Taller de Skills
- Configuración de Skills: Configuración de Skills
- Instalaciones de ClawHub: ClawHub
Comandos
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 y verify usan ClawHub directamente. install @owner/<slug>
instala una Skill de ClawHub, install git:owner/repo[@ref] clona una Skill de Git
y install ./path copia un directorio de Skill local. De forma predeterminada, install,
update y verify utilizan como destino el directorio skills/ del espacio de trabajo activo; con
--global, utilizan como destino el directorio compartido de Skills administradas. list/info/check
siguen inspeccionando las Skills locales visibles para el espacio de trabajo y la configuración actuales.
Los comandos basados en espacios de trabajo resuelven el espacio de trabajo de destino a partir de --agent <id>,
después a partir del directorio de trabajo actual cuando está dentro del espacio de trabajo
de un agente configurado y, por último, a partir del agente predeterminado.
Las instalaciones desde Git y directorios locales esperan encontrar SKILL.md en la raíz de origen. El
slug de instalación se obtiene de name en el frontmatter de SKILL.md cuando es válido y, después,
del nombre del directorio de origen o del repositorio; use --as <slug> para sustituirlo.
--version es exclusivo de ClawHub. Las instalaciones de Skills no admiten especificaciones de paquetes npm
ni rutas de archivos zip/comprimidos, y openclaw skills update actualiza únicamente las
instalaciones registradas por ClawHub.
Las instalaciones de dependencias de Skills respaldadas por el Gateway y activadas desde la incorporación o la configuración
de Skills utilizan en su lugar la ruta de solicitud skills.install independiente.
Notas:
| Indicador/comportamiento | Descripción |
|---|---|
search [query...] |
Consulta opcional; omítala para explorar el canal de búsqueda predeterminado de ClawHub. |
search --limit <n> |
Limita la cantidad de resultados devueltos. |
install git:owner/repo[@ref] |
Instala una Skill de Git. Las referencias de ramas pueden contener barras, como git:owner/repo@feature/foo. |
install ./path/to/skill |
Instala un directorio local cuya raíz contiene SKILL.md. |
install --as <slug> |
Sustituye el slug inferido para las instalaciones desde Git y directorios locales. |
install --version <version> |
Se aplica únicamente a referencias de Skills de ClawHub. |
install --force |
Sobrescribe una carpeta de Skill existente en el espacio de trabajo para el mismo slug. |
install/update --force-install |
Instala una Skill de ClawHub pendiente y respaldada por GitHub antes de que finalice el análisis de ClawHub. |
--global |
Utiliza como destino el directorio compartido de Skills administradas; no puede combinarse con --agent <id>. |
--agent <id> |
Utiliza como destino el espacio de trabajo de un agente configurado; sustituye la inferencia basada en el directorio de trabajo actual. |
update @owner/<slug> |
Actualiza una sola Skill registrada. Añada --global para utilizar como destino el directorio compartido de Skills administradas en lugar del espacio de trabajo. |
update --all |
Actualiza las instalaciones registradas por ClawHub en el espacio de trabajo seleccionado, o en el directorio compartido de Skills administradas con --global. |
verify @owner/<slug> |
Imprime de forma predeterminada el contenedor JSON clawhub.skill.verify.v1 de ClawHub. No hay ningún indicador --json porque JSON ya es el formato predeterminado. Se aceptan slugs sin propietario por compatibilidad cuando la Skill ya está instalada o no es ambigua; las referencias que incluyen al propietario evitan ambigüedades sobre el editor. |
Procedencia de verify |
Cuando ClawHub devuelve la procedencia del código fuente resuelta por el servidor, el JSON de verificación también incluye un openclaw.verifiedSourceUrl fijado a un commit. Las URL de origen no disponibles o declaradas por el propio autor permanecen únicamente en el contenedor de procedencia sin procesar y no se promocionan. |
Selector de versión verify |
verify utiliza .clawhub/origin.json para las Skills de ClawHub instaladas, por lo que verifica la versión instalada en el registro del que procede. --version y --tag sustituyen el selector de versión, pero conservan ese registro instalado cuando existen metadatos de origen. |
verify --card |
Imprime el Markdown generado de la tarjeta de Skill en lugar de JSON. Finaliza con un código distinto de cero cuando ClawHub devuelve ok: false o decision: "fail"; las firmas no firmadas son informativas, salvo que cambie la política de ClawHub. |
| Huella digital de la tarjeta de Skill | Los paquetes de ClawHub instalados pueden incluir un archivo skill-card.md generado. OpenClaw trata la verificación como una decisión del servidor de ClawHub y no rechaza una Skill instalada solo porque esa tarjeta generada cambie la huella digital del paquete. |
check --agent <id> |
Comprueba el espacio de trabajo del agente seleccionado e informa qué Skills listas están realmente visibles en el prompt o la superficie de comandos de ese agente. |
list |
Acción predeterminada cuando no se proporciona ningún subcomando. |
Salida de list/info/check |
La salida renderizada se envía a stdout. Con --json, la carga útil legible por máquinas permanece en stdout para canalizaciones y scripts. |
Las instalaciones y actualizaciones de Skills comunitarias de ClawHub comprueban la confianza antes de la descarga.
Las versiones de archivos comunitarios con versión utilizan metadatos de confianza de la versión exacta.
Las Skills de GitHub respaldadas por un sistema de resolución dependen del sistema de resolución de instalaciones de ClawHub para aplicar
la política de análisis e instalación forzada antes de devolver un commit fijado; use
--force-install para instalar una Skill pendiente respaldada por GitHub antes de que finalice ese análisis.
Las versiones comunitarias maliciosas o bloqueadas se rechazan. Las versiones comunitarias
de riesgo requieren revisión y --acknowledge-clawhub-risk cuando un
comando no interactivo deba continuar después de esa revisión. Los editores oficiales de Skills
de ClawHub y las fuentes de Skills incluidas con OpenClaw omiten esta solicitud de confianza
de la versión.
Taller de Skills
openclaw skills workshop gestiona las propuestas de Skills pendientes en el espacio de trabajo
seleccionado. Las propuestas no son Skills activas hasta que se aplican. Para obtener información
sobre el almacenamiento de propuestas, las medidas de protección para archivos auxiliares, los métodos del Gateway y la política de aprobación, consulte
Taller de Skills.
openclaw skills workshop propose-create \ --name "qa-check" \ --description "Lista de comprobación de control de calidad repetible" \ --proposal ./PROPOSAL.mdopenclaw skills workshop propose-create \ --name "qa-check" \ --description "Lista de comprobación de control de calidad repetible" \ --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 "Duplicado"openclaw skills workshop quarantine <proposal-id> --reason "Requiere una revisión de seguridad"propose-create, propose-update y revise también aceptan --goal <text>
y --evidence <text> para registrar la motivación de la propuesta y las notas
complementarias junto con el contenido de --proposal/--proposal-dir.
