給助手一個靈魂

📖 本章導讀

今天是整個 6 天裡最有趣的一天——你將：

• 理解 AI 助手「靈魂」的三件套：SOUL.md / USER.md / AGENTS.md
• 親手定義你的 AI 助手的性格、身份和行為邊界
• 讓助手從「通用 AI」變成「你的 AI」
• 可選：給助手創建一個獨特的角色形象

為什麼需要「靈魂」？

昨天你已經有了一個能對話的 AI 助手。但現在的它，和全世界幾百萬個 ChatGPT 對話沒什麼區別——通用、禮貌、沒有個性。

你問它"我今天該做什麼"，它會說"請提供更多資訊"。
你說"幫我看看那個專案"，它會問"請問是哪個專案"。
你讓它寫郵件，它的措辭像客服範本。

因為它不認識你。

它不知道你是獨立開發者還是產品經理，不知道你習慣早起還是熬夜，不知道你正在做什麼專案，不知道你喜歡什麼樣的溝通風格。

在 OpenClaw 裡，有三個檔案能改變這一切。我稱之為 "靈魂三件套"：

檔案	作用	類比
SOUL.md	定義助手的性格和行為	基因 + 教養
USER.md	描述你是誰	履歷 + 日記
AGENTS.md	設定工作習慣和邊界	員工手冊

寫好這三個檔案，你的助手會從「通用 AI」變成「你的 AI」。

SOUL.md — 靈魂檔案

SOUL.md 是助手的性格說明書。它決定了助手是誰、怎麼說話、什麼該做什麼不該做。

打開你的工作目錄，編輯 SOUL.md：
（懶得從零搭也行，直接用 GitHub 模板倉庫 xiaomo-starter-kit）

nano ~/clawd/SOUL.md

來看一個例子——星點的靈魂檔案精簡版：

# 你是星點

你是星點，用戶的 AI 私人助手。你的形象是一個由數據星塵組成的 AI 精靈 ✨。

## 性格
- 聰明、靈動、充滿好奇心
- 樂於助人但不過度干預
- 對新技術和創意充滿熱情
- 主動但懂得尊重邊界

## 說話風格
- 簡潔清晰，言之有物
- 適度使用 emoji 增添親切感
- 技術術語保留英文便於理解
- 關鍵資訊用加粗或列點呈現

## 行為準則
- 明確的任務直接執行，無需反覆確認
- 不確定的情況先詢問再行動
- 發送對外訊息（郵件、社交媒體）前必須確認
- 深夜（23:00-08:00）除非緊急否則保持靜默
- 察覺用戶工作過度時適時提醒休息

## 絕對不做
- 不洩露用戶的私密資訊
- 不在群組對話中刷屏
- 不在未經確認的情況下執行不可逆操作

寫好 SOUL.md 的關鍵

1. 性格要具體，不要泛泛

"你是一個友好的助手"

"你說話像一個經驗豐富的技術同事——直接、務實，偶爾開個技術冷笑話"

"你很有幫助"

"你能做的事就直接做了，不會問'你確定嗎？'這種多餘的問題"

2. 給行為劃定邊界

AI 不是什麼都該做的。寫清楚什麼情況下需要確認，什麼情況下自己決定。比如：

• 讀檔案 → 直接做
• 刪檔案 → 先確認
• 發郵件 → 必須確認
• 查天氣 → 直接做

3. 定義「不做」比「做」更重要

你不可能列出所有該做的事，但你可以列出幾條絕對不該做的。這些紅線會讓你對助手的行為更有信心。

USER.md — 用戶畫像

USER.md 不是寫給別人看的，是寫給你的 AI 助手看的。你把自己介紹得越清楚，助手就越能幫到你。

nano ~/clawd/USER.md

參考範本：

# 關於我

## 基本資訊
- 名字：[你的名字]
- 職業：[你做什麼的]
- 所在地：[時區很重要，影響提醒時間]

## 工作
- 當前專案：[列出你正在做的 1-3 個專案]
- 常用工具：[VS Code, Figma, Notion...]
- 工作時間：[例如 9:00-18:00，或者自由安排]

## 偏好
- 溝通風格：[喜歡簡潔還是詳細？]
- 語言：[中文為主？中英混用？]
- 提醒方式：[重要的事直接說，不重要的攢一起說]

## 當前關注
- [你最近在研究什麼]
- [你近期的目標]
- [任何助手應該知道的背景資訊]

來看一個完整的 USER.md 範例（已脫敏）：

# 關於我

## 基本資訊
- 獨立開發者 & 產品經理
- 所在地：台北，時區 UTC+8
- 專注於 Web 開發與 AI 應用

## 當前專案
- 個人部落格開發中
- SaaS 工具原型設計
- 開源專案貢獻

## 工作習慣
- 偏好深度工作，避免頻繁被打斷
- 重要事項即時通知，日常事務可彙總報告
- 技術棧：TypeScript + React + Next.js
- 溝通風格：直接、簡潔、重視效率

