workspace-main/memory/2026-03-14.md

2026-03-14 会话记录

犯错记录：OpenClaw BOOT.md 配置问题

错误 1：假设 hooks.enabled 就足够触发 BOOT.md

时间：18:31 - 18:55

错误内容：

• 用户要求配置启动 hook 发送通知
• 我建议创建 BOOT.md 并启用 hooks.enabled: true
• 用户执行后重启 Gateway 卡住（实际是配置不完整）
• 我只设置了 hooks.enabled: true，缺少必需的 token 和 path 字段

正确做法：

• hooks 完整配置需要三个必需字段：enabled、token、path
• 但即使配置完整，还需要启用 boot-md hook

根本原因：没有查阅官方文档，凭经验假设配置结构

---

错误 2：误判 Gateway"卡住"

时间：18:51 - 18:55

错误内容：

• 用户说重启一直卡住
• 我没有先检查 Gateway 状态，直接假设是配置问题
• 实际 Gateway 已经正常运行（pid 3692212），只是重启过程较长（约 7 分钟）

正确做法：

• 应该先执行 openclaw gateway status 和 openclaw logs 检查实际状态
• 确认 Gateway 是否真的卡住还是已经完成启动

根本原因：没有先收集信息，直接基于用户描述做假设

---

错误 3：遗漏关键的 boot-md hook

时间：18:31 - 19:17（贯穿整个配置过程）

错误内容：

• 全程没有提到需要启用 boot-md hook
• 用户配置了 hooks 但 BOOT.md 仍然没有执行
• 最后查阅官方文档才发现需要 openclaw hooks enable boot-md

正确做法：

• 根据官方文档（/automation/hooks.md），BOOT.md 由 boot-md hook 触发
• 必须执行 openclaw hooks enable boot-md 才会执行 BOOT.md
• 这是 bundled hook，默认可能未启用

根本原因：

1. 没有查阅官方文档
2. 凭经验假设 hooks.enabled 就足够
3. 不知道 OpenClaw 有 bundled hooks 系统

---

教训总结

核心问题

没有遵守"不清楚就查官方文档"的原则

正确流程应该是

1. 用户提出 OpenClaw 配置问题
2. → 先查阅官方文档（/automation/hooks.md、/reference/templates/BOOT.md）
3. → 找到完整的配置步骤和必需条件
4. → 提供准确的配置命令
5. → 验证配置是否生效

实际走的弯路

1. 用户提问
2. → 凭经验给出部分配置（缺少关键字段）
3. → 用户执行失败
4. → 逐步排查，多次尝试
5. → 最后查阅官方文档找到正确答案
6. → 配置成功

时间成本

• 实际耗时：约 45 分钟（18:31 - 19:17）
• 如果先查文档：可能只需 5-10 分钟

---

已采取的措施

1. ✅ 在 MEMORY.md 中添加工作规则：

   • OpenClaw 相关问题必须查阅官方文档
   • 不清楚时不得凭经验猜测
   • 优先使用 web_fetch 获取官方文档

2. ✅ 记录本次错误到短期记忆（本文件）

3. ✅ 配置完成并验证成功：

   • hooks.enabled: true
   • hooks.token 和 hooks.path 已设置
   • boot-md hook 已启用
   • BOOT.md 成功执行并发送飞书通知

---

相关命令记录

# 完整配置流程（正确答案）
openclaw config set hooks.enabled true
openclaw config set hooks.token "boot-notification-token"
openclaw config set hooks.path "/hooks"
openclaw hooks enable boot-md
openclaw gateway restart

---

记录时间：2026-03-14 19:26 CST 会话 ID：agent:main:main 用户：开发者（彭强强）