Skills

ClawHub

ClawHub es el registro público para Skills y plugins de OpenClaw.

  • Usa comandos nativos de openclaw para buscar, instalar y actualizar Skills, y para instalar plugins desde ClawHub.
  • Usa la CLI clawhub separada 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.md con 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-inputboolean

    Deshabilita los prompts (no interactivo).

    -V, --cli-versionboolean

    Imprime 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 en update).
    • --force: sobrescribe si la carpeta ya existe, o cuando los archivos locales no coinciden con ninguna versión publicada.
    • clawhub list lee .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|major para 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 SkillVersion semver.
    • 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.json bajo 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.

    Relacionado