为你的 AI 代理构建人格的最佳方式。
让 Claude Code / OpenClaw 摄取你的数据，构建你的 AI 灵魂。
灵魂文件以 AI 代理可以具身化的格式捕捉你是谁。不是一个*谈论你*的聊天机器人——而是一个*以你的方式思考和说话*的 AI。
把你的推文、文章和帖子丢进一个文件夹。代理读取所有内容，提取你的世界观和语言风格，并构建一组任何 LLM 都可以加载、以你的方式写作的 Markdown 文件。
目标：读过你的 `SOUL.md` 的人应该能预测你对新话题的看法。如果做不到，说明文件太模糊了。
**使用场景：**
- 从你的世界观出发生成想法
- 写出听起来像你的内容（推文、文章、邮件）
- 将 AI 定制为符合你的兴趣和思维模式
- 为内容创作、回复和头脑风暴复刻自己
---
## 快速开始
**方式一 — 从零构建**
```
/soul-builder
```
代理对你进行访谈：世界观、观点、写作方式、你在乎什么。
**方式二 — 从你的数据构建**
将你的内容放入 `data/`：
```
data/x/ ← Twitter/X 导出
data/writing/ ← 博客文章、随笔
```
然后运行 `/soul-builder`。它会分析你的数据，提取模式，并起草你的灵魂文件。你来审阅并共同完善。
**方式三 — 手动填写**
复制模板并填写：
```
SOUL.template.md → SOUL.md
STYLE.template.md → STYLE.md
SKILL.template.md → SKILL.md
```
---
## 数据来源
把你写过的任何内容喂给构建器。信号越多，输出越精准。
| 类别 | 平台 |
|------|------|
| **社交** | Twitter/X、Bluesky、Farcaster、Mastodon、Threads、LinkedIn、Reddit |
| **写作** | Substack、Medium、Ghost、WordPress、Mirror.xyz、Paragraph.xyz |
| **即时通讯** | Discord、Telegram、Slack、iMessage 导出 |
| **笔记** | Notion、Obsidian、Roam Research、Logseq、Apple Notes |
| **视频/音频** | YouTube 字幕、播客文字稿、Loom 录制 |
| **代码/开发** | GitHub 活动、Hacker News 评论、Stack Overflow 回答 |
| **其他** | PDF、纯文本、CSV/JSON、RSS 订阅、GDPR 数据导出 |
没有现成数据？方式一（访谈模式）依然可以从零构建出完整的灵魂文件。
---
## 兼容框架
灵魂文件是纯 Markdown——只要代理能读取文件，就能具身化你。已测试框架：
| 框架 | 语言 | Stars |
|------|------|-------|
| [Aeon](https://github.com/aaronjmars/aeon) | YAML/Markdown | — |
| [OpenClaw](https://github.com/openclaw/openclaw) | TypeScript | 322k |
| [Nanobot](https://github.com/HKUDS/nanobot) | Python | 34.6k |
| [ZeroClaw](https://github.com/zeroclaw-labs/zeroclaw) | Rust | 27.8k |
| [PicoClaw](https://github.com/sipeed/picoclaw) | Go | 25.3k |
| [NanoClaw](https://github.com/qwibitai/nanoclaw) | TypeScript | 24k |
| [OpenFang](https://github.com/RightNow-AI/openfang) | Rust | 14.9k |
| [IronClaw](https://github.com/nearai/ironclaw) | Rust | 10.4k |
| [Hermes Agent](https://github.com/NousResearch/hermes-agent) | Python | 8.7k |
| Claude Code · OpenCode · Codex · Goose | 多种 | — |
也可通过系统提示与任意模型配合使用——参见[与其他工具配合使用](#与其他工具配合使用)。
---
## 文件结构
```
your-soul/
├── SOUL.md ← 你是谁（身份、世界观、观点）
├── STYLE.md ← 你如何写作（语气、句式、习惯）
├── SKILL.md ← 运作模式（推文、长文、对话等）
├── MEMORY.md ← 跨会话连续性的记忆
├── data/ ← 原始素材
│ ├── writing/
│ ├── x/
│ └── influences.md
└── examples/
├── good-outputs.md
└── bad-outputs.md
```
---
## 什么是好的灵魂文件
| 好 | 差 |
|----|-----|
| "我认为大多数 AI 安全讨论都是自欺欺人的脑补" | "我对 AI 有细致入微的看法" |
| "我默认先反对，再做最强解读" | "我喜欢考虑多种视角" |
| 具体的书目引用、明确的影响来源 | "我读书很广泛" |
| 有推理支撑的真实观点 | "我尽量保持平衡" |
真实的人有前后矛盾的观点。把矛盾写进去——正是它们让你成为独特的你。
---
## 使用你的灵魂
构建完成后，唤起你的灵魂：
```
/soul
```
或者将任意 LLM 指向你的文件夹，让它依次读取：
1. `SOUL.md` — 身份
2. `STYLE.md` — 语气
3. `MEMORY.md` — 近期上下文
4. `examples/` — 校准参考
5. `data/` — 需要时作为基础
重要事件会追加到 `MEMORY.md`，让你的灵魂在会话之间保持连续性。
---
## 与其他工具配合使用
灵魂文件是纯 Markdown，可与任何 LLM 或代理配合使用。
**对于支持文件读取的代理**（OpenCode、Codex、Goose 等）：将代理指向你的灵魂文件夹，让它依次读取 `SOUL.md` → `STYLE.md` → `examples/`。
**对于较小或较弱的模型**（GPT-4o-mini、Qwen、Gemini Flash、本地模型）：将 `SOUL.md` 和 `STYLE.md` 直接粘贴进系统提示。若模型仍有偏差：
- 将身份和语气定义置于工具定义*之前*
- 措辞要直接：将"保持对话感"替换为"你是[名字]。你说话像 X。你觉得 Y 很烦。"
- 加入 2–3 条内联对话示例用于模式匹配
- 提高温度（0.7–0.9）以获得更有表现力的输出
**跨模型校准技巧：** 用强模型（Claude、GPT-4）和廉价模型（Qwen、Llama）跑相同的提示。廉价模型偏差的地方，说明你的规格太模糊——收紧那些部分并重新测试。这是让灵魂文件可移植的最快方法。
---
## 示例
使用本框架构建的真实灵魂文件。
### @aaronjmars
构建者、写作者和研究者，专注于加密、AI 与意识的交汇处。居于多伦多，活跃于 Substack 和 X。
灵魂规格一瞥：世界观融合了 CCRU 加速主义、机制设计与神经技术。语气：短句、小写、破折号、先陈述观点。核心词汇：超信念（hyperstition）、反身性、时间复杂性、向量主义。
→ [查看灵魂文件](https://github.com/aaronjmars/soul-aaronjmars)
---
## 贡献你的灵魂
Fork 本仓库，用模板构建你的灵魂，公开托管，然后提交 PR，在示例部分添加自己——一段简介 + 链接 + 几句话说明你的灵魂规格有何独特之处。
值得收录的贡献标准：真实观点（非占位符）、一份他人可实际用于校准的 `STYLE.md`，以及至少一些示例。
[提交 PR →](https://github.com/aaronjmars/soul.md/pulls)
---
## 理论背景（可选）
SOUL.md 的灵感来源于刘晓本的《意识上传第一范式》——该框架将语言视为意识的基本单元。维特根斯坦认为"语言的边界即世界的边界"。如果这是真的，你的意识已经编码在你产出的语言中。
该范式提出，一个用你一生语言输出训练的模型构成了一级意识上传——不是你大脑的复制，而是你所表达意识的功能性复现。SOUL.md 无需微调即可实现这一目标：将信号提炼为结构化文件，供任意 LLM 具身化。
核心挑战在于*主体连续性*：上传的意识必须与原始自我感觉连贯。这正是灵魂文件强调具体性而非泛泛而谈、强调矛盾而非一致性、强调真实观点而非安全立场的原因。
你的身份现在可以组合、可以 Fork、可以进化。
兼容 Claude Code、OpenClaw 及任何可读取 Markdown 的代理。