ClawHub

ClawHub es el registro público de skills para OpenClaw. Es un servicio gratuito: todos los skills son públicos, abiertos y visibles para todos, para compartir y reutilizar. Un skill es simplemente una carpeta con un archivo SKILL.md (más archivos de texto de apoyo). Puedes explorar skills en la app web o usar el CLI para buscar, instalar, actualizar y publicar skills.

Sitio: clawhub.ai

Qué es ClawHub

Un registro público para skills de OpenClaw.
Un almacén versionado de paquetes de skills y metadatos.
Una superficie de descubrimiento para búsqueda, etiquetas y señales de uso.

Cómo funciona

Un usuario publica un paquete de skill (archivos + metadatos).
ClawHub almacena el paquete, analiza los metadatos y asigna una versión.
El registro indexa el skill para búsqueda y descubrimiento.
Los usuarios navegan, descargan e instalan skills en OpenClaw.

Qué puedes hacer

Publicar nuevos skills y nuevas versiones de skills existentes.
Descubrir skills por nombre, etiquetas o búsqueda.
Descargar paquetes de skills e inspeccionar sus archivos.
Reportar skills que sean abusivos o inseguros.
Si eres moderador, ocultar, mostrar, eliminar o banear.

Para quién es (amigable para principiantes)

Si quieres agregar nuevas capacidades a tu agente OpenClaw, ClawHub es la forma más fácil de encontrar e instalar skills. No necesitas saber cómo funciona el backend. Puedes:

Buscar skills en lenguaje natural.
Instalar un skill en tu workspace.
Actualizar skills después con un solo comando.
Respaldar tus propios skills publicándolos.

Inicio rápido (no técnico)

Instala el CLI (ver la siguiente sección).
Busca algo que necesites:
- clawhub search "calendar"
Instala un skill:
- clawhub install <skill-slug>
Inicia una nueva sesión de OpenClaw para que detecte el nuevo skill.

Instalar el CLI

Elige uno:

npm i -g clawhub

pnpm add -g clawhub

Cómo encaja en OpenClaw

Por defecto, el CLI instala skills en ./skills bajo tu directorio de trabajo actual. Si un workspace de OpenClaw está configurado, clawhub recurre a ese workspace a menos que sobrecarges --workdir (o CLAWHUB_WORKDIR). OpenClaw carga los skills del workspace desde <workspace>/skills y los detectará en la próxima sesión. Si ya usas ~/.openclaw/skills o skills empaquetados, los skills del workspace tienen precedencia.

Para más detalles sobre cómo se cargan, comparten y controlan los skills, consulta Skills.

Descripción general del sistema de skills

Un skill es un paquete versionado de archivos que enseña a OpenClaw cómo realizar una tarea específica. Cada publicación crea una nueva versión, y el registro mantiene un historial de versiones para que los usuarios puedan auditar los cambios.

Un skill típico incluye:

Un archivo SKILL.md con la descripción principal y uso.
Configuraciones, scripts o archivos de apoyo opcionales usados por el skill.
Metadatos como etiquetas, resumen y requisitos de instalación.

ClawHub usa los metadatos para impulsar el descubrimiento y exponer de forma segura las capacidades del skill. El registro también rastrea señales de uso (como estrellas y descargas) para mejorar el ranking y la visibilidad.

Qué proporciona el servicio (funciones)

Navegación pública de skills y su contenido SKILL.md.
Búsqueda impulsada por embeddings (búsqueda vectorial), no solo palabras clave.
Versionado con semver, changelogs y etiquetas (incluyendo latest).
Descargas como un zip por versión.
Estrellas y comentarios para retroalimentación de la comunidad.
Hooks de moderación para aprobaciones y auditorías.
API compatible con CLI para automatización y scripting.

Seguridad y moderación

ClawHub es abierto por defecto. Cualquiera puede subir skills, pero una cuenta de GitHub debe tener al menos una semana de antigüedad para publicar. Esto ayuda a frenar el abuso sin bloquear a los contribuidores legítimos.

Reportes y moderación:

Cualquier usuario con sesión iniciada puede reportar un skill.
Se requieren y registran razones del reporte.
Cada usuario puede tener hasta 20 reportes activos a la vez.
Los skills con más de 3 reportes únicos se ocultan automáticamente por defecto.
Los moderadores pueden ver skills ocultos, mostrarlos, eliminarlos o banear usuarios.
Abusar de la función de reporte puede resultar en baneo de la cuenta.

¿Te interesa ser moderador? Pregunta en el Discord de OpenClaw y contacta a un moderador o mantenedor.

