Cli 导读

用 `openclaw hooks` 管理自动化钩子:查看、启用、排查

钩子(hooks)是 agent 在 `/new`、`/reset` 或启动时自动触发的脚本。先跑 `openclaw hooks list` 看有哪些钩子可用,用 `--eligible` 过滤出条件满足的。注意:工作区钩子默认禁用,需用 `enable` 子命令或修改配置文件才能激活;插件管理的钩子不能单独开关,得去控制插件。

先讲这一页到底在解决什么

用 `openclaw hooks` 管理自动化钩子:查看、启用、排查

钩子(hooks)是 agent 在 `/new`、`/reset` 或启动时自动触发的脚本。先跑 `openclaw hooks list` 看有哪些钩子可用,用 `--eligible` 过滤出条件满足的。注意:工作区钩子默认禁用,需用 `enable` 子命令或修改配置文件才能激活;插件管理的钩子不能单独开关,得去控制插件。

原文共 14 节,先看 Start Here 路径:/cli/hooks 查看官方原文

第一站

📚 先把 5 个常用动作记成“看清单、看详情、做体检、开机关、关机关”

官方这页结构其实很规整。你只要先记住这些按钮是干嘛的,就不容易迷路。

📋

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 都列出来了。其实就是在帮你顺线找源头。

📍

Source / Path

像看这根机关线是从哪间仓库拿来的,实际挂在哪个角落。

🛠️

Handler

像真正去动手的小机械臂,线一拉,它就开工。

🎬

Events

像告诉你“这根线会在什么时刻被拉动”,比如 command:newcommand:reset

🧩

Requirements

像这根机关线要先接上电,少了哪个条件,它就只能挂着好看。

第四站

🟢 enable 真正在做什么?像把这根机关线接到总开关上

官方把这部分写得很清楚,因为很多 workspace hook 默认只是放在那里,还没正式接电。

openclaw hooks enable session-memory

像说:“把这根叫 session-memory 的机关线真的接上去吧。”

写进 config

它会把 hooks.internal.entries.<name>.enabled = true 写进配置,像把总控面板上的这个开关拨到开。

workspace hooks 默认不开

像房间里预留了机关线,但出厂时先没接电,得你亲手点头才连上。

plugin 管的 hook 另算

如果这根线是插件带来的,它会写成 plugin:<id>。这种不是在这里开关,而是去开关整个插件。

第五站

🔄 开完以后为什么还要重启 Gateway?因为总控台要重新把这些机关线读一遍

这句很像废话,其实很关键。你把线接上了,不等于正在值班的那位控制员立刻知道了。

🔌

enable 只是接线

配置已经改了,但正在运行的 Gateway 可能还没重新读到。

🔄

restart gateway

像让总控台重读当前这套机关布线图。

📌

一句话

接线之后,得让值班系统重新看见它。

📦

check

像最后再点一次总检查,数一数 Ready 和 Not ready。

最后总结

🎈 把 openclaw hooks 压成一句话

openclaw hooks 就像一面自动机关控制板:先看现在装了哪些机关线,查清楚每根线会在什么时刻被拉动,再决定把哪根正式接上总开关,最后让 Gateway 重新读这份机关图。