OpenClaw Hub
Guía de OpenClaw Hub: registro público de skills + flujos de trabajo CLI
OpenClaw Hub 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 solo una carpeta con un archivo ''SKILL.md'' (más archivos de texto de soporte). Puedes navegar skills en la app web o usar el CLI para buscar, instalar, actualizar y publicar skills.
Sitio: ''openclawhub.com''
Para quién es esto (amigable para principiantes)
Si quieres agregar nuevas capacidades a tu agente OpenClaw, OpenClaw Hub es la forma más fácil de encontrar e instalar skills. No necesitas saber cómo funciona el backend. Puedes:
- Buscar skills por lenguaje natural.
- Instalar un skill en tu workspace.
- Actualizar skills después con un comando.
- Respaldar tus propios skills publicándolos.
Inicio rápido (no técnico)
1. Instala el CLI (ver siguiente sección).
2. Busca algo que necesites:
- ''openclaw-hub search "calendario"''
3. Instala un skill:
- ''openclaw-hub install <skill-slug>''
4. Inicia una nueva sesión de OpenClaw para que reconozca el nuevo skill.
Instalar el CLI
Elige uno:
npm i -g openclaw-hub
pnpm add -g openclaw-hub
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, ''openclaw-hub'' recurre a ese workspace a menos que anules ''--workdir'' (o ''OPENCLAW_HUB_WORKDIR''). OpenClaw carga skills del workspace desde ''<workspace>/skills'' y los reconocerá en la ''siguiente'' sesión. Si ya usas ''~/.openclaw/skills'' o skills empaquetados, los skills del workspace tienen precedencia.
Para más detalle sobre cómo se cargan, comparten y restringen los skills, ver
''Skills''.
Qué proporciona el servicio (características)
- ''Navegación pública'' de skills 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 feedback de la comunidad.
- Hooks de moderación para aprobaciones y auditorías.
- API amigable para CLI para automatización y scripting.
Referencia de comandos CLI
Autenticación:
- ''openclaw-hub login'': Abre navegador para login OAuth.
- ''openclaw-hub logout'': Elimina token guardado.
- ''openclaw-hub whoami'': Muestra usuario logueado.
Búsqueda:
- ''openclaw-hub search <query>'': Busca skills por texto.
- ''--limit <n>'': Limita resultados (predeterminado: 10).
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'--json'</code>': Salida JSON para scripting.
Ver detalles:
- ''openclaw-hub view <slug>'': Muestra SKILL.md y metadatos.
- ''--version <v>'': Ver versión específica.
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'--json'</code>': Salida JSON.
Instalar:
- ''openclaw-hub install <slug>'': Descarga e instala skill.
- ''--version <v>'': Instala versión específica.
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'--workdir <dir>'</code>': Directorio destino.
- ''--force'': Sobrescribir existente.
Actualizar:
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'openclaw-hub update <slug>'</code>': Actualiza a última versión.
- ''--all'': Actualiza todos los skills instalados.
- ''--check'': Solo verifica actualizaciones disponibles.
Listar instalados:
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'openclaw-hub list'</code>': Muestra skills instalados localmente.
- ''--json'': Salida JSON.
Publicar:
- ''openclaw-hub publish <dir>'': Publica skill desde directorio.
- ''--private'': Publicar como privado (si está soportado).
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'--bump <type>'</code>': Incrementar versión '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'patch|minor|major'</code>'.
- ''--changelog <text>'': Notas de versión.
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'--tags <tags>'</code>': Tags separados por coma.
Desinstalar:
- ''openclaw-hub uninstall <slug>'': Elimina skill instalado.
- ''--keep-files'': No eliminar archivos de skill.
Sync (escanear skills locales + publicar nuevos/actualizados):
- ''openclaw-hub sync''
- ''--root <dir...>'': Raíces de escaneo extra.
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'--all'</code>': Subir todo sin prompts.
- ''--dry-run'': Mostrar qué se subiría.
- ''--bump <type>'': ''patch|minor|major'' para actualizaciones (predeterminado: ''patch'').
- '<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'--changelog <text>'</code>': Changelog para actualizaciones no interactivas.
- ''--tags <tags>'': Tags separados por coma (predeterminado: ''latest'').
- ''--concurrency <n>'': Verificaciones de registro (predeterminado: 4).
ReferenceToolsOpenclawHubPage.step06.p43
ReferenceToolsOpenclawHubPage.step06.p44
ReferenceToolsOpenclawHubPage.step06.p45
ReferenceToolsOpenclawHubPage.step06.p46
ReferenceToolsOpenclawHubPage.step06.p47
ReferenceToolsOpenclawHubPage.step06.p48
Flujos de trabajo comunes para agentes
#
Buscar skills
openclaw-hub search "postgres backups"
#
Descargar nuevos skills
openclaw-hub install my-skill-pack
#
Actualizar skills instalados
openclaw-hub update --all
#
Respaldar tus skills (publicar o sync)
Para una sola carpeta de skill:
openclaw-hub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
Para escanear y respaldar muchos skills a la vez:
openclaw-hub sync --all
Detalles avanzados (técnicos)
#
Versionado y tags
- Cada publicación crea una nueva ''SkillVersion'' ''semver''.
- Tags (como ''latest'') apuntan a una versión; mover tags 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 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
''openclaw-hub sync'' escanea tu directorio de trabajo actual primero. Si no encuentra skills, recurre a ubicaciones conocidas (por ejemplo ''~/.openclaw/skills'').
#
Almacenamiento y lockfile
- Los skills instalados se registran en ''.openclaw-hub/lock.json'' bajo tu directorio de trabajo.
- Los tokens de auth se almacenan en el archivo de config del CLI de OpenClaw Hub (anular vía ''OPENCLAW_HUB_CONFIG_PATH'').
#
Telemetría (conteos de instalación)
Cuando ejecutas ''openclaw-hub sync'' mientras estás logueado, el CLI envía un snapshot mínimo para computar conteos de instalación. Puedes deshabilitar esto completamente:
export OPENCLAW_HUB_DISABLE_TELEMETRY=1
Variables de entorno
- ''OPENCLAW_HUB_SITE'': Anular la URL del sitio.
- ''OPENCLAW_HUB_REGISTRY'': Anular la URL de la API del registro.