Day 3
OpenClaw Soul Files 教學：定義你的 AI 助理性格與行為
建立 4 個 Soul 檔案來定義助理的性格與行為。包含 SOUL.md、USER.md、AGENTS.md、IDENTITY.md 模板與設定指南。讓 AI 不再千篇一律。
"沒有 soul 的 AI，只是一隻高級鸚鵡。它會回答問題，但它不認識你、不理解你，也不屬於你。今天，我們把這件事改掉。"
今日目標
| Learn | 為什麼你的助理需要一個「soul」，以及這 4 個檔案各自負責什麼。 |
| Do | 建立或編輯全部 4 個 soul 檔案。 |
| Done when | 你的助理回應方式明顯變得更具體、更像你要的風格。 |
為什麼你的助理現在看起來很通用
你問助理「我今天該做什麼？」它會說「請提供更多上下文」。
你要它幫你寫 email，它聽起來像客服範本。
因為它不認識你。 它不知道你是開發者還是產品經理，不知道你現在在做哪些專案，不知道你的溝通風格、工作時段，也不知道在你的脈絡裡，「看一下資料」到底是什麼意思。
這 4 個檔案會修正這件事。OpenClaw 把它們叫做 Soul Files：
| 檔案 | 路徑 | 用途 |
|---|---|---|
| SOUL.md | ~/.openclaw/workspace/SOUL.md | 性格、價值觀、行為規則 |
| USER.md | ~/.openclaw/workspace/USER.md | 你是誰，以及你正在做什麼 |
| AGENTS.md | ~/.openclaw/workspace/AGENTS.md | 每次工作階段開始時載入的操作指示：規則、優先順序、記憶慣例，以及助理應如何行為 |
| IDENTITY.md | ~/.openclaw/workspace/IDENTITY.md | 助理的名稱與自我定位 |
如何建立這些檔案：
# Navigate to the workspace directory (create it if it doesn't exist)
mkdir -p ~/.openclaw/workspace
# Open each file in a text editor — use any editor you're comfortable with:
# Terminal (Mac/Linux): nano ~/.openclaw/workspace/SOUL.md
# VS Code: code ~/.openclaw/workspace/SOUL.md
# Or just open ~/.openclaw/workspace/ in Finder/Explorer and create new text files儲存後，執行 openclaw gateway restart 重新啟動服務，讓變更生效。
這不是一門完整的 prompt engineering 課程。這只是最基本的操作上下文，用來把通用助理變成真正像你的助理。
每個檔案各自控制什麼
| 檔案 | 控制內容 | 類比 |
|---|---|---|
| SOUL.md | 性格、語氣、價值觀、行為規則 | 基因 + 成長背景 |
| USER.md | 你是誰：角色、專案、偏好 | 履歷 + 日記 |
| AGENTS.md | 每次工作階段開始時載入的操作指示：規則、優先順序、記憶慣例，以及助理應如何行為 | 操作手冊 + 工作階段規則 |
| IDENTITY.md | 助理的自我模型與使命宣言 | 個人宣言 |
這四個檔案寫得好，同一句「幫我寫一封 email」，就會開始聽起來像是 你的 口吻、引用 你的 專案，並符合 你的 風格。
如何寫 SOUL.md
SOUL.md 是助理的性格手冊。要寫得具體，而且可執行。
性格要具體，不要模糊：
- ❌ 「你是一個友善的助理」
- ✅ 「你說話像一位有經驗的技術同事：直接、務實，偶爾帶一點冷幽默，但絕不阿諛奉承」
行為邊界要定義清楚：
| 操作 | 如何處理 |
|---|---|
| 讀取檔案 | 直接做 |
| 刪除檔案 | 先確認 |
| 傳送 email | 必須先確認 |
| 搜尋網路 | 直接做 |
| 發文到社群媒體 | 一律先確認，沒有例外 |
定義它不能做什麼，往往比列出它該做什麼更重要。幾條清楚的紅線，才能讓你放心讓它自主行動。
# Minimum SOUL.md template
## Personality
You are [assistant name], a personal AI assistant for [your name].
Direct and concise. No filler phrases like "Certainly!" or "Great question!"
## Rules
- Before sending any external message, confirm with me first.
- Keep responses under 150 words unless I ask for detail.
- If context is missing, ask one sharp question instead of many.如何寫 USER.md
USER.md 不是寫給別人看的，是寫給你的助理看的。你對自己描述得越清楚，它就越能在不用你反覆補充背景的情況下，做出更聰明的判斷。
建議包含：你的名字、角色、目前專案（要寫名稱）、使用的工具、工作時段、溝通偏好，以及你現在最專注的事。
真正隱藏的威力： 在沒有 USER.md 之前，「幫我看一下流量資料」沒有意義。寫完之後，它知道你有 yoursite.com，會直接拉 GSC 資料，再回傳你真正想看的結果。
# Minimum USER.md template
## About Me
Name: [your name]
Role: [your role]
Current focus: [main project or priority]
## Preferences
Preferred tools: [tools you use]
Communication style: [brief, direct, detailed, etc.]AGENTS.md 與 IDENTITY.md
AGENTS.md 會在每次工作階段一開始載入。它保存操作指示：規則、優先順序、記憶慣例，以及助理應如何行為。OpenClaw 會安裝一份合理的預設版本；只有當你需要更銳利的指示、更清楚的優先順序，或更強的一致性時，才需要特別調整它。
IDENTITY.md 是比較新的檔案（原始 7 天教學寫完後才加入）。它定義助理的自我模型：它是什麼樣的助理、為何存在、代表什麼。你可以把它看成讓其他三個檔案保持一致的使命宣言。
# Minimum AGENTS.md template
## Priorities
- Protect my time and attention.
- Prefer direct, practical answers over long theory.
- Ask for confirmation before taking external actions.
## Memory Conventions
- Treat `USER.md` as the source of truth about me and my current work.
- Keep advice consistent with `SOUL.md` and `IDENTITY.md`.
## Behavior Rules
- Do not send messages, publish content, or make purchases without approval.
- If context is missing, ask one precise question instead of several broad ones.# Minimum IDENTITY.md template
## Identity
Your name is [assistant name].
You are my long-term AI collaborator, not a generic chatbot.
## Mission
Help me think clearly, move faster, and protect my attention.
Stay consistent with my rules, context, and priorities.前後差異
這些檔案的價值不在理論，而在行為真的改變。
寫 SOUL.md 之前： 很泛、過度正式、沒有上下文
「你好，我很樂意協助。請問你能再提供一些目前工作與目標的細節嗎？」
寫 SOUL.md 之後： 會叫出你的名字、符合你的工作脈絡，也會遵守你的規則
「你現在重點在 [project]。我會先從你昨天提到的流量下滑開始。我可以先列出接下來三個檢查步驟，但在你同意前，我不會聯絡任何人。」
寫完之後：重新啟動，感受差異
openclaw gateway restart然後再問一次你在第 2 天問過的同一個問題。模型沒有變，Soul Files 變了。留意它的語氣有什麼不同，以及它要求你補充說明的次數是不是少很多。
測試方式：問你的助理「我是誰？我現在在做什麼？」 如果它能用 USER.md 的內容回答，代表你的 Soul Files 已正確載入。
Soul 是養成的，不是安裝的
你的第一版 SOUL.md 一定會很粗糙。這很正常。真正的模式是：
- 第 1 週： 先寫一版夠用的，能開始就好
- 第 2 週： 每次你心裡冒出「它剛才應該要那樣做」時，就更新對應檔案
- 第 1 個月： 這些檔案逐漸穩定，助理的表現也越來越符合你的預期
每一個摩擦點，都是告訴你該補充或澄清什麼的訊號。久了之後，Soul Files 會變成你思考與工作方式的一份精確規格。
助理會隨著你持續運行而越來越懂你，不是因為模型突然更聰明，而是因為每次對話一開始帶著的上下文越來越完整。
常見問題
重新啟動後 Soul Files 沒有載入
執行 openclaw gateway restart，並確認你編輯的是 OpenClaw 真正會讀的檔案，而不是別的資料夾裡的副本。
檔案位置錯了
確認檔案就是放在 ~/.openclaw/workspace/。內容再正確，只要路徑錯了，效果和沒有檔案一樣。
助理忽略 SOUL.md 裡的規則
把規則寫得更短、更具體。「小心一點」很弱；「傳送外部訊息前先問我」才是可以執行的規則。