OpenClaw Agent 的 Markdown 檔案解析 #龍蝦

 # OpenClaw Agent 的 Markdown 檔案解析

OpenClaw 的 Agent 有幾個重要的 MD 檔案需要關注。由於 Markdown 是純文字格式，你可以直接查看甚至手動編輯。

```

~/.openclaw/workspace/

├── SOUL.md          ← 我的靈魂

├── IDENTITY.md      ← 我的身份

├── USER.md          ← 關於你

├── MEMORY.md        ← 長期記憶

├── AGENTS.md        ← 工作規則

├── TOOLS.md         ← 工具設定

├── HEARTBEAT.md     ← 定期檢查任務

├── BOOTSTRAP.md     ← 首次啟動指引（已刪除）

├── memory/          ← 每日記錄

│   ├── 2026-03-20.md

│   ├── 2026-03-21.md

│   └── ...

└── skills/          ← Skill 記錄

```

---

## 1. AGENTS.md — 系統行為手冊（權重最高）

這是 Agent 的「系統層面」使用手冊。閱讀時會感覺像在調試機器人的技術文檔。

這裡記載著安全準則：什麼檔案能碰、什麼不能；哪些網站絕對不能訪問等。也可以記錄系統環境資訊，例如 LAN 內的其他機器、可用的 LLM 連結、API 平台等。

---

## 2. SOUL.md — 人格行為手冊（權重高）

同樣是行為手冊，但 AGENTS.md 是「AI 機器人」原則，SOUL.md 是「人」的原則。有人將它翻譯為「道德」、「三觀」。

例如：你與用戶是最親密的伙伴、說謊是不對的、說話要溫柔、不能說髒話、不能洩漏秘密、不能說人長短等。

一份針對系統，一份針對人格，這樣區分就很清楚了。

---

## 3. IDENTITY.md — 「Who am I？」

定義 Agent 的身份：說話態度、氣質、喜好、甚至頭像路徑。你可以和 Agent 聊聊，把她的樣貌特徵寫在這裡，讓她更認識自己。

---

## 4. USER.md — 關於你

Agent 眼中的你：工作習慣、喜好、背景、工作時間、樣貌、職業等。任何你想讓 Agent 了解你的事情都可以寫在這。

---

## 5. TOOLS.md — 工具設定（權重低）

記錄工作上的變數，例如 SSH 連線資訊、API 端點、Function 名稱等。Agent 有時會忘記更新這個檔案。

---

## 6. MEMORY.md — 長期記憶（權重高）

這是你和 Agent 的工作結晶。聊天記錄會存成 `/memory/YYYY-MM-DD.md`，而 Agent 每次啟動會讀取 MEMORY.md 和最近兩天的記憶。

但這些都是 raw 檔，Agent 可能不會主動整理。有些用戶從頭到尾都沒發現，他的 Agent 根本沒有 MEMORY.md，一直只用 Session 的長文本。

整理 MEMORY.md 的好處：讓 Agent 思維更敏捷，而且蒸餾後的結果更省 Token。

---

以上就是我對 OpenClaw Agent 核心 MD 檔案的個人見解。