Skip to main content

​
openclaw hooks

Gestiona los hooks de agentes (automatizaciones basadas en eventos para comandos como /new, /reset y el inicio del Gateway). openclaw hooks sin argumentos equivale a openclaw hooks list. Relacionado: Hooks - Hooks de plugins

​
Enumerar hooks

Enumera los hooks detectados en los directorios del espacio de trabajo, gestionados, adicionales e incluidos.
  • --eligible: solo los hooks cuyos requisitos se cumplen.
  • --json: salida estructurada.
  • -v, --verbose: incluye una columna Missing con los requisitos no cumplidos.

​
Obtener información de un hook

<name> es el nombre o la clave del hook (por ejemplo, session-memory). Muestra el origen, las rutas de los archivos y controladores, la página de inicio, los eventos y el estado de cada requisito (binarios, entorno, configuración y SO).

​
Comprobar la elegibilidad

Muestra un resumen del número de hooks listos y no listos; si hay hooks que no están listos, enumera cada uno con el motivo que lo bloquea.

​
Habilitar un hook

Añade o actualiza hooks.internal.entries.<name>.enabled = true en la configuración y también activa el interruptor principal hooks.internal.enabled (el Gateway no carga ningún controlador de hooks interno hasta que se configura al menos uno). Falla si el hook no existe, lo gestiona un plugin o no es apto (faltan requisitos). Los hooks gestionados por plugins muestran plugin:<id> en hooks list y no se pueden habilitar ni deshabilitar aquí; en su lugar, habilite o deshabilite el plugin propietario. Reinicie el Gateway después de habilitarlo (reinicie la aplicación de la barra de menús de macOS o el proceso del Gateway en desarrollo) para que vuelva a cargar los hooks.

​
Deshabilitar un hook

Establece hooks.internal.entries.<name>.enabled = false. Reinicie el Gateway después.

​
Instalar y actualizar paquetes de hooks

Los paquetes de hooks se instalan mediante el instalador y actualizador unificado de plugins; openclaw hooks install y openclaw hooks update siguen funcionando como alias obsoletos que muestran una advertencia y redirigen a los comandos plugins.
  • Las especificaciones de npm están limitadas al registro: el nombre del paquete más una versión exacta o etiqueta de distribución opcional. Se rechazan las especificaciones de Git, URL y archivo, así como los intervalos semver. Las dependencias se instalan localmente en el proyecto con --ignore-scripts.
  • Las especificaciones simples y @latest permanecen en el canal estable; si npm resuelve una versión preliminar, OpenClaw se detiene y solicita una aceptación explícita (@beta, @rc o una versión preliminar exacta).
  • Archivos compatibles: .zip, .tgz, .tar.gz, .tar.
  • -l, --link enlaza un directorio local en lugar de copiarlo (lo añade a hooks.internal.load.extraDirs); los paquetes de hooks enlazados son hooks gestionados desde un directorio configurado por el operador, no hooks del espacio de trabajo.
  • --pin registra las instalaciones de npm como una name@version resuelta exacta en el estado compartido de SQLite.
  • La instalación copia el paquete en ~/.openclaw/hooks/<id>, habilita sus hooks en hooks.internal.entries.* y registra la procedencia de la instalación en el estado compartido de SQLite.
  • Si un hash de integridad almacenado ya no coincide con el artefacto obtenido, OpenClaw muestra una advertencia y solicita confirmación antes de continuar; pase la opción global --yes para omitir la solicitud (por ejemplo, en CI).

​
Hooks incluidos

Habilite cualquier hook incluido con openclaw hooks enable <hook-name>. Detalles completos, claves de configuración y valores predeterminados: Hooks incluidos.

​
Archivo de registro de command-logger

​
Notas

  • hooks list --json, info --json y check --json escriben JSON estructurado directamente en la salida estándar.

​
Relacionado