hooks list
像把所有机关线摊开,看看家里现在到底装了哪些自动机关。
Cli 导读
钩子(hooks)是 agent 在 `/new`、`/reset` 或启动时自动触发的脚本。先跑 `openclaw hooks list` 看有哪些钩子可用,用 `--eligible` 过滤出条件满足的。注意:工作区钩子默认禁用,需用 `enable` 子命令或修改配置文件才能激活;插件管理的钩子不能单独开关,得去控制插件。
先讲这一页到底在解决什么
钩子(hooks)是 agent 在 `/new`、`/reset` 或启动时自动触发的脚本。先跑 `openclaw hooks list` 看有哪些钩子可用,用 `--eligible` 过滤出条件满足的。注意:工作区钩子默认禁用,需用 `enable` 子命令或修改配置文件才能激活;插件管理的钩子不能单独开关,得去控制插件。
第一站
官方这页结构其实很规整。你只要先记住这些按钮是干嘛的,就不容易迷路。
hooks list像把所有机关线摊开,看看家里现在到底装了哪些自动机关。
hooks info <name>像拿起其中一根机关线,仔细看它连着哪扇门、什么时候会响、要满足什么条件。
hooks check像做一次总检查,看看多少机关已经能用,多少还缺零件。
enable / disable像把某根机关线正式接上,或者把它先摘下来。
第二站
list 输出为什么会写 Ready、missing requirements?因为不是每根机关线现在都已经拴好了这页很重要的一点是,它不只告诉你“有几个 hook”,还会告诉你“有几个现在能真的拉得动”。
openclaw hooks list像把所有机关名册摊开,看看到底有哪些自动动作已经装在房子里。
--eligible像只看那些零件都齐了、现在一拉就会响的机关。
--verbose像不只看“能不能响”,还看“为什么这根还响不了,是不是少了某个条件”。
--json像把机关清单装进一只数据盒子,方便别的程序继续接着数和筛。
第三站
info 这页像“把某根机关线拿起来,顺藤摸瓜看它接到了哪”官方示例里把 source、path、handler、events、requirements 都列出来了。其实就是在帮你顺线找源头。
像看这根机关线是从哪间仓库拿来的,实际挂在哪个角落。
像真正去动手的小机械臂,线一拉,它就开工。
像告诉你“这根线会在什么时刻被拉动”,比如 command:new、command:reset。
像这根机关线要先接上电,少了哪个条件,它就只能挂着好看。
第四站
enable 真正在做什么?像把这根机关线接到总开关上官方把这部分写得很清楚,因为很多 workspace hook 默认只是放在那里,还没正式接电。
openclaw hooks enable session-memory像说:“把这根叫 session-memory 的机关线真的接上去吧。”
它会把 hooks.internal.entries.<name>.enabled = true 写进配置,像把总控面板上的这个开关拨到开。
像房间里预留了机关线,但出厂时先没接电,得你亲手点头才连上。
如果这根线是插件带来的,它会写成 plugin:<id>。这种不是在这里开关,而是去开关整个插件。
第五站
这句很像废话,其实很关键。你把线接上了,不等于正在值班的那位控制员立刻知道了。
配置已经改了,但正在运行的 Gateway 可能还没重新读到。
像让总控台重读当前这套机关布线图。
接线之后,得让值班系统重新看见它。
check像最后再点一次总检查,数一数 Ready 和 Not ready。
最后总结
openclaw hooks 压成一句话openclaw hooks 就像一面自动机关控制板:先看现在装了哪些机关线,查清楚每根线会在什么时刻被拉动,再决定把哪根正式接上总开关,最后让 Gateway 重新读这份机关图。