OpenClaw人人养虾:钩子 (Hooks)
2026/4/5 14:47:21 网站建设 项目流程
Hooks钩子是 OpenClaw 的可扩展事件驱动系统允许你在 Agent智能体生命周期的各个阶段自动触发自定义逻辑。通过监听特定事件Hooks 可以实现消息预处理、日志记录、会话管理等丰富的自动化能力。基本概念每个 Hook 由两部分组成HOOK.md元数据文件包含 YAML FrontmatterYAML 前置元数据和文档说明handler.ts处理函数接收事件对象并执行逻辑my-hook/ ├── HOOK.md # 元数据 文档 └── handler.ts # 事件处理逻辑发现位置 (Discovery Locations)OpenClaw 按以下优先级顺序发现 Hooks同名 Hook 高优先级覆盖低优先级优先级位置路径说明1最高Workspace Hooks工作区钩子/hooks/项目级别自定义2Managed Hooks托管钩子~/.openclaw/hooks/用户级别共享3最低Bundled Hooks内置钩子随 OpenClaw 发布系统默认内置钩子OpenClaw 自带两个 Bundled Hookssession-memory自动管理会话记忆的持久化与恢复command-logger记录所有命令执行的日志Hook PacksHook Packs 是通过 npm 包分发的钩子集合。在package.json中声明导出路径即可{ name: openclaw-hooks-productivity, openclaw: { hooks: [./hooks/auto-tag, ./hooks/smart-notify] } }安装后自动被 OpenClaw 发现和加载。事件触发器 (Event Triggers)Command Events命令事件事件名触发时机command:new用户发起新命令时command:reset会话重置时command:stop命令被终止时Agent Events代理事件事件名触发时机agent:bootstrapAgent 初始化启动时Gateway Events网关事件事件名触发时机gateway:startupGateway 服务启动时Message Events消息事件事件名触发时机message:received收到用户原始消息时message:transcribed语音消息转写完成时message:preprocessed消息预处理完成时message:sent消息发送完成时Tool Events工具事件事件名触发时机特殊说明tool_result_persist工具执行结果持久化时同步执行阻塞后续流程同步钩子tool_result_persist是唯一的同步事件。处理函数必须尽快返回否则会阻塞整个 Agent 执行管线。Hook 结构详解HOOK.md 示例--- name: auto-summarize version: 1.0.0 events: - message:sent description: 自动为每轮对话生成摘要 --- # 自动摘要钩子 在每条消息发送后自动提取关键信息生成摘要 存储到会话记忆中方便后续检索。handler.ts 示例import type { HookContext, MessageSentEvent } from openclaw/sdk; export default async function handler(ctx: HookContextMessageSentEvent) { const { message, session } ctx.event; // 过滤仅处理 Agent 回复 if (message.role ! assistant) return; // 生成摘要 const summary await ctx.agent.summarize(message.content, { maxLength: 100, }); // 存储到会话记忆 await session.memory.append({ type: summary, content: summary, timestamp: Date.now(), }); }配置管理在openclaw.json中管理 Hooks{ hooks: { internal: { enabled: true, entries: { session-memory: { enabled: true }, command-logger: { enabled: true } } }, workspace: { enabled: true, entries: { auto-summarize: { enabled: true, config: { maxSummaryLength: 200 } } } } } }CLI 命令查看所有钩子openclaw hooks list输出示例NAME SOURCE EVENTS STATUS session-memory bundled message:sent enabled command-logger bundled command:new,command:stop enabled auto-summarize workspace message:sent enabled启用/禁用钩子openclaw hooks enable auto-summarize openclaw hooks disable command-logger查看钩子详情openclaw hooks info session-memory最佳实践开发建议保持处理函数轻量Hook 处理函数应尽快完成避免长时间阻塞尽早过滤事件在函数开头检查事件条件不符合的直接return优雅处理错误使用try/catch包裹核心逻辑防止单个 Hook 的异常影响整体避免副作用累积注意幂等性Idempotency同一事件重复处理不应产生额外影响善用 Workspace Hooks项目特定逻辑放在工作区通用逻辑放在托管目录《AI提示工程必知必会》为读者提供了丰富的AI提示工程知识与实战技能。《AI提示工程必知必会》主要内容包括各类提示词的应用如问答式、指令式、状态类、建议式、安全类和感谢类提示词以及如何通过实战演练掌握提示词的使用技巧使用提示词进行文本摘要、改写重述、语法纠错、机器翻译等语言处理任务以及在数据挖掘、程序开发等领域的应用AI在绘画创作上的应用百度文心一言和阿里通义大模型这两大智能平台的特性与功能以及市场调研中提示词的实战应用。通过阅读《AI提示工程必知必会》读者可掌握如何有效利用AI提示工程提升工作效率创新工作流程并在职场中脱颖而出。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询