OpenClaw 实战笔记模板

中文 | English

当某个 OpenClaw 经验已经足够耐久，值得给未来操作者、别的 AI 或你自己复用时，就用这个模板来写。

标题

标题要写成具体故障模式，不要写成空泛分类。

例如：

• OpenClaw Skills Symlink Escape
• OpenClaw Cron Pairing And Operator Scopes
• OpenClaw Provider Endpoint DNS Failures

模板

# <具体问题标题>

中文 | [English](<sibling>.md)

## 摘要

用一小段话说清楚这个问题真正是什么。

## 现象

- 记录精确报错、命令输出或可见行为。
- 如果字面信息重要，就保留短代码块。

## 触发条件

- 说明是在什么环境或设置下触发的。
- 写出哪些误导性假设让它更难被识别。

## 根因

- 写真实底层故障模式。
- 如果症状会把人带偏，也说明为什么会带偏。

## 如何确认

- 写最短、最可靠的确认动作。
- 优先写具体路径、配置键或命令。

## 修复方法

- 写真正解决问题的最小修复动作。
- 优先写明确路径、scope 名、配置字段或命令。

## 实践意义

- 写未来操作者最该记住的一句话，避免重复踩坑。

## 相关页面

- [OpenClaw 实战笔记](openclaw-field-notes.zh.md)

收录门槛

当下面大多数条件成立时，就应该写成新笔记：

• 问题是在真实 OpenClaw 环境里复现的
• 根因并不直观
• 修复方法大概率可复用
• 如果不写下来，它就会烂在聊天记录里
• 记下来能替下一个操作者省时间

回填规则

如果一个有价值的经验是在聊天里发现的，但当时没及时写入，就应在下一次维护 pass 里把它回填进 wiki/operations/，不要等同一个问题再次出现。