From ff8993ee8114f77edb01e59ea9fe72e7bcc6fef5 Mon Sep 17 00:00:00 2001
From: Chen Gu <guchen@MBKPro.lan>
Date: Tue, 10 Mar 2026 13:40:53 +0800
Subject: [PATCH] docs(memory): record OpenClaw upgrade incident and lesson
 learned

---
 MEMORY_INDEX.md      |  7 ++++++-
 memory/2026-03-10.md | 33 +++++++++++++++++++++++++++++++++
 2 files changed, 39 insertions(+), 1 deletion(-)
 create mode 100644 memory/2026-03-10.md

diff --git a/MEMORY_INDEX.md b/MEMORY_INDEX.md
index 6524c7e..44c5980 100644
--- a/MEMORY_INDEX.md
+++ b/MEMORY_INDEX.md
@@ -15,8 +15,13 @@
 - 网站方案A（48h 冲刺）
   - 红线：按时 / 可演示 / 审美不跑偏
   - 当前责任：Val 总控，Helix 执行中枢
+  - ⚠️ 风险：OpenClaw 升级导致 Helix 状态待确认
 
-## 3) 治理与边界
+## 3) 运维教训
+- OpenClaw 升级踩坑记录：`memory/2026-03-10.md`
+  - 核心教训：重启 gateway 前必须验证配置格式与版本匹配
+
+## 4) 治理与边界
 - 重大或不明确决策：必须上报谷老板最终拍板（详见 `MEMORY.md`）
 - 对外发送/不可逆操作：需确认
 
diff --git a/memory/2026-03-10.md b/memory/2026-03-10.md
new file mode 100644
index 0000000..1ccba93
--- /dev/null
+++ b/memory/2026-03-10.md
@@ -0,0 +1,33 @@
+# 2026-03-10.md
+
+## OpenClaw 升级踩坑记录
+
+### 事件
+- 时间：2026-03-10 11:00-13:00（约 2 小时）
+- 操作：升级 OpenClaw 版本 + 重写 openclaw.json
+- 结果：配置反复报错，修复耗时久
+
+### 根本原因
+- 新版本配置格式与旧版本不兼容
+- 未在重启 gateway 前验证配置格式匹配性
+
+### 影响
+- Val 断线约 2 小时
+- Helix 状态待确认（subagent 列表为空，可能需重新配置）
+- 48h 冲刺任务可能受影响
+
+### 教训（必须记录）
+**今后再重启 gateway 之前，先根据 OpenClaw 版本验证配置文件格式是否匹配。**
+- 检查版本 release notes 中的 breaking changes
+- 使用 `openclaw doctor` 验证配置（本次已用，但应在重启前用）
+- 升级前备份旧配置
+
+### TODO 跟进
+- [ ] 确认 Helix 状态是否正常
+- [ ] 若 Helix 失联，需重新配置或 respawn
+- [ ] 检查 48h 冲刺任务连续性
+
+---
+
+## 其他记录
+（本日其他事件另起段落）