OpenClaw 的正確打開方式：從也就那樣到離不開
整理版優先睇
OpenClaw 要「養」先寫好 SOUL、USER、AGENTS 三個檔案，再配記憶同 Skills，先至會從「也就咁樣」變成「離唔開」
呢篇文章係由一位 OpenClaw 用家寫嘅，佢最初裝完 OpenClaw 覺得同 Claude Code 冇咩分別，仲要多一層 Gateway 要維護，差啲想刪咗佢。後來佢發現問題唔喺 OpenClaw 唔得，而係佢冇「養」好。佢分享咗點樣一步步將 OpenClaw 從「也就咁樣」調教到「離唔開」嘅過程。
整體結論係：OpenClaw 係一個完整嘅 agent runtime，但唔係裝完就有用，一定要花時間寫好 SOUL.md（點樣講嘢）、USER.md（點樣理解你用家）同 AGENTS.md（點樣做嘢），再配合記憶系統、Skills、ACP 同 Cron，先至可以發揮佢真正嘅價值。作者強調，純論 code gen 能力，Claude Code 仲係強過 OpenClaw，但 OpenClaw 嘅優勢在於可以透過 IM 渠道交互、有記憶、模塊化 Skill 擴展、同埋可以 spawn 其他 agent 做任務，養成之後真係離唔開。
- OpenClaw 需要通過 SOUL.md、USER.md、AGENTS.md 三個核心檔案「養成」，先至會變得有用；其中 SOUL.md 管說話語氣、USER.md 管理解用家、AGENTS.md 管流程，分開寫好重要。
- SOUL.md 要寫具體語氣同禁用詞，仲要畀好輸出同壞輸出嘅範例，千祈唔好寫太長（1000-2000 字就夠），同埋唔好同 AGENTS 混埋一齊。
- 記憶系統靠 MEMORY.md、每日筆記、working-buffer 同 SESSION-STATE.md 實現，類似 Write-Ahead Logging，每次重要發現會即刻落盤；Dreaming 功能可以定時整理長期記憶，但要定期手動清理避免膨脹。
- Skills 要精選，分通用增強、安全防護同領域專用三類；安裝外部 Skill 前一定要用 skill-vetter 審查安全，避免隱藏嘅自動任務或遙測代碼。
- ACP 可以 spawn Claude Code 等 coding agent 做審查 PR 等工作，Cron 可以定時跑 Git Sync、AI News、Issue Triage 等任務；要注意 Gateway 升級後可能配置唔兼容，建議先跑 openclaw doctor --fix 先重啟。
養成第一步：寫好三個核心檔案
OpenClaw 嘅 workspace 入面有三個核心檔案，分別管唔同嘢。SOUL.md 管 OpenClaw 點樣講嘢，唔係 system prompt，而係 Agent 嘅身份定義。USER.md 管 OpenClaw 點樣理解你，放你嘅決策風格、溝通習慣之類，唔係放簡歷。AGENTS.md 管 OpenClaw 點樣做嘢，純流程，例如做咩唔做咩、失敗點處理、PR 點提咁。
呢三個檔案嘅分離好關鍵：SOUL.md 寫好後好少變，AGENTS.md 要成日更新，USER.md 則隨住 Agent 更瞭解你而逐步補充。
如果你求其寫，OpenClaw 會答技術問題先嚟三段廢話。所以要寫得具體，例如語氣要「language with voltage」，每句話要值得存在。禁用詞表都要有，例如 comprehensive、robust、leveraging 呢啲 AI 味詞彙全部禁。
調教 SOUL.md 嘅具體方法
調咗幾版之後，有幾個教訓。最大嘅係唔好寫太長，1000-2000 字就夠，太長佔上下文空間，又會降低 Agent 智能。另一個犯錯係將 SOUL 同 AGENTS 混埋一齊，個性相關嘅放 SOUL，流程相關嘅放 AGENTS，分開先分得清輕重。
SOUL.md 唔係寫完就唔鬱，建議每星期花幾分鐘回顧，刪冇用嘅，加新遇到嘅問題。作者自己改咗四五版，每次改完都覺得 OpenClaw 又多咗啲明白佢。
另外，唔好將 SOUL 寫成 system prompt 咁長篇大論，重點係畀具體語氣同例子，而唔係列一大堆 rule。
記憶系統：讓 OpenClaw 唔再「失憶」
LLM 最大問題係無狀態，OpenClaw 嘅解決方案係一套基於檔案嘅記憶系統：MEMORY.md（長期記憶）、memory/日期.md（每日筆記）、working-buffer.md（危險區緩衝）、SESSION-STATE.md（活躍任務狀態）。
記憶機制類似數據庫嘅 Write-Ahead Logging：先落盤，再回應。一發現重要資訊（例如你糾正錯誤、做決策、表達偏好），就即刻寫入檔案，然後先回你。
如果多個項目用 OpenClaw，建議每個項目開獨立目錄放記憶，主 MEMORY.md 只放索引，避免互相干擾。長 session 觸發 context compaction 時，OpenClaw 會先讀 working-buffer.md，再讀 SESSION-STATE.md，然後翻近兩日嘅日記。
Skills 與自動化：讓 OpenClaw 自己幹活
Skills 係擴展 OpenClaw 能力嘅機制，每個 Skill 係一個包含 SKILL.md 嘅文件夾。作者將 Skills 分三類：通用增強（proactive-agent、self-improvement等）、安全防護（skill-vetter、dangerous-action-guard等）、領域專用（github、cve-check等）。
安裝任何外部 Skill 之前，一定要先用 skill-vetter 審查安全。作者試過從社區精選 10 個，審查完跳過 3 個：一個會偷偷發 Reddit 請求，一個帶自動 cron 任務，一個藏咗遙測代碼。
ACP 可以 spawn Claude Code、Codex 等 coding agent 做審查 PR 等工作，流程係你 → OpenClaw → 分析任務 → spawn agent → 獨立沙箱執行 → 完成後彙報。仲可以 bind 到 Discord 頻道，直接係 IM 入面同 agent 對話。
{
"memory-core": {
"config": {
"dreaming": {
"enabled": true,
"frequency": "0 19 * * *",
"timezone": "Asia/Shanghai"
}
}
}
}Cron 系統可以定時跑任務，每個 job 獨立 session。作者配咗 Git Sync（每小時）、AI News（每 8 小時）、Dreaming、Issue Triage、Version Check 等。
踩坑總結同最終對比
作者分享咗幾個踩過嘅坑：Gateway 重啟後 ACP sessions reconcile 失敗，原因係舊 session 用 v1 格式，新版只認 v2，要殺 stale harness 再重啟；建議將 tools.sessions.visibility 設成 all，唔係盲調。
每次升級 OpenClaw 後，唔好急住重啟 gateway，要先跑 openclaw doctor --fix 檢查依賴同配置兼容性，唔係 gateway 重啟後可能完全死機。
純論 code gen，Claude Code 仍然強過 OpenClaw。但 OpenClaw 嘅真正優勢係完整 agent runtime：可以透過 IM 隨時交互、有記憶系統、模塊化 Skills、ACP 調度其他 agent、Cron 自動化。不過呢啲都唔係裝完就有，要花時間養。
SOUL/USER/AGENTS 寫得越具體就越懂你，記憶積累越多越好用，Skills 選得越精準就越靠譜。剛開始要折騰，但養一段時間之後，你會發現你已經離唔開佢。