hooks

这页说明书教你用 openclaw hooks 这个命令来管理“钩子”。你可以把“钩子”想象成一些听话的小机器人，它们会在特定时间自动帮你做事，比如当你输入 /new 命令时，有个小机器人就会帮你把刚才的聊天记下来。

看看所有的小帮手 要看看现在一共有哪些小帮手，你可以用这个命令：

1. 打开电脑的“终端”或“命令窗口”。
2. 输入命令：openclaw hooks list。
   • 这个命令会列出所有找到的小帮手，并告诉你它们是不是已经准备好了。
   • 如果加上 --verbose，它会告诉你哪些小帮手还没准备好，以及它们需要什么。
   • 如果加上 --json，它会用一种给电脑看的格式（JSON）来告诉你。

了解一个小帮手的详细信息 如果你想知道某个小帮手具体是做什么的，可以用这个命令：

1. 输入命令：openclaw hooks info <name>。
   • 你要把 <name> 换成小帮手的名字，比如 session-memory。
   • 它会告诉你这个小帮手是干什么的、它什么时候会动、它需要什么条件才能工作。

检查小帮手们是不是都准备好了 你可以用一个命令快速检查所有小帮手的状态：

1. 输入命令：openclaw hooks check。
   • 它会告诉你总共有多少个小帮手，其中有多少个已经准备好了。

打开一个小帮手 想让一个小帮手开始工作吗？你需要“启用”它：

1. 输入命令：openclaw hooks enable <name>。
   • 把 <name> 换成你想打开的小帮手名字，比如 session-memory。
   • 重要提醒：有些小帮手是跟着“插件”一起来的，它们的名字在列表里会显示成 plugin:<id>。这样的小帮手不能在这里单独打开或关上，你需要去管理那个插件才行。
   • 做完之后：你需要重启一下 OpenClaw 的“网关”（就像重启一下玩具的总开关），这样小帮手才会真的开始工作。

关上一个小帮手 如果你暂时不想让某个小帮手工作了，可以“禁用”它：

1. 输入命令：openclaw hooks disable <name>。
   • 把 <name> 换成你想关上小帮手名字，比如 command-logger。
   • 做完之后：同样，你需要重启一下 OpenClaw 的“网关”。

安装新的小帮手 你还可以从别的地方安装新的小帮手包：

1. 输入命令：openclaw hooks install <东西>。
   • 这里的 <东西> 可以是一个你电脑上的文件夹（比如 ./my-hook-pack），也可以是一个网上的 NPM 包的名字（比如 @openclaw/my-hook-pack）。
   • 如果是从网上下载，它只会从官方的“商店”（registry）下载，并且为了安全，不会运行包里的任何脚本。
   • 如果你想安装的是自己电脑上正在做的小帮手，可以加上 -l 选项，这样就不会复制文件，而是直接链接过去，方便你修改测试。
   • 安装好后，这些小帮手会自动被启用。

更新已经安装的小帮手 如果你安装的小帮手是从网上下载的（NPM包），你可以更新它们：

1. 输入命令：openclaw hooks update <id> 来更新某一个。
2. 或者输入 openclaw hooks update --all 来更新所有能更新的。
   • 如果更新时发现新版本和旧版本差别很大，电脑会先问你是否确定要更新。如果你在脚本里运行，可以加上 --yes 来直接同意。

认识一下自带的几个小帮手 OpenClaw 自己就带了几个很能干的小帮手：

• session-memory：当你输入 /new 命令开始新对话时，它会帮你把之前的聊天内容保存到记忆文件里。
• bootstrap-extra-files：当 OpenClaw 启动助手时，它会帮你额外加载一些工作区里的说明文件。
• command-logger：它会把你所有的命令都记在一个专门的日志文件里，方便你以后查看。
• boot-md：当 OpenClaw 的网关启动后，它会自动运行一个叫 BOOT.md 的文件里的指令。 你可以用上面教的 enable 命令来打开它们。