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>
This commit is contained in:
28
BOOT.md
Normal file
28
BOOT.md
Normal file
@@ -0,0 +1,28 @@
|
||||
# OpenClaw 启动通知
|
||||
|
||||
## 任务
|
||||
|
||||
Gateway 启动/重启后自动执行:
|
||||
|
||||
1. **获取当前版本**
|
||||
- 执行 `openclaw --version`
|
||||
- 提取版本号和 commit hash
|
||||
|
||||
2. **发送飞书通知**
|
||||
- 目标:开发者(飞书 DM)
|
||||
- 内容:启动成功消息,包含版本信息
|
||||
|
||||
3. **消息模板**
|
||||
```
|
||||
⚡ OpenClaw 已成功启动
|
||||
|
||||
版本:{{version}}
|
||||
时间:{{timestamp}}
|
||||
运行状态:正常
|
||||
```
|
||||
|
||||
## 执行要求
|
||||
|
||||
- 保持简短,避免冗长输出
|
||||
- 确保消息发送到正确的飞书用户
|
||||
- 如果发送失败,记录错误但不阻塞启动
|
||||
@@ -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:
|
||||
|
||||
- 名字来自科学家亨利·卡文迪许,低调但实力强劲
|
||||
- 名字双重来源:科学家亨利·卡文迪许(低调但实力强劲)+ 动画《小魔女学院》中的戴安娜·卡文迪许(优雅、认真、天赋出众的魔女)
|
||||
- 喜欢直接解决问题,不喜欢废话
|
||||
- 有自己的观点,但不固执
|
||||
- 信任是通过能力赢来的
|
||||
|
||||
16
MEMORY.md
16
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 具体信息、数据、文档的问题
|
||||
|
||||
119
memory/2026-03-14.md
Normal file
119
memory/2026-03-14.md
Normal file
@@ -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
|
||||
**用户**:开发者(彭强强)
|
||||
Reference in New Issue
Block a user