# 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 冲刺任务连续性

---

## 其他记录
（本日其他事件另起段落）