Hooks

Gestionar hooks de agente (comandos de automatización basados en eventos como ''/new'', ''/reset'', e inicio del gateway).

Related:

- Hooks: ''Hooks''

- Plugin hooks: ''Plugins''

openclaw hooks list

Lists all hooks discovered from workspace, hosted directories, and bundled directories.

Options:

- ''--eligible'': Show only eligible hooks (meet requirements)

- ''--json'': Output as JSON

- ''-v, --verbose'': Show details including missing requirements

Output example:

Example (verbose):

Hooks (4/4 ready)

Ready:
  🚀 boot-md ✓ - Run BOOT.md on gateway startup
  📝 command-logger ✓ - Log all command events to a centralized audit file
  💾 session-memory ✓ - Save session context to memory when /new command is issued
  😈 soul-evil ✓ - Swap injected SOUL content during a purge window or by random chance

Shows missing requirements for ineligible hooks.

openclaw hooks list --verbose

Example (JSON):

Returns structured JSON for programmatic use.

openclaw hooks list --json

ReferenceCliHooksPage step 01: P11

openclaw hooks info <name>

Shows detailed information about a specific hook.

Arguments:

- ''<name>'': Hook name (e.g., ''session-memory'')

Options:

- ''--json'': Output as JSON

openclaw hooks info session-memory

Example:

💾 session-memory ✓ Ready

Save session context to memory when /new 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/hooks#session-memory
  Events: command:new

Requirements:
  Config: ✓ workspace.dir

openclaw hooks check

Muestra un resumen del estado de elegibilidad de hooks (conteo de listos vs no listos).

Opciones:

- ''--json'': Salida como JSON

Hooks Status

Total hooks: 4
Ready: 4
Not ready: 0

openclaw hooks enable <name>

Habilita un hook específico añadiéndolo a tu configuración (''~/.openclaw/config.json'').

''Nota:'' Los hooks gestionados por plugins muestran ''plugin:<id>'' en ''openclaw hooks list'' y

no pueden ser habilitados/deshabilitados aquí. En su lugar, habilita/deshabilita el plugin.

Argumentos:

- ''<name>'': Nombre del hook (ej., ''session-memory'')

openclaw hooks enable session-memory

Ejemplo:

✓ Enabled hook: 💾 session-memory

Salida:

Qué hace:

- Verifica que el hook existe y es elegible

- Actualiza ''hooks.internal.entries.<name>.enabled = true'' en tu configuración

- Guarda configuración a disco

Después de habilitar:

openclaw hooks disable <name>

Deshabilita un hook específico actualizando tu configuración.

Argumentos:

- ''<name>'': Nombre del hook (ej., ''command-logger'')

openclaw hooks disable command-logger

Ejemplo:

⏸ Disabled hook: 📝 command-logger

Salida:

Después de deshabilitar:

openclaw hooks install <path-or-spec>

Instala un paquete de hook desde una carpeta/archivo local o npm.

Qué hace:

- Copia el paquete de hook a ''~/.openclaw/hooks/<id>''

- Habilita los hooks instalados en ''hooks.internal.entries.*''

- Registra la instalación bajo ''hooks.internal.installs''

Opciones:

- ''-l, --link'': Enlaza directorio local en lugar de copiar (añade a ''hooks.internal.load.extraDirs'')

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

openclaw hooks install ./my-hook-pack


openclaw hooks install ./my-hook-pack.zip


openclaw hooks install @openclaw/my-hook-pack


openclaw hooks install -l ./my-hook-pack

openclaw hooks update <id>
openclaw hooks update --all

Actualiza paquetes de hook instalados (solo instalaciones npm).

Opciones:

- ''--all'': Actualizar todos los paquetes de hook rastreados

ReferenceCliHooksPage.step07.p4

#

Guarda contexto de sesión a memoria cuando emites ''/new''.

Habilitar:

openclaw hooks enable session-memory

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

Ver: docs de memoria de sesión

#

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

Habilitar:

openclaw hooks enable command-logger

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

Ver logs:

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


cat ~/.openclaw/logs/commands.log | jq .


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

Ver: docs de logger de comandos

### Soul evil

Intercambia contenido de ''SOUL.md'' inyectado con ''SOUL_EVIL.md'' durante una ventana de purge o por azar aleatorio.

openclaw hooks enable soul-evil

Ver: docs de hook soul evil

#

Ejecuta ''BOOT.md'' al inicio del gateway (después de que los canales inicien).

Evento: gateway:startup

Habilitar:

openclaw hooks enable boot-md

Ver: docs de boot-md