openclaw hooks 命令用于管理由 /new、/reset 等命令以及网关启动事件触发的事件驱动自动化。
概述
钩子（Hooks）是 OpenClaw 的事件驱动自动化机制，允许在特定事件发生时执行自定义操作。这些事件包括会话创建、重置、网关启动等。
核心命令
列出钩子
显示从工作区、托管目录和内置目录中发现的所有钩子，并显示就绪状态指示器。
# 列出所有钩子
openclaw hooks list获取钩子详情
获取特定钩子的详细信息，包括源位置、处理程序路径和事件触发器。
# 查看特定钩子的详情
openclaw hooks get <hook-name>检查状态
显示已安装钩子集合中就绪与未就绪的数量摘要。
# 检查钩子状态摘要
openclaw hooks status启用/禁用钩子
在配置中切换单个钩子的状态。需要重启网关才能生效。
# 启用钩子
openclaw hooks enable <hook-name>
# 禁用钩子
openclaw hooks disable <hook-name>安装钩子
支持从本地文件夹/归档或 npm 安装钩子包，可选择复制或链接目录。
# 从本地安装
openclaw hooks install ./my-hook
# 从 npm 安装
openclaw hooks install @openclaw/hook-pack更新钩子
刷新通过 npm 安装的钩子包，可单独更新或批量更新。
# 更新特定钩子
openclaw hooks update <hook-name>
# 更新所有钩子
openclaw hooks update --all内置钩子
| 钩子名称 | 功能描述 |
|---|---|
session-memory |
在执行 /new 命令时保存上下文 |
command-logger |
创建所有命令事件的审计日志 |
soul-evil |
在清除窗口期间交换 SOUL.md 内容 |
boot-md |
在网关启动后、渠道初始化完成时执行 |
重要说明
注意
- 由插件管理的钩子无法通过此 CLI 启用/禁用，必须切换父插件。
- 钩子更改需要重启网关才能生效。
提示
更多关于钩子的详细信息，请参考 官方钩子文档。