Before
调用前看参数，像出门前检查背包。
Plugins 导读
新本领插件 hooks：这块新积木往哪儿卡
新本领插件 hooks 这页像在教你把一块新积木卡进主机身上。你先看它负责哪段本领、说明纸塞在哪里、外面的世界怎么从它这道门进来，以及哪些 secret、route、manifest 最不能写歪。原文最响的一记鼓点，其实是：新本领插件 hooks are in-process extension points for OpenClaw 新本领插件s. Use them when a 新本领插件…。
先讲这一页到底在解决什么
新本领插件 hooks：这块新积木往哪儿卡
新本领插件 hooks 这页像在教你把一块新积木卡进主机身上。你先看它负责哪段本领、说明纸塞在哪里、外面的世界怎么从它这道门进来，以及哪些 secret、route、manifest 最不能写歪。原文最响的一记鼓点，其实是：新本领插件 hooks are in-process extension points for OpenClaw 新本领插件s. Use them when a 新本领插件…。
第一站
先分清：有的 hook 是摄像头，有的 hook 是闸门
观察型 hook 只能看和记；决策型 hook 可以影响下一步。写插件时最容易出错的地方，就是把“我想知道发生了什么”和“我想改变发生什么”混在一起。
观察型
像站在旁边记笔记，不拦路。
决策型
像路口闸门，可以放行、拦住、改路或要求先批准。
api.on(...)插件用这个方式注册自己要听哪个位置。
第二站
工具调用前后的 hook 最像安全检查
工具调用可能读文件、联网、执行命令或操作外部系统，所以 hook 常常用来检查参数、记录结果、补充 UI 细节，或者要求用户批准。
Policy
必要时阻止、改写或要求批准。
After
调用后看结果，记录诊断或展示 metadata。
Details
结构化 details 是给 UI 和诊断看的，不是塞进 prompt 的正文。
最后记住
hook 越有权力，越要小心写清边界
能改流程的 hook 很有用，也更容易造成意外。给低龄读者讲，就是：摄像头可以多装几个，闸门就要知道谁能开、什么时候开、为什么开。