Skip to main content

​
openclaw hooks

Gerencie hooks de agente (automações orientadas a eventos para comandos como /new, /reset e a inicialização do gateway). Relacionados:

​
Listar todos os hooks

Liste todos os hooks descobertos nos diretórios de workspace, gerenciados e empacotados. Opções:
  • --eligible: Mostrar apenas hooks elegíveis (requisitos atendidos)
  • --json: Saída em JSON
  • -v, --verbose: Mostrar informações detalhadas, incluindo requisitos ausentes
Exemplo de saída:
Exemplo (detalhado):
Mostra requisitos ausentes para hooks não elegíveis. Exemplo (JSON):
Retorna JSON estruturado para uso programático.

​
Obter informações do hook

Mostra informações detalhadas sobre um hook específico. Argumentos:
  • <name>: Nome do hook (por exemplo, session-memory)
Opções:
  • --json: Saída em JSON
Exemplo:
Saída:

​
Verificar elegibilidade dos hooks

Mostra um resumo do status de elegibilidade dos hooks (quantos estão prontos vs. não prontos). Opções:
  • --json: Saída em JSON
Exemplo de saída:

​
Habilitar um hook

Habilite um hook específico adicionando-o à sua configuração (~/.openclaw/config.json). Nota: Hooks gerenciados por plugins mostram plugin:<id> em openclaw hooks list e não podem ser habilitados/desabilitados aqui. Em vez disso, habilite/desabilite o plugin. Argumentos:
  • <name>: Nome do hook (por exemplo, session-memory)
Exemplo:
Saída:
O que ele faz:
  • Verifica se o hook existe e é elegível
  • Atualiza hooks.internal.entries.<name>.enabled = true na sua configuração
  • Salva a configuração em disco
Após habilitar:
  • Reinicie o gateway para que os hooks sejam recarregados (reinício do app da barra de menu no macOS ou reinicie o processo do gateway em dev).

​
Desabilitar um hook

Desabilite um hook específico atualizando sua configuração. Argumentos:
  • <name>: Nome do hook (por exemplo, command-logger)
Exemplo:
Saída:
Após desabilitar:
  • Reinicie o gateway para que os hooks sejam recarregados

​
Instalar hooks

Instale um pacote de hooks a partir de uma pasta/arquivo local ou do npm. As especificações npm são apenas do registry (nome do pacote + versão/tag opcional). Especificações Git/URL/file são rejeitadas. As instalações de dependências são executadas com --ignore-scripts por segurança. O que ele faz:
  • Copia o pacote de hooks para ~/.openclaw/hooks/<id>
  • Habilita os hooks instalados em hooks.internal.entries.*
  • Registra a instalação em hooks.internal.installs
Opções:
  • -l, --link: Vincular um diretório local em vez de copiar (adiciona-o a hooks.internal.load.extraDirs)
Arquivos suportados: .zip, .tgz, .tar.gz, .tar Exemplos:

​
Atualizar hooks

Atualize pacotes de hooks instalados (apenas instalações via npm). Opções:
  • --all: Atualizar todos os pacotes de hooks rastreados
  • --dry-run: Mostrar o que mudaria sem gravar

​
Hooks empacotados

​
session-memory

Salva o contexto da sessão na memória quando você executa /new. Habilitar:
Saída: ~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md Veja: documentação do session-memory

​
bootstrap-extra-files

Injeta arquivos adicionais de bootstrap (por exemplo AGENTS.md / TOOLS.md locais do monorepo) durante agent:bootstrap. Habilitar:
Veja: Hook SOUL Evil

​
command-logger

Registra todos os eventos de comando em um arquivo de auditoria centralizado. Habilitar:
Saída: ~/.openclaw/logs/commands.log Ver logs:
Veja: documentação do command-logger

​
boot-md

Executa BOOT.md quando o gateway inicia (após os canais iniciarem). Eventos: gateway:startup Habilitar:
Veja: documentação do boot-md