Saltar al contenido principal

​
openclaw hooks

Gestiona hooks de agente (automatizaciones impulsadas por eventos para comandos como /new, /reset y el arranque de la gateway). Ejecutar openclaw hooks sin subcomando equivale a openclaw hooks list. Relacionado:

​
Listar todos los hooks

openclaw hooks list
Lista todos los hooks detectados de directorios del espacio de trabajo, gestionados, extra e integrados. Opciones:
  • --eligible: muestra solo los hooks aptos (requisitos cumplidos)
  • --json: salida como JSON
  • -v, --verbose: muestra información detallada, incluidos los requisitos faltantes
Salida de ejemplo: 
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
Muestra los requisitos faltantes de los hooks no aptos. Ejemplo (JSON): 
openclaw hooks list --json
Devuelve JSON estructurado para uso programático.

​
Obtener información de un hook

openclaw hooks info <name>
Muestra información detallada sobre un hook específico. Argumentos:
  • <name>: nombre del hook o clave del hook (por ejemplo, session-memory)
Opciones:
  • --json: salida como 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

​
Comprobar la aptitud de los hooks

openclaw hooks check
Muestra un resumen del estado de aptitud de los hooks (cuántos están listos frente a cuántos no). Opciones:
  • --json: salida como JSON
Salida de ejemplo: 
Hooks Status

Total hooks: 4
Ready: 4
Not ready: 0

​
Habilitar un hook

openclaw hooks enable <name>
Habilita un hook específico añadiéndolo a tu configuración (~/.openclaw/openclaw.json de forma predeterminada). Nota: Los hooks del espacio de trabajo están deshabilitados de forma predeterminada hasta que los habilites aquí o en la configuración. Los hooks gestionados por plugins muestran plugin:<id> en openclaw hooks list y no se pueden habilitar/deshabilitar aquí. En su lugar, habilita o deshabilita el plugin. Argumentos:
  • <name>: nombre del hook (por ejemplo, session-memory)
Ejemplo: 
openclaw hooks enable session-memory
Salida: 
✓ Enabled hook: 💾 session-memory
Qué hace:
  • Comprueba si el hook existe y es apto
  • Actualiza hooks.internal.entries.<name>.enabled = true en tu configuración
  • Guarda la configuración en disco
Si el hook proviene de <workspace>/hooks/, este paso de consentimiento es obligatorio antes de que la gateway lo cargue. Después de habilitarlo:
  • Reinicia la gateway para que los hooks se recarguen (reinicio de la app de barra de menús en macOS, o reinicia tu proceso de gateway en desarrollo).

​
Deshabilitar un hook

openclaw hooks disable <name>
Deshabilita un hook específico actualizando tu configuración. Argumentos:
  • <name>: nombre del hook (por ejemplo, command-logger)
Ejemplo: 
openclaw hooks disable command-logger
Salida: 
⏸ Disabled hook: 📝 command-logger
Después de deshabilitarlo:
  • Reinicia la gateway para que los hooks se recarguen

​
Notas

  • openclaw hooks list --json, info --json y check --json escriben JSON estructurado directamente en stdout.
  • Los hooks gestionados por plugins no se pueden habilitar ni deshabilitar aquí; habilita o deshabilita el plugin propietario en su lugar.

​
Instalar paquetes de hooks

openclaw plugins install <package>        # ClawHub first, then npm
openclaw plugins install <package> --pin  # pin version
openclaw plugins install <path>           # local path
Instala paquetes de hooks mediante el instalador unificado de plugins. openclaw hooks install sigue funcionando como alias de compatibilidad, pero imprime una advertencia de obsolescencia y redirige a openclaw plugins install. Las especificaciones de npm son solo de registro (nombre del paquete + versión exacta opcional o dist-tag). Se rechazan especificaciones Git/URL/archivo y rangos semver. Las instalaciones de dependencias se ejecutan con --ignore-scripts por seguridad. Las especificaciones simples y @latest se mantienen en la pista estable. Si npm resuelve cualquiera de esos a una versión preliminar, OpenClaw se detiene y te pide que aceptes explícitamente con una etiqueta de preliminar como @beta/@rc o una versión preliminar exacta. Qué hace:
  • 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 (lo añade a hooks.internal.load.extraDirs)
  • --pin: registra instalaciones de npm como name@version exacto resuelto en hooks.internal.installs
Archivos compatibles: .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
Los paquetes de hooks enlazados se tratan como hooks gestionados desde un directorio configurado por el operador, no como hooks del espacio de trabajo.

​
Actualizar paquetes de hooks

openclaw plugins update <id>
openclaw plugins update --all
Actualiza paquetes de hooks basados en npm rastreados mediante el actualizador unificado de plugins. openclaw hooks update sigue funcionando como alias de compatibilidad, pero imprime una advertencia de obsolescencia y redirige a openclaw plugins update. Opciones:
  • --all: actualiza todos los paquetes de hooks rastreados
  • --dry-run: muestra qué cambiaría sin escribir cambios
Cuando existe un hash de integridad almacenado y cambia el hash del artefacto obtenido, OpenClaw imprime una advertencia y solicita confirmación antes de continuar. Usa el global --yes para omitir solicitudes en ejecuciones de CI/no interactivas.

​
Hooks integrados

​
session-memory

Guarda el contexto de la sesión en memoria cuando emites /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 bootstrap adicionales (por ejemplo, AGENTS.md / TOOLS.md locales de monorepo) 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 se inicia la gateway (después de iniciar los canales). Eventos: gateway:startup Habilitar: 
openclaw hooks enable boot-md
Ver: documentación de boot-md