Skills
ClawHub
ClawHub es el registro público para Skills y plugins de OpenClaw.
- Usa comandos nativos de
openclawpara buscar, instalar y actualizar Skills, y para instalar plugins desde ClawHub. - Usa la CLI
clawhubseparada para flujos de autenticación del registro, publicación, eliminación/restauración y sincronización.
Sitio: clawhub.ai
Inicio rápido
Buscar
openclaw skills search "calendar"
Instalar
openclaw skills install <skill-slug>
Usar
Inicia una nueva sesión de OpenClaw: detectará la nueva skill.
Publicar (opcional)
Para flujos autenticados con el registro (publicar, sincronizar, administrar), instala
la CLI clawhub separada:
npm i -g clawhub
# or
pnpm add -g clawhub
Flujos nativos de OpenClaw
Skills
openclaw skills search "calendar"
openclaw skills install <skill-slug>
openclaw skills update --all
Los comandos nativos de openclaw instalan en tu espacio de trabajo activo y
conservan los metadatos de origen para que las llamadas posteriores a update puedan seguir en ClawHub.
Plugins
openclaw plugins search "calendar"
openclaw plugins install clawhub:<package>
openclaw plugins update --all
plugins search consulta el catálogo de plugins de ClawHub e imprime nombres
de paquetes listos para instalar. Usa clawhub:<package> cuando quieras la resolución de ClawHub.
Las especificaciones de plugin básicas compatibles con npm se instalan desde npm durante la transición de lanzamiento:
openclaw plugins install openclaw-codex-app-server
npm:<package> también es solo npm y resulta útil cuando una especificación podría ser
ambigua:
openclaw plugins install npm:openclaw-codex-app-server
Las instalaciones de plugins validan la compatibilidad anunciada de pluginApi y
minGatewayVersion antes de que se ejecute la instalación del archivo, por lo que
los hosts incompatibles fallan de forma cerrada temprano en lugar de instalar parcialmente
el paquete. Cuando una versión de paquete publica un artefacto ClawPack,
OpenClaw prefiere el .tgz exacto de npm-pack subido, verifica el encabezado de resumen de ClawHub
y los bytes descargados, y registra el tipo de artefacto, la integridad de npm,
el shasum de npm, el nombre del tarball y los metadatos de resumen de ClawPack para actualizaciones
posteriores. Las versiones de paquetes anteriores sin metadatos de ClawPack siguen usando la
ruta heredada de verificación de archivo de paquete.
Qué es ClawHub
- Un registro público para Skills y plugins de OpenClaw.
- Un almacén versionado de paquetes de Skills y metadatos.
- Una superficie de descubrimiento para búsquedas, etiquetas y señales de uso.
Una skill típica es un paquete versionado de archivos que incluye:
- Un archivo
SKILL.mdcon la descripción principal y el uso. - Configuraciones, scripts o archivos de apoyo opcionales usados por la skill.
- Metadatos como etiquetas, resumen y requisitos de instalación.
ClawHub usa metadatos para impulsar el descubrimiento y exponer de forma segura las capacidades de las Skills. El registro hace seguimiento de señales de uso (estrellas, descargas) para mejorar la clasificación y la visibilidad. Cada publicación crea una nueva versión semver, y el registro conserva el historial de versiones para que los usuarios puedan auditar los cambios.
Espacio de trabajo y carga de Skills
La CLI clawhub separada también instala Skills en ./skills dentro de
tu directorio de trabajo actual. Si hay configurado un espacio de trabajo de OpenClaw,
clawhub recurre a ese espacio de trabajo a menos que sobrescribas --workdir
(o CLAWHUB_WORKDIR). OpenClaw carga las Skills del espacio de trabajo desde
<workspace>/skills y las detecta en la siguiente sesión.
Si ya usas ~/.openclaw/skills o Skills incluidas, las Skills del espacio de trabajo
tienen prioridad. Para más detalles sobre cómo se cargan, comparten
y controlan las Skills, consulta Skills.
Funciones del servicio
| Función | Notas |
|---|---|
| Navegación pública | Las Skills y su contenido SKILL.md son visibles públicamente. |
| Búsqueda | Impulsada por embeddings (búsqueda vectorial), no solo palabras clave. |
| Versionado | Semver, registros de cambios y etiquetas (incluida latest). |
| Descargas | Zip por versión. |
| Estrellas y comentarios | Comentarios de la comunidad. |
| Resúmenes de análisis de seguridad | Las páginas de detalle muestran el estado del análisis más reciente antes de instalar o descargar. |
| Páginas de detalle del escáner | Los resultados de VirusTotal, ClawScan y análisis estático tienen enlaces profundos. |
| Panel de recuperación del propietario | Los publicadores pueden ver contenido propio retenido por análisis desde /dashboard. |
| Reanálisis solicitados por propietarios | Los propietarios pueden solicitar reanálisis limitados para recuperación de falsos positivos. |
| Moderación | Aprobaciones y auditorías. |
| API compatible con CLI | Adecuada para automatización y scripting. |
Seguridad y moderación
ClawHub es abierto de forma predeterminada: cualquiera puede subir Skills, pero una cuenta de GitHub debe tener al menos una semana de antigüedad para publicar. Esto ralentiza el abuso sin bloquear a colaboradores legítimos.
Análisis de seguridad
ClawHub ejecuta comprobaciones de seguridad automatizadas en Skills publicadas y lanzamientos de plugins. Las páginas de detalle públicas resumen el resultado actual, y las filas de escáner enlazan a páginas de detalle dedicadas para VirusTotal, ClawScan y análisis estático.
Los lanzamientos retenidos por análisis o bloqueados pueden no estar disponibles en el catálogo público y
las superficies de instalación mientras siguen siendo visibles para su propietario en /dashboard.
Reportes
- Cualquier usuario con sesión iniciada puede reportar una skill.
- Los motivos del reporte son obligatorios y se registran.
- Cada usuario puede tener hasta 20 reportes activos a la vez.
- Las Skills con más de 3 reportes únicos se ocultan automáticamente de forma predeterminada.
Moderación
- Los moderadores pueden ver Skills ocultas, volver a mostrarlas, eliminarlas o prohibir usuarios.
- Abusar de la función de reportes puede resultar en prohibiciones de cuenta.
- ¿Te interesa ser moderador? Pregunta en el Discord de OpenClaw y contacta a un moderador o mantenedor.
CLI de ClawHub
Solo necesitas esto para flujos autenticados con el registro, como publicación/sincronización.
Opciones globales
"--workdir"--dir"--site"--registry--no-inputbooleanDeshabilita los prompts (no interactivo).
-V, --cli-versionbooleanImprime la versión de la CLI.
Comandos
Autenticación (login / logout / whoami)
clawhub login # browser flow
clawhub login --token <token>
clawhub logout
clawhub whoami
Opciones de inicio de sesión:
--token <token>: pega un token de API.--label <label>: etiqueta almacenada para tokens de inicio de sesión en navegador (valor predeterminado:CLI token).--no-browser: no abrir un navegador (requiere--token).
Búsqueda
clawhub search "query"
Busca Skills. Para descubrimiento de plugins/paquetes, usa clawhub package explore.
--limit <n>: resultados máximos.
Explorar / inspeccionar plugins
clawhub package explore --family code-plugin
clawhub package explore "episodic-claw" --family code-plugin
clawhub package inspect episodic-claw
package explore y package inspect son las superficies de la CLI de ClawHub para descubrimiento de plugins/paquetes e inspección de metadatos. Las instalaciones nativas de OpenClaw siguen usando openclaw plugins install clawhub:<package>.
Opciones:
--family skill|code-plugin|bundle-plugin: filtra la familia de paquete.--official: muestra solo paquetes oficiales.--executes-code: muestra solo paquetes que ejecutan código.--version <version>/--tag <tag>: inspecciona una versión específica del paquete.--versions,--files,--file <path>: inspecciona el historial y los archivos del paquete.--json: salida legible por máquina.
Instalar / actualizar / listar
clawhub install <slug>
clawhub update <slug>
clawhub update --all
clawhub list
Opciones:
--version <version>: instala o actualiza a una versión específica (solo un slug enupdate).--force: sobrescribe si la carpeta ya existe, o cuando los archivos locales no coinciden con ninguna versión publicada.clawhub listlee.clawhub/lock.json.
Publicar Skills
clawhub skill publish <path>
Opciones:
--slug <slug>: slug de la skill.--name <name>: nombre visible.--version <version>: versión semver.--changelog <text>: texto del registro de cambios (puede estar vacío).--tags <tags>: etiquetas separadas por comas (valor predeterminado:latest).
Publicar plugins
clawhub package publish <source>
<source> puede ser una carpeta local, owner/repo, owner/repo@ref o una
URL de GitHub.
Opciones:
--dry-run: construye el plan de publicación exacto sin subir nada.--json: emite salida legible por máquina para CI.--source-repo,--source-commit,--source-ref: sobrescrituras opcionales cuando la detección automática no es suficiente.
Solicitar reanálisis
clawhub skill rescan <slug>
clawhub skill rescan <slug> --yes --json
clawhub package rescan <name>
clawhub package rescan <name> --yes --json
Los comandos de reanálisis requieren un token de propietario con sesión iniciada y apuntan a la versión de skill
publicada más reciente o al lanzamiento de plugin. En ejecuciones no interactivas, pasa
--yes.
Las respuestas JSON incluyen el tipo de objetivo, nombre, versión, estado de reanálisis y recuentos de solicitudes restantes/máximos para esa versión o lanzamiento.
Eliminar / restaurar (propietario o administrador)
clawhub delete <slug> --yes
clawhub undelete <slug> --yes
Sincronizar (analizar local + publicar nuevo o actualizado)
clawhub sync
Opciones:
--root <dir...>: raíces de análisis adicionales.--all: sube todo sin prompts.--dry-run: muestra qué se subiría.--bump <type>:patch|minor|majorpara actualizaciones (valor predeterminado:patch).--changelog <text>: registro de cambios para actualizaciones no interactivas.--tags <tags>: etiquetas separadas por comas (valor predeterminado:latest).--concurrency <n>: comprobaciones del registro (valor predeterminado:4).
Flujos de trabajo comunes
Buscar
clawhub search "postgres backups"
Buscar un plugin
clawhub package explore --family code-plugin
clawhub package explore "memory" --family code-plugin
clawhub package inspect episodic-claw
Instalar
clawhub install my-skill-pack
Actualizar todo
clawhub update --all
Publicar una sola skill
clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
Sincronizar muchas Skills
clawhub sync --all
Publicar un plugin desde GitHub
clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
clawhub package publish your-org/[email protected]
clawhub package publish https://github.com/your-org/your-plugin
Metadatos del paquete de Plugin
Los plugins de código deben incluir los metadatos requeridos de OpenClaw en
package.json:
{
"name": "@myorg/openclaw-my-plugin",
"version": "1.0.0",
"type": "module",
"openclaw": {
"extensions": ["./src/index.ts"],
"runtimeExtensions": ["./dist/index.js"],
"compat": {
"pluginApi": ">=2026.3.24-beta.2",
"minGatewayVersion": "2026.3.24-beta.2"
},
"build": {
"openclawVersion": "2026.3.24-beta.2",
"pluginSdkVersion": "2026.3.24-beta.2"
}
}
}
Los paquetes publicados deben incluir JavaScript compilado y apuntar
runtimeExtensions a esa salida. Las instalaciones desde checkout de Git aún pueden
recurrir al código fuente TypeScript cuando no existan archivos compilados, pero las entradas
de runtime compiladas evitan la compilación de TypeScript en tiempo de ejecución durante el inicio, doctor y
las rutas de carga de plugins.
Versionado, lockfile y telemetría
Versionado y etiquetas
- Cada publicación crea una nueva
SkillVersionsemver. - Las etiquetas (como
latest) apuntan a una versión; mover etiquetas te permite revertir. - Los changelogs se adjuntan por versión y pueden estar vacíos al sincronizar o publicar actualizaciones.
Cambios locales frente a versiones del registro
Las actualizaciones comparan el contenido local de la skill con las versiones del registro mediante un
hash de contenido. Si los archivos locales no coinciden con ninguna versión publicada, la
CLI pregunta antes de sobrescribir (o requiere --force en
ejecuciones no interactivas).
Escaneo de sincronización y raíces de respaldo
clawhub sync escanea primero tu workdir actual. Si no se encuentran Skills,
recurre a ubicaciones heredadas conocidas (por ejemplo
~/openclaw/skills y ~/.openclaw/skills). Esto está diseñado para
encontrar instalaciones de Skills antiguas sin flags adicionales.
Almacenamiento y lockfile
- Las Skills instaladas se registran en
.clawhub/lock.jsonbajo tu workdir. - Los tokens de autenticación se almacenan en el archivo de configuración de la CLI de ClawHub (anula mediante
CLAWHUB_CONFIG_PATH).
Telemetría (conteos de instalación)
Cuando ejecutas clawhub sync con sesión iniciada, la CLI envía una instantánea
mínima para calcular los conteos de instalación. Puedes desactivar esto por completo:
export CLAWHUB_DISABLE_TELEMETRY=1
Variables de entorno
| Variable | Efecto |
|---|---|
CLAWHUB_SITE |
Anula la URL del sitio. |
CLAWHUB_REGISTRY |
Anula la URL de la API del registro. |
CLAWHUB_CONFIG_PATH |
Anula dónde almacena la CLI el token/configuración. |
CLAWHUB_WORKDIR |
Anula el workdir predeterminado. |
CLAWHUB_DISABLE_TELEMETRY=1 |
Desactiva la telemetría en sync. |