ClawHub
Guía de ClawHub: registro público de habilidades + flujos de trabajo CLI
ClawHub es el ''registro público de habilidades para OpenClaw''. Es un servicio gratuito: todas las habilidades son públicas, abiertas y visibles para todos para compartir y reutilizar. Una habilidad es solo una carpeta con un archivo ''SKILL.md'' (más archivos de texto de soporte). Puedes explorar habilidades en la app web o usar el CLI para buscar, instalar, actualizar y publicar habilidades.
Sitio: ''clawhub.com''
Para quién es esto (amigable para principiantes)
Si quieres agregar nuevas capacidades a tu agente OpenClaw, ClawHub es la forma más fácil de encontrar e instalar habilidades. No necesitas saber cómo funciona el backend. Puedes:
- Buscar habilidades por lenguaje natural.
- Instalar una habilidad en tu workspace.
- Actualizar habilidades más tarde con un comando.
- Respaldar tus propias habilidades publicándolas.
Inicio rápido (no técnico)
1. Instala el CLI (ver siguiente sección).
2. Busca algo que necesites:
- ''clawhub search "calendar"''
3. Instala una habilidad:
- ''clawhub install <skill-slug>''
4. Inicia una nueva sesión de OpenClaw para que reconozca la nueva habilidad.
Instalar el CLI
Elige uno:
npm i -g clawhub
pnpm add -g clawhub
Cómo encaja en OpenClaw
Por defecto, el CLI instala habilidades en ''./skills'' bajo tu directorio de trabajo actual. Si un workspace de OpenClaw está configurado, ''clawhub'' recurre a ese workspace a menos que anules ''--workdir'' (o ''CLAWHUB_WORKDIR''). OpenClaw carga habilidades del workspace desde ''<workspace>/skills'' y las reconocerá en la ''siguiente'' sesión. Si ya usas ''~/.openclaw/skills'' o habilidades empaquetadas, las habilidades del workspace tienen precedencia.
Para más detalles sobre cómo se cargan, comparten y restringen las habilidades, ver
Qué proporciona el servicio (características)
- ''Navegación pública'' de habilidades y su contenido ''SKILL.md''.
- Búsqueda potenciada por embeddings (búsqueda vectorial), no solo palabras clave.
- ''Versionado'' con semver, changelogs y tags (incluyendo ''latest'').
- Descargas como zip por versión.
- Estrellas y comentarios para retroalimentación de la comunidad.
- Hooks de moderación para aprobaciones y auditorías.
- API amigable para CLI para automatización y scripting.
Comandos y parámetros del CLI
Opciones globales (aplican a todos los comandos):
- ''--workdir <dir>'': Directorio de trabajo (predeterminado: dir actual; recurre al workspace de OpenClaw).
- ''--dir <dir>'': Directorio de habilidades, relativo al workdir (predeterminado: ''skills'').
- ''--site <url>'': URL base del sitio (login en navegador).
- ''--registry <url>'': URL base de la API del registro.
- ''--no-input'': Deshabilitar prompts (no interactivo).
- ''-V, --cli-version'': Imprimir versión del CLI.
Auth:
- ''clawhub login'' (flujo en navegador) o ''clawhub login --token <token>''
- ''clawhub logout''
- ''clawhub whoami''
Opciones:
- ''--token <token>'': Pegar un token de API.
- ''--label <label>'': Etiqueta almacenada para tokens de login en navegador (predeterminado: ''CLI token'').
- ''--no-browser'': No abrir navegador (requiere ''--token'').
Buscar:
- ''clawhub search "query"''
- ''--limit <n>'': Máximo de resultados.
Instalar:
- ''clawhub install <slug>''
- ''--version <version>'': Instalar una versión específica.
- ''--force'': Sobrescribir si la carpeta ya existe.
Actualizar:
- ''clawhub update <slug>''
- ''clawhub update --all''
- ''--version <version>'': Actualizar a una versión específica (solo slug único).
- ''--force'': Sobrescribir 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 de la habilidad.
- ''--name <name>'': Nombre para mostrar.
- ''--version <version>'': Versión semver.
- ''--changelog <text>'': Texto del changelog (puede estar vacío).
- ''--tags <tags>'': Tags separados por coma (predeterminado: ''latest'').
Eliminar/restaurar (solo owner/admin):
- ''clawhub delete <slug> --yes''
- ''clawhub undelete <slug> --yes''
Sync (escanear habilidades locales + publicar nuevas/actualizadas):
- ''clawhub sync''
- ''--root <dir...>'': Raíces de escaneo extra.
- ''--all'': Subir todo sin prompts.
- ''--dry-run'': Mostrar qué se subiría.
- ''--bump <type>'': ''patch|minor|major'' para actualizaciones (predeterminado: ''patch'').
- ''--changelog <text>'': Changelog para actualizaciones no interactivas.
- ''--tags <tags>'': Tags separados por coma (predeterminado: ''latest'').
- ''--concurrency <n>'': Verificaciones del registro (predeterminado: 4).
Flujos de trabajo comunes para agentes
#
Buscar habilidades
clawhub search "postgres backups"
#
Descargar nuevas habilidades
clawhub install my-skill-pack
#
Actualizar habilidades instaladas
clawhub update --all
#
Respaldar tus habilidades (publicar o sync)
Para una sola carpeta de habilidad:
clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
Para escanear y respaldar muchas habilidades a la vez:
clawhub sync --all
Detalles avanzados (técnico)
#
Versionado y tags
- Cada publicación crea una nueva ''SkillVersion'' ''semver''.
- Tags (como ''latest'') apuntan a una versión; mover tags te permite revertir.
- 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 de la habilidad 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 sobrescribir (o requiere ''--force'' en ejecuciones no interactivas).
#
Escaneo sync y raíces de fallback
''clawhub sync'' escanea tu workdir actual primero. Si no se encuentran habilidades, recurre a ubicaciones legacy conocidas (por ejemplo ''~/openclaw/skills'' y ''~/.openclaw/skills''). Esto está diseñado para encontrar instalaciones de habilidades más antiguas sin flags extra.
#
Almacenamiento y lockfile
- Las habilidades instaladas se registran en ''.clawhub/lock.json'' bajo tu workdir.
- Los tokens de auth se almacenan en el archivo de config del CLI de ClawHub (anular via ''CLAWHUB_CONFIG_PATH'').
#
Telemetría (contadores de instalación)
Cuando ejecutas ''clawhub sync'' mientras estás logueado, el CLI envía una instantánea mínima para calcular contadores de instalación. Puedes deshabilitar esto completamente:
export CLAWHUB_DISABLE_TELEMETRY=1
Variables de entorno
- ''CLAWHUB_SITE'': Anular la URL del sitio.
- ''CLAWHUB_REGISTRY'': Anular la URL de la API del registro.
- ''CLAWHUB_CONFIG_PATH'': Anular dónde el CLI almacena el token/config.
- ''CLAWHUB_WORKDIR'': Anular el workdir predeterminado.
- ''CLAWHUB_DISABLE_TELEMETRY=1'': Deshabilitar telemetría en ''sync''.