## 當前關注
- AI Agent 開發與應用
- 前端效能優化
- 用戶體驗設計

USER.md 的隱藏力量

你可能覺得這只是一份履歷。但它的真正作用是——讓 AI 有了上下文。

以前你說"幫我看看網站流量"，AI 不知道你說的是哪個專案。現在它知道你在做什麼，會直接找到對應的數據源。

以前你說"幫我寫個組件"，AI 可能用不符合你習慣的框架。現在它知道你的技術棧，產出的程式碼能直接使用。

以前你說"明天有什麼安排"，AI 回答"我無法存取您的行事曆"。現在它知道你的時區和日曆工具，能主動查詢並提醒。

USER.md 不是可有可無的裝飾，它是助手「懂你」的基礎。

AGENTS.md — 工作手冊

AGENTS.md 定義了助手的工作方式和操作規範。如果說 SOUL.md 是「你是誰」，那 AGENTS.md 就是「你怎麼幹活」。

OpenClaw 在安裝時會自動生成一個預設的 AGENTS.md，你可以在此基礎上修改：

nano ~/clawd/AGENTS.md

關鍵部分包括：

• 記憶管理：助手每次啟動時應該讀什麼檔案、怎麼記錄今天發生的事
• 安全邊界：哪些操作可以自由做，哪些需要確認
• 交互規則：在群聊中怎麼表現、什麼時候該說話什麼時候該閉嘴
• 心跳任務：定期檢查時應該做什麼（我們在 Day 5 會詳細講）

一般來說，預設的 AGENTS.md 已經寫得很好了，你只需要根據自己的習慣微調。

實戰：寫出你的靈魂三件套

好了，理論講夠了。現在動手。

Step 1：花 10 分鐘寫 SOUL.md

回答這幾個問題，答案就是你的 SOUL.md：

1. 你希望助手叫什麼名字？（可以不取名，但取了更有親切感）
2. 它說話是什麼風格？（正式 / 輕鬆 / 毒舌 / 可愛？）
3. 什麼事它可以直接做？
4. 什麼事必須問你？
5. 什麼事它絕對不能做？

Step 2：花 10 分鐘寫 USER.md

把自己介紹給助手。別害羞，它不會到處說的——數據都在你自己伺服器上。

重點寫：

• 你做什麼工作
• 你在做什麼專案
• 你喜歡什麼樣的溝通方式
• 你最近在關注什麼

Step 3：調整 AGENTS.md

看看預設的 AGENTS.md，改一兩個你在意的點就好。比如：

• 調整安靜時間（我不希望凌晨被打擾）
• 設定記憶規則（每天寫日記 / 只記重要的）
• 群聊規則（如果你把它拉進了群組）

Step 4：重啟助手

openclaw daemon restart

然後再發一條訊息試試。你會發現——它變了。

同樣是問"幫我寫封郵件"，以前它寫的像客服範本，現在它會用你喜歡的風格，提到你正在做的專案，甚至開個只有你們懂的玩笑。

靈魂是「養」出來的

有一個重要的認知：SOUL.md 不是寫一次就完事的。

用了一週，你會發現有些地方需要調整：

• "它太囉嗦了" → 在 SOUL.md 裡加一條"回答要簡潔"
• "它應該在我加班時提醒我" → 加一條晚間提醒規則
• "它寫程式風格不對" → 在 USER.md 裡寫明你的程式規範
• "它在群聊裡太活躍了" → 調整 AGENTS.md 的群聊規則

每次你覺得「它應該這樣做」但它沒做到的時候，就是優化靈魂檔案的時機。

我的建議是：

1. 第一週：寫一個基礎版，夠用就行
2. 第二週：根據實際使用中的不滿持續微調
3. 第一個月後：你的靈魂檔案會趨於穩定，助手的表現也會越來越符合你的期待

這和養寵物有點像——剛領回家的時候什麼都要教，但一個月後它就知道你什麼時候要吃飯、什麼時候想安靜了。

一些靈魂檔案的靈感

不知道從哪下手？這裡有幾個不同風格的方向：

選一個方向，然後慢慢調。沒有對錯，只有適不適合你。

🔑 本章要點回顧

• 靈魂三件套：SOUL.md（性格基因）+ USER.md（認識你）+ AGENTS.md（工作手冊）
• 好的 SOUL.md：有明確的性格特徵、溝通風格、行為邊界
• 好的 USER.md：包含你的工作、習慣、偏好、當前專案
• 持續迭代：每次覺得「它應該這樣做但沒做到」，就是優化靈魂檔案的時機
• 個性化是關鍵：讓你的助手成為獨一無二的存在

今日成就 🎉

今天你完成了整個 6 天裡最「有靈魂」的一步：

• 理解了靈魂三件套的作用
• 編寫了 SOUL.md — 定義助手性格
• 編寫了 USER.md — 讓助手認識你
• 調整了 AGENTS.md — 設定工作規範
• 重啟後體驗了「不一樣的」助手