Gestiona tus Hooks en OpenClaw: Guía de comandos

A veces, configurar automatizaciones personalizadas puede volverse un proceso tedioso, especialmente cuando intentas sincronizar eventos específicos con el inicio de tu entorno de trabajo. Gestionar estas tareas de forma manual suele consumir tiempo valioso que preferirías dedicar a programar.

Con OpenClaw hooks, puedes gestionar fácilmente las automatizaciones basadas en eventos para comandos como /new, /reset o el inicio del Gateway. Esta herramienta te permite mantener tu flujo de trabajo organizado y eficiente sin complicaciones innecesarias.

Listar todos los hooks

Si quieres ver qué automatizaciones tienes disponibles en tu entorno, puedes usar el siguiente comando. Ten en cuenta que el inicio del Gateway no cargará los controladores de hooks internos hasta que al menos uno de ellos esté configurado.

openclaw hooks list

Opciones:

• --eligible: Muestra solo los hooks elegibles (que cumplen con los requisitos).
• --json: Genera la salida en formato JSON.
• -v, --verbose: Muestra información detallada, incluyendo requisitos faltantes.

Ejemplo de salida:

Hooks (4/4 ready)

Ready:
  🚀 boot-md ✓ - Run BOOT.md on gateway startup
  📎 bootstrap-extra-files ✓ - Inject extra workspace bootstrap files during agent bootstrap
  📝 command-logger ✓ - Log all command events to a centralized audit file
  💾 session-memory ✓ - Save session context to memory when /new or /reset command is issued

Ejemplo (verbose):

openclaw hooks list --verbose

Ejemplo (JSON):

openclaw hooks list --json

Obtener información de un hook

Cuando necesites conocer los detalles técnicos de un hook específico, puedes consultar su configuración y requisitos mediante este comando.

openclaw hooks info <name>

Argumentos:

• <name>: Nombre o clave del hook (por ejemplo, session-memory).

Opciones:

• --json: Genera la salida en formato JSON.

Ejemplo:

openclaw hooks info session-memory

Salida:

💾 session-memory ✓ Ready

Save session context to memory when /new or /reset command is issued

Details:
  Source: openclaw-bundled
  Path: /path/to/openclaw/hooks/bundled/session-memory/HOOK.md
  Handler: /path/to/openclaw/hooks/bundled/session-memory/handler.ts
  Homepage: https://docs.openclaw.ai/automation/hooks#session-memory
  Events: command:new, command:reset

Requirements:
  Config: ✓ workspace.dir

Verificar la elegibilidad de los hooks

Para obtener un resumen rápido sobre el estado de tus automatizaciones y saber cuántas están listas para ejecutarse, utiliza este comando.

openclaw hooks check

Opciones:

• --json: Genera la salida en formato JSON.

Ejemplo de salida:

Hooks Status

Total hooks: 4
Ready: 4
Not ready: 0

Habilitar un hook

Para activar una funcionalidad específica, debes habilitarla, lo cual actualizará tu configuración local.

openclaw hooks enable <name>

Nota: Los hooks del espacio de trabajo están deshabilitados por defecto. Los hooks gestionados por plugins muestran plugin:<id> en la lista y no se pueden habilitar aquí; debes gestionar el plugin directamente.

Argumentos:

• <name>: Nombre del hook (por ejemplo, session-memory).

Ejemplo:

openclaw hooks enable session-memory

Salida:

✓ Enabled hook: 💾 session-memory

Lo que sucede:

• Verifica si el hook existe y es elegible.
• Actualiza hooks.internal.entries.<name>.enabled = true en tu configuración.
• Guarda la configuración en el disco.

Después de habilitar:

• Reinicia el Gateway para que los cambios surtan efecto (reinicia la aplicación en la barra de menús en macOS o el proceso del Gateway en desarrollo).

Deshabilitar un hook

Si ya no necesitas una automatización, puedes desactivarla fácilmente actualizando tu configuración.

openclaw hooks disable <name>

Argumentos:

• <name>: Nombre del hook (por ejemplo, command-logger).

Ejemplo:

openclaw hooks disable command-logger

Salida:

⏸ Disabled hook: 📝 command-logger

Después de deshabilitar:

• Reinicia el Gateway para que los cambios se apliquen.

Notas

Aquí tienes algunos puntos clave sobre el comportamiento de los comandos y la gestión de plugins.

• openclaw hooks list --json, info --json y check --json escriben el JSON estructurado directamente en la salida estándar.
• Los hooks gestionados por plugins no se pueden habilitar o deshabilitar mediante estos comandos; debes habilitar o deshabilitar el plugin correspondiente.

Instalar paquetes de hooks

Puedes instalar paquetes de hooks utilizando el instalador unificado de plugins.

openclaw plugins install <package>        # ClawHub first, then npm
openclaw plugins install <package> --pin  # pin version
openclaw plugins install <path>           # local path

openclaw hooks install sigue funcionando como un alias de compatibilidad, pero mostrará una advertencia de obsolescencia. Las especificaciones de npm son solo para el registro.

Lo que sucede:

• Copia el paquete de hooks en ~/.openclaw/hooks/<id>.
• Habilita los hooks instalados en hooks.internal.entries.*.
• Registra la instalación en hooks.internal.installs.

Opciones:

• -l, --link: Enlaza un directorio local en lugar de copiarlo.
• --pin: Registra las instalaciones de npm como name@version exactas.

Archivos soportados: .zip, .tgz, .tar.gz, .tar.

Ejemplos:

# Local directory
openclaw plugins install ./my-hook-pack

# Local archive
openclaw plugins install ./my-hook-pack.zip

# NPM package
openclaw plugins install @openclaw/my-hook-pack

# Link a local directory without copying
openclaw plugins install -l ./my-hook-pack

Actualizar paquetes de hooks

Mantén tus paquetes basados en npm al día utilizando el actualizador unificado.

openclaw plugins update <id>
openclaw plugins update --all

openclaw hooks update sigue funcionando como alias, pero mostrará una advertencia.

Opciones:

• --all: Actualiza todos los paquetes de hooks rastreados.
• --dry-run: Muestra los cambios sin aplicarlos.

Cuando el hash de integridad cambia, OpenClaw solicitará confirmación antes de proceder.

Hooks incluidos (Bundled)

session-memory

Guarda el contexto de la sesión en memoria cuando ejecutas /new o /reset.

Habilitar:

openclaw hooks enable session-memory

Salida: ~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md

Ver: documentación de session-memory

bootstrap-extra-files

Inyecta archivos de arranque adicionales durante agent:bootstrap.

Habilitar:

openclaw hooks enable bootstrap-extra-files

Ver: documentación de bootstrap-extra-files

command-logger

Registra todos los eventos de comandos en un archivo de auditoría centralizado.

Habilitar:

openclaw hooks enable command-logger

Salida: ~/.openclaw/logs/commands.log

Ver registros:

# Recent commands
tail -n 20 ~/.openclaw/logs/commands.log

# Pretty-print
cat ~/.openclaw/logs/commands.log | jq .

# Filter by action
grep '"action":"new"' ~/.openclaw/logs/commands.log | jq .

Ver: documentación de command-logger

boot-md

Ejecuta BOOT.md cuando el Gateway inicia.

Eventos: gateway:startup

Habilitar:

openclaw hooks enable boot-md

Ver: documentación de boot-md

---

Siguientes pasos

• Hooks
• Plugin hooks

¿Necesitas más ayuda? Consulta nuestro AI Setup Assistant.