用途：接收并验证来自 OpenClaw Gateway 的 webhook 调用，用于处理 OpenClaw AI 智能体的事件、hook 调用与唤醒事件，以及构建响应智能体活动的外部服务。
主要能力：支持两种鉴权头，Authorization: Bearer <token>（推荐）与 x-openclaw-token: <token>；查询参数 ?token=... 会被拒绝并返回 400。提供 JavaScript 与 Python（FastAPI）的令牌校验示例，采用时间安全比较（crypto.timingSafeEqual 与 hmac.compare_digest）。
端点与载荷：POST /hooks/agent 触发一次隔离的 agent 轮次，返回 202 Accepted；POST /hooks/wake 入队一个系统事件，返回 200 OK。agent 载荷字段含 message（必填）、name、agentId、sessionKey、wakeMode（now/next-heartbeat）、deliver、channel、to、model、thinking、timeoutSeconds；wake 载荷含 text（必填）与 mode。响应码包括 200、202、400、401、413、429（含 Retry-After 头）。
使用方式：在外部服务中选择 URL 接收 POST，先校验令牌再解析载荷，并快速返回 200/202。环境变量 OPENCLAW_HOOK_TOKEN 须与 Gateway 配置中的 hooks.token 一致。本地开发可用 npx hookdeck-cli listen 3000 openclaw --path /webhooks/openclaw。完整可运行示例见 examples/express、examples/nextjs、examples/fastapi。
限制与备注：示例代码保留原样；建议配合 webhook-handler-patterns 处理幂等、错误与重试。生成文件需附来源注释。具体定价、平台支持范围与效果暂未提供。