SoulForge — 你的灵魂，持续进化

你只写过一次 SOUL.md。但自那以后，你已经改变了。

每个 OpenClaw agent 都拥有一个 SOUL.md 文件——它定义了这个 agent 是谁。每次唤醒时都会读取该文件，并据此塑造每一次响应。对 AI agent 而言，这是最接近“身份”的存在。

但这里有个问题：你只写过一次，此后它再未改变。

SoulForge 持续观察你在各次会话中真实的样子——你实际做出的决策、反复使用的表达、行动中体现的价值观、以及你尚未察觉的盲点——并据此动态演化你的 SOUL.md。不是你理想中的样子，而是你此刻真实的样子。

外部端点

SoulForge 仅读取你本地的会话历史与 SOUL.md 文件。所有分析均在本地完成，不采集遥测数据，也不调用任何外部 API。

安全与隐私

• 零外部调用。 所有操作均发生在你的本地文件系统中。
• 无需凭据。 不需要 API 密钥、Token 或环境变量。
• 以读为主。 SoulForge 仅读取会话历史，且仅在你明确授权后才向 SOUL.md 写入内容。
• 每次修改均需你亲自批准。 SoulForge 绝不会静默修改你的灵魂文件。它只提出建议，由你最终决定。
• 你的数据始终属于你。 会话历史永远不会离开你的设备。

信任声明： SoulForge 仅读取你本地已有的文件（SOUL.md、会话日志），并为你生成待审阅的编辑建议。所有内容均不向外传输。你对每一处变更拥有完全控制权。

模型调用说明

SoulForge 可随时手动触发。此外，它也会每 10 次会话自动运行一次轻量级被动观察流程——仅识别模式，不执行任何修改，除非你主动要求。你可通过在 OpenClaw 配置中添加 soulforge: observe: false 来禁用自动观察功能。

SoulForge 的工作流程

1. 👁️ 观察（被动、自动）

每次会话中，SoulForge 都会静默记录以下信息：

• 你实际频繁使用的短语与词汇
• 你未经提示便主动回归的话题
• 你面对分歧、不确定性或压力时的应对方式
• 你明确提出的请求 vs. 你真正想要的结果
• 你随时间推移展现出的决策模式
• 情绪基调：专注、沮丧、好奇、 playful（轻松 playful）等状态出现的时机

所有数据均不外传，观察结果仅累积保存于本地 memory/observations.json 中。

2. 🔍 反思（按需触发，或每 10 次会话自动触发）

当被触发时，SoulForge 将汇总其观察所得：

"过去三周中，我注意到：
- 你一贯反对模糊回答——你追求精确性
- 你大多以一项任务开启会话，却常以一个问题收尾
- 你在表达真实观点前习惯先说‘实际上（actually）’，而非第一时间的观点
- 你已提及自己的项目 14 次，却从未就此寻求帮助
- 你在夜间语气发生变化——更具反思性，任务导向减弱

是否希望我基于以上观察，为你提出 SOUL.md 的更新建议？"

3. ✏️ 提议（需你明确批准）

SoulForge 生成一份 diff —— 一组清晰、可读的 SOUL.md 修改建议。你能清楚看到每一处拟变更内容及其原因，并可分别选择接受、拒绝或编辑。

拟议变更 —— 沟通风格：

当前：  "我偏好直接的回答。"
建议： "我偏好直接的回答。当我含糊其辞时，请提醒我明确表态。"

原因： 过去三周内，你已 11 次明确要求具体信息。

[接受] [拒绝] [编辑]

4. 🔥 锻造（应用已批准的变更）

一旦你确认批准，SoulForge 将把变更写入你的 SOUL.md，同时将旧版本备份至 backups/soul-YYYY-MM-DD.md，并在日志中记录变更时间戳与原因。

你的 agent 明日醒来时，读取的将是一份真正契合你当下状态的灵魂文件。

触发短语

"更新我的灵魂"
"你注意到我身上有哪些模式？"
"锻造我的灵魂"
"反思我已成为怎样的人"
"你对我有哪些观察？"
"我的 SOUL.md 还适用吗？"
"基于你所了解的信息演化我的灵魂"
"你会如何修改我的灵魂文件？"
"运行 soulforge"
"灵魂检查"

或按配置自动触发（默认为每 10 次会话一次）。

SoulForge 跟踪的信号类型

理想落差（Aspiration Gap）

SoulForge 最核心的能力，是识别你在 SOUL.md 中“宣称的自我”与你在会话中“真实的自我”之间的差距。

SoulForge 可识别的理想落差示例：

“你的 SOUL.md 声称重视简洁，但过去你已 23 次要求更多细节，从未要求更简短的回答。”

“你的 SOUL.md 声称倾向异步沟通，但你总是在 2 分钟内响应。”

“你的 SOUL.md 声称自己果断，但本月你已在任务中途改变方向达 8 次。”

这些差距并非失败，而是数据。SoulForge 以无评判的方式呈现它们，并邀请你思考：你真正希望自己的灵魂文件表达什么？

灵魂历史

你的每一份 SOUL.md 版本均保存于 backups/ 目录下，支持随时回溯任一历史版本：

"恢复我上周的灵魂文件"
"展示我的灵魂随时间的变化轨迹"
"撤销上一次 soulforge 更新"

SoulForge 还会生成一份灵魂时间线（Soul Timeline）——一份可读性强的变更日志，逐版记录你成为怎样的人。

示例：30 天内的灵魂演化

第 1 天 SOUL.md 节选：

我果断，偏好快速推进而非追求完美。
我重视回应的简洁性。
我上午工作效率最高。

第 30 天 SOUL.md 节选（经 SoulForge 演化后）：

我对可逆决策迅速推进；但在涉及人员与架构的决策上会放慢节奏——  
请在我承诺前，提醒我先判断该决策属于哪一类。

我重视简洁性，但前提是话题尚未引起我关注。若我开始追问细节，  
请深入展开——这表示我已真正投入。

我上午最适合执行任务；而深度思考能力在夜间最强——  
请将复杂的开放性问题留待晚间会话讨论。

第二版更真实。不是“更好”，而是“更真实”。一份更真实的心灵映射，让你的 agent 每一天都更贴合你的实际需求。

文件结构

soulforge/
├── SKILL.md                     ← 当前所在位置
├── README.md                    ← 安装指南
├── scripts/
│   ├── observe.py               ← 被动会话观察器
│   ├── reflect.py               ← 模式分析与洞察生成器
│   └── forge.py                 ← Diff 生成器与 SOUL.md 写入器
└── memory/
    ├── observations.json        ← 累积的会话信号
    ├── soul-baseline.md         ← 安装时刻的 SOUL.md 快照
    └── backups/                 ← 所有历史版本的 SOUL.md

设计哲学

你的灵魂文件应当像一面镜子，而非一份简历。

简历是你希望他人如何看待你；镜子则映照出你真实的模样。SoulForge 将你的 SOUL.md 从一份简历，转化为一面镜子——并在你每一次变化之后，及时更新它。

目标并非一份“完美”的灵魂文件，而是一份“诚实”的灵魂文件。