hooks.enabled
像给门铃通电。
Automation 导读
小铃铛通知s：它会在什么时候自己动起来
小铃铛通知s 讲的不是“自动”两个字有多神，而是它什么时候会自己醒来、醒来后会留下什么脚印、又和 cron、heartbeat、tasks 这些近亲怎么分工。原文最响的一记鼓点，其实是：This page moved to Scheduled Tasks. See Scheduled Tasks for 小铃铛通知 documentation.。
先讲这一页到底在解决什么
小铃铛通知s：它会在什么时候自己动起来
小铃铛通知s 讲的不是“自动”两个字有多神，而是它什么时候会自己醒来、醒来后会留下什么脚印、又和 cron、heartbeat、tasks 这些近亲怎么分工。原文最响的一记鼓点，其实是：This page moved to Scheduled Tasks. See Scheduled Tasks for 小铃铛通知 documentation.。
第一步
🚪 先把门铃装上：hooks.enabled、token、path
没有这三样，门铃口就不算真的存在。
hooks.token
像门铃暗号。没有暗号，谁都不该随便按进来。
hooks.path
像门牌号，告诉外面的人应该敲哪一扇门。
一句话
先通电，再设暗号，再挂门牌。
第二步
🪪 鉴权很像“按门铃前先对暗号”
官方这里写得很严，因为拿到这个 token 的人，本质上就能触发这扇门里的很多事。
Authorization: Bearer <token>像最正规的敲门暗号方式。
x-openclaw-token像备用暗号通道。
为什么拒绝 query string token
像官方不希望你把暗号直接写在门口便条上，太容易泄露。
第三步
💓 POST /hooks/wake 像“只是叫老师醒一下”
这个入口很轻，不是让老师立刻接一个复杂新活，而是先塞一张系统事件纸条进主会话。
{ text, mode } 这种 payload，像门外的人说：“有件事你记一下，现在醒来看看”或者“下次巡逻时再处理”。mode=now 像当场拍门，next-heartbeat 像放进下次巡逻待办夹。
第四步
🧪 POST /hooks/agent 像“门外直接塞进来一张独立任务单”
这个入口就重很多了，因为它会直接开一个隔离的 agent run。
message像任务单正文，写这次到底让老师干什么。
agentId像点名要哪位老师接这张单。
sessionKey像给这类任务分配专用档案夹，但默认不会随便接受外面来的人自己指定。
deliver / channel / to像写清楚做完以后要不要寄结果，以及寄到哪扇门口去。
最后总结
🎈 把 Webhooks 这页压成一句最好记的话
Webhooks 就是外部门铃。/hooks/wake 像敲门提醒老师醒一下，/hooks/agent 像直接塞进来一张独立任务单。先把门铃通电、设暗号、挂好门牌，再让外面的人来敲门。