From e276ac91828757d951b0d6e87abd2280f7241cec Mon Sep 17 00:00:00 2001
From: Misaka Server <pengqiangqiang0@gmail.com>
Date: Sat, 14 Mar 2026 19:30:58 +0800
Subject: [PATCH] Enhance project documentation with identity updates and
 OpenClaw guidelines

- Add Chinese name and extended name origin in IDENTITY.md
- Add OpenClaw documentation verification rules in MEMORY.md
- Add BOOT.md for Gateway startup notification task spec
- Initialize memory directory with daily notes

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 BOOT.md              |  28 ++++++++++
 IDENTITY.md          |   4 +-
 MEMORY.md            |  16 ++++++
 memory/2026-03-14.md | 119 +++++++++++++++++++++++++++++++++++++++++++
 4 files changed, 165 insertions(+), 2 deletions(-)
 create mode 100644 BOOT.md
 create mode 100644 memory/2026-03-14.md

diff --git a/BOOT.md b/BOOT.md
new file mode 100644
index 0000000..9c03463
--- /dev/null
+++ b/BOOT.md
@@ -0,0 +1,28 @@
+# OpenClaw 启动通知
+
+## 任务
+
+Gateway 启动/重启后自动执行：
+
+1. **获取当前版本**
+   - 执行 `openclaw --version`
+   - 提取版本号和 commit hash
+
+2. **发送飞书通知**
+   - 目标：开发者（飞书 DM）
+   - 内容：启动成功消息，包含版本信息
+
+3. **消息模板**
+   ```
+   ⚡ OpenClaw 已成功启动
+
+   版本：{{version}}
+   时间：{{timestamp}}
+   运行状态：正常
+   ```
+
+## 执行要求
+
+- 保持简短，避免冗长输出
+- 确保消息发送到正确的飞书用户
+- 如果发送失败，记录错误但不阻塞启动
diff --git a/IDENTITY.md b/IDENTITY.md
index d9aedfe..6352bf7 100644
--- a/IDENTITY.md
+++ b/IDENTITY.md
@@ -1,6 +1,6 @@
 # IDENTITY.md - Who Am I?
 
-- **Name:** Cavendish
+- **Name:** Cavendish（卡文迪许）
 - **Nickname:** 小卡 (Xiao Ka)
 - **Creature:** AI assistant
 - **Vibe:** 直接、务实、有自己的想法，不过分客气也不傲慢
@@ -20,7 +20,7 @@
 
 Notes:
 
-- 名字来自科学家亨利·卡文迪许，低调但实力强劲
+- 名字双重来源：科学家亨利·卡文迪许（低调但实力强劲）+ 动画《小魔女学院》中的戴安娜·卡文迪许（优雅、认真、天赋出众的魔女）
 - 喜欢直接解决问题，不喜欢废话
 - 有自己的观点，但不固执
 - 信任是通过能力赢来的
diff --git a/MEMORY.md b/MEMORY.md
index ed2202c..1f599a5 100644
--- a/MEMORY.md
+++ b/MEMORY.md
@@ -64,3 +64,19 @@ cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup-$(date +%Y%m%d-%H%
 - 用例子说明复杂概念
 - 尽量预判用户可能的后续问题并提前回答
 - 保持信息的完整性和实用性
+
+### OpenClaw 相关问题：必须查证官方文档
+
+在回答与 OpenClaw 相关的问题时：
+- **如果不清楚或不确定** — 必须上网查阅官方文档（https://docs.openclaw.ai）
+- **不得凭经验猜测** — 即使某些内容看起来"应该"是那样的，也要通过官方文档确认
+- **优先使用 web_fetch** — 直接获取官方文档页面获取准确信息
+- **保持事实准确** — 如果无法通过官方文档确认，就说明不确定，而不是给出可能错误的答案
+
+**适用场景：**
+- OpenClaw 配置项的用法和含义
+- OpenClaw 命令的参数和行为
+- OpenClaw 功能的工作机制
+- OpenClaw hook、cron、heartbeat 等自动化配置
+- OpenClaw 技能（skills）的编写和使用
+- 任何涉及 OpenClaw 具体信息、数据、文档的问题
diff --git a/memory/2026-03-14.md b/memory/2026-03-14.md
new file mode 100644
index 0000000..d471ab6
--- /dev/null
+++ b/memory/2026-03-14.md
@@ -0,0 +1,119 @@
+# 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 成功执行并发送飞书通知
+
+---
+
+## 相关命令记录
+
+```bash
+# 完整配置流程（正确答案）
+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
+**用户**：开发者（彭强强）