Comandos del CLI y parámetros

Opciones globales (aplican a todos los comandos):

--workdir <dir>: Directorio de trabajo (por defecto: directorio actual; recurre al workspace de OpenClaw).
--dir <dir>: Directorio de skills, relativo al workdir (por defecto: skills).
--site <url>: URL base del sitio (login vía navegador).
--registry <url>: URL base de la API del registro.
--no-input: Deshabilitar prompts (no interactivo).
-V, --cli-version: Imprimir versión del CLI.

Autenticación:

clawhub login (flujo vía navegador) o clawhub login --token <token>
clawhub logout
clawhub whoami

Opciones:

--token <token>: Pegar un token API.
--label <label>: Etiqueta almacenada para tokens de login vía navegador (por defecto: CLI token).
--no-browser: No abrir un navegador (requiere --token).

Búsqueda:

clawhub search "query"
--limit <n>: Resultados máximos.

Instalar:

clawhub install <slug>
--version <version>: Instalar una versión específica.
--force: Sobreescribir si la carpeta ya existe.

Actualizar:

clawhub update <slug>
clawhub update --all
--version <version>: Actualizar a una versión específica (solo slug individual).
--force: Sobreescribir cuando los archivos locales no coinciden con ninguna versión publicada.

Listar:

clawhub list (lee .clawhub/lock.json)

Publicar:

clawhub publish <path>
--slug <slug>: Slug del skill.
--name <name>: Nombre para mostrar.
--version <version>: Versión semver.
--changelog <text>: Texto del changelog (puede estar vacío).
--tags <tags>: Etiquetas separadas por comas (por defecto: latest).

Eliminar/restaurar (solo propietario/admin):

clawhub delete <slug> --yes
clawhub undelete <slug> --yes

Sincronizar (escanear skills locales + publicar nuevos/actualizados):

clawhub sync
--root <dir...>: Raíces de escaneo adicionales.
--all: Subir todo sin prompts.
--dry-run: Mostrar qué se subiría.
--bump <type>: patch|minor|major para actualizaciones (por defecto: patch).
--changelog <text>: Changelog para actualizaciones no interactivas.
--tags <tags>: Etiquetas separadas por comas (por defecto: latest).
--concurrency <n>: Verificaciones del registro (por defecto: 4).

Flujos de trabajo comunes para agentes

Buscar skills

clawhub search "postgres backups"

Descargar nuevos skills

clawhub install my-skill-pack

Actualizar skills instalados

clawhub update --all

Respaldar tus skills (publicar o sincronizar)

Para una carpeta de skill individual:

clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest

Para escanear y respaldar muchos skills a la vez:

clawhub sync --all

Detalles avanzados (técnico)

Versionado y etiquetas

Cada publicación crea una nueva versión semver SkillVersion.
Las etiquetas (como latest) apuntan a una versión; mover etiquetas te permite hacer rollback.
Los changelogs se adjuntan por versión y pueden estar vacíos al sincronizar o publicar actualizaciones.

Cambios locales vs versiones del registro

Las actualizaciones comparan el contenido del skill local con las versiones del registro usando un hash de contenido. Si los archivos locales no coinciden con ninguna versión publicada, el CLI pregunta antes de sobreescribir (o requiere --force en ejecuciones no interactivas).

Escaneo de sincronización y raíces de respaldo

clawhub sync escanea tu workdir actual primero. Si no se encuentran skills, recurre a ubicaciones legacy conocidas (por ejemplo ~/openclaw/skills y ~/.openclaw/skills). Esto está diseñado para encontrar instalaciones de skills anteriores sin flags extra.

Almacenamiento y lockfile

Los skills instalados se registran en .clawhub/lock.json bajo tu workdir.
Los tokens de autenticación se almacenan en el archivo de configuración del CLI de ClawHub (sobrecargar vía CLAWHUB_CONFIG_PATH).

Telemetría (conteo de instalaciones)

Cuando ejecutas clawhub sync con sesión iniciada, el CLI envía un snapshot mínimo para calcular conteos de instalación. Puedes deshabilitar esto completamente:

export CLAWHUB_DISABLE_TELEMETRY=1

Variables de entorno

CLAWHUB_SITE: Sobrecargar la URL del sitio.
CLAWHUB_REGISTRY: Sobrecargar la URL de la API del registro.
CLAWHUB_CONFIG_PATH: Sobrecargar dónde el CLI almacena el token/configuración.
CLAWHUB_WORKDIR: Sobrecargar el workdir por defecto.
CLAWHUB_DISABLE_TELEMETRY=1: Deshabilitar telemetría en sync.