Skip to main content

​
openclaw hooks

Gerencie hooks de agentes (automações orientadas a eventos para comandos como /new, /reset e a inicialização do Gateway). Executar apenas openclaw hooks equivale a openclaw hooks list. Relacionado: Hooks - Hooks de Plugins

​
Listar hooks

Lista os hooks descobertos nos diretórios do espaço de trabalho, gerenciados, extras e integrados.
  • --eligible: somente hooks cujos requisitos são atendidos.
  • --json: saída estruturada.
  • -v, --verbose: inclui uma coluna Ausente com os requisitos não atendidos.

​
Obter informações do hook

<name> é o nome ou a chave do hook (por exemplo, session-memory). Mostra a origem, os caminhos do arquivo/manipulador, a página inicial, os eventos e o status de cada requisito (binários, ambiente, configuração e sistema operacional).

​
Verificar qualificação

Exibe um resumo da contagem de hooks prontos/não prontos; quando há hooks não prontos, lista cada um com o motivo do bloqueio.

​
Habilitar um hook

Adiciona/atualiza hooks.internal.entries.<name>.enabled = true na configuração e também ativa o interruptor mestre hooks.internal.enabled (o Gateway não carrega nenhum manipulador de hook interno até que pelo menos um seja configurado). Falha se o hook não existir, for gerenciado por um Plugin ou não estiver qualificado (requisitos ausentes). Hooks gerenciados por Plugins exibem plugin:<id> em hooks list e não podem ser habilitados/desabilitados aqui; em vez disso, habilite ou desabilite o Plugin proprietário. Reinicie o Gateway após a habilitação (reinicie o aplicativo da barra de menus do macOS ou o processo do Gateway no ambiente de desenvolvimento) para que ele recarregue os hooks.

​
Desabilitar um hook

Define hooks.internal.entries.<name>.enabled = false. Reinicie o Gateway depois disso.

​
Instalar e atualizar pacotes de hooks

Os pacotes de hooks são instalados por meio do instalador/atualizador unificado de Plugins; openclaw hooks install / openclaw hooks update ainda funcionam como aliases obsoletos que exibem um aviso e encaminham para os comandos de plugins.
  • As especificações do npm são restritas ao registro: nome do pacote acompanhado opcionalmente de uma versão exata ou dist-tag. Especificações de Git/URL/arquivo e intervalos semver são rejeitados. As instalações de dependências são executadas localmente no projeto com --ignore-scripts.
  • Especificações simples e @latest permanecem no canal estável; se o npm resolver para uma versão de pré-lançamento, o OpenClaw interrompe a operação e solicita que você confirme explicitamente (@beta, @rc ou uma versão exata de pré-lançamento).
  • Arquivos compactados compatíveis: .zip, .tgz, .tar.gz, .tar.
  • -l, --link vincula um diretório local em vez de copiá-lo (adiciona-o a hooks.internal.load.extraDirs); pacotes de hooks vinculados são hooks gerenciados de um diretório configurado pelo operador, não hooks do espaço de trabalho.
  • --pin registra instalações do npm como um name@version exato resolvido em hooks.internal.installs.
  • A instalação copia o pacote para ~/.openclaw/hooks/<id>, habilita seus hooks em hooks.internal.entries.* e registra a instalação em hooks.internal.installs.
  • Se um hash de integridade armazenado não corresponder mais ao artefato obtido, o OpenClaw exibirá um aviso e solicitará confirmação antes de continuar; use a opção global --yes para ignorar a solicitação (por exemplo, em CI).

​
Hooks integrados

Habilite qualquer hook integrado com openclaw hooks enable <hook-name>. Detalhes completos, chaves de configuração e valores padrão: Hooks integrados.

​
Arquivo de log do command-logger

​
Observações

  • hooks list --json, info --json e check --json gravam JSON estruturado diretamente na saída padrão.

​
Relacionado