【技術向】Openclaw Agent 配置文件拆解

這幾天 Openclaw 真的是太火炎焱了，

甚至很多官媒也下場報道了。。。（本來有一張央視的圖，放了不給過審⬇）

前幾天騰訊深圳總部的底下，騰訊雲官方做活動，

可以免費幫忙部署 Openclaw ，甚至有的沒帶電腦就來了。。。

到目前爲止，

Openclaw 的部署教程全網已經鋪天蓋地了，付費部署也很多。

所以本文不講這些，因爲拉不開差距。

本文是一篇技術向文章，來帶大家理解一下Openclaw中，

最重要的8個Agent配置文件作用原理，架構，以及優先級。

瞭解原理以後，你能更好地調教你的小龍蝦🦞。

如果你的龍蝦經常失憶，也請看這篇文章，下文會給出解決方法。

首先咱先進入Openclaw 的網關Dashboard。

這個是正常安裝以後都可以進入的，輸入指令：

openclaw gateway start

喜歡敲命令的人可以用命令行控制一切：

openclaw gateway 啓動網關
openclaw agent 直接調用 Agent
openclaw channels login 配對 WhatsApp/Signal
openclaw message send 編程發消息
openclaw doctor 跑健康檢查
openclaw onboard 引導式初始設置

Gateway 網關啓動後，打開瀏覽器控制界面。

本地默認地址：http://127.0.0.1:18789/

然後點擊左側的【代理】

可以看到一個 Agent 裏面有 8 個 Markdown 核心配置文件，

如果你是零代碼基礎的小白，

那麼你能看懂的，可能有且只有這 8 個文件以及 Skill 還有需要手動配置的 env.文件了。

在你瞭解以後，你就可以用口述的方式讓它進行修改了。（當然，爲了最好的效果，肯定是需要多輪迭代的。）

我按照重要程度來講，先來說說這幾個文件的中文意思：

MEMORY——記憶

AGENTS——代理

IDENTITY——人格

SOUL——靈魂

TOOLS——工具

USER——用戶

HEARTBEAT——心跳

BOOTSTRAP——腳本

個人認爲，最重要的文件就是 AGENTS，SOUL，IDENTITY 這三個文件了。

好！問題來了！！

如果某天你在 Openclaw 上和你的 Agent 聊了一天，

過了一天你重啓了網關，請問該 Agent 的記憶儲存在哪！！

聰明的你可能會覺得，儲存在MEMORY.md文件中。

但並不是這樣。

MEMORY.md 是跨會話（Cross-session）積累知識的目錄索引。

只是初始上下文，而不是真正的“記憶”或強制約束。

1.它的本質只是一段會被遺忘的初始上下文

官方（無論是 Claude Code 還是類似的 Agent 框架）將其設計爲跨會話積累知識的地方，每次對話開始時會自動加載到 System Prompt 中。

隨着對話越來越長、任務越來越複雜，AI 對這份文件的注意力權重會不斷下降。

當它在執行一個多步驟工作流的某個具體環節時，注意力集中在當前任務結構上，不會主動回頭去翻一個離當前執行點很遠的參考文檔。

如果想恢復上下文記憶，

應該去找 Session 文件，個人理解有點像記憶碎片。

Sessions.json是主會話的配置文件。它的唯一作用是指針，永遠指向當前正在使用的 jsonl 文件。

jsonl文件是存儲完整聊天記錄的實體數據文件。

系統每次對話都會讀取它作爲上下文。爲了避免文件過大，系統會週期性地壓縮並總結舊的 jsonl 文件，然後新建一個 jsonl 文件繼續記錄。

MEMORY.md這是存儲極少數高價值信息的概要文件。

系統極少自動向內寫入內容，只有在你明確下達指令，或者系統判斷某條信息具有特殊保留價值時纔會更新。你也可以隨時手動對其進行編輯。

所以恢復記憶的方式：

打開你的用戶文件夾。
進入 .openclaw/agents/main/sessions/ 目錄。
找到 sessions.json 文件。
將裏面 sessionFile 字段的值，修改爲該目錄下某個特定的 jsonl 文件名。完成這一步即可恢復對應的歷史記錄。

2.SOUL.md和IDENTITY.md的區別

先來看看具體案例，這是@長歌大佬寫的喬布斯 Agent，

SOUL.md和 IDENTITY.md都是中文，你應該可以讀懂其中的內容，但是可能還是沒太搞清楚的他們的區別。

SOUL.md

權威定義：根據官方架構解析，這是 Agent 的性格基座
作用：定義 AI 說話的語氣、態度和口吻。比如你可以把它配置成“極其簡練的極客”、“溫柔的助理”或“暴躁老哥”。它決定了 AI 回覆你的“文風”。

IDENTITY.md

權威定義：企業級應用中極度看重的文件，用於“結構化描述智能體是誰、能做什麼、邊界何在”。
作用：這是 AI 的“崗位職責說明書”。裏面規定了它的權限上限（例如：你只能讀取 /Documents 目錄，絕對不能執行 rm -rf 甚至刪除操作）。

再轉述大佬的比喻，來方便你理解：

有一個外交官員，每天在五角大樓爲特朗普公開發言。
但內裏其實他是個同性戀，還是個抑鬱症患者。
五角大樓發言人是他的 IDENTITY，LGPTQ玉玉症人羣就是他的SOUL。
SOUL決定他實際上靈魂上是什麼，IDENTITY決定他怎麼裝人，相當於是“你在外面裝逼的時候別忘了撒泡尿照照自己是誰”

當我聽完解釋以後，真的醍醐灌頂，葫蘆灌頂，雞蛋灌餅。

我自己還沒搞清楚自己的 Soul 和 Identity，Openclaw 創始人 Peter 居然已經把這玩意用在 AI 上了？？

3.AGENTS.md

這個單獨來講

AGENTS.md是權重最高的文件，定義了 AI 處理任務的底層邏輯和絕對不能違反的規則。可以把它理解爲 AI 的《員工手冊》。

咱繼續拿喬布斯爲例，看看它的AGENTS.md文件：

通過截圖的內容，咱可以知道：AGENTS.md決定你的智能體如何思考、如何決策、如何與其他文件互動，以及如何採取行動。

大模型本身是無狀態的一問一答，但 AGENTS.md 賦予了它一套嚴格的執行順序，把它變成了一個自動運行的程序。
AI 該先看什麼、後看什麼，比如在 Every Session 板塊中，
明確規定了 AI 每次醒來必須先讀 SOUL.md（確認底層設定），
再讀 MEMORY.mdbalabala....

還有在 Heartbeats 板塊，它指導 AI 在後臺定時喚醒時該執行什麼代碼，以及在沒有新消息時必須保持沉默（HEARTBEAT_OK）。

我們在前面討論過 MEMORY.md 很容易被 AI 遺忘或亂寫。

AGENTS.md 就是用來解決這個問題的它教 AI 如何正確地讀寫記憶，在 Memory 板塊，它明確規定了記憶分三層（會話、持久化、歸檔），並且給了嚴格的 Markdown 寫入格式（必須包含“我的立場”、“核心分歧”、“攻擊記錄”等）。

寫入紅線：在 Safety 板塊中，嚴格約束了 MEMORY.md “只追加，不回溯修改”，防止 AI 弄亂自己的記憶庫。

4.HEARTBEAT心跳機制

HEARTBEAT.md（心跳與主動任務）：OpenClaw 支持後臺定時喚醒（比如每 30 分鐘一次）。
AI 喚醒後會靜默讀取這個文件，看看有沒有需要主動去做的週期性任務。

"心跳本質上只是一個定時任務cron機制，cron是一種工程上面的定時器機制，作用就是按照固定時間出發一次行爲。至於這個行爲是什麼，可以自己定義。只是這個機制對於agent來說是不可抗命令。
Openclaw 創始人Peter只是把一種不可取消的cron定義爲了“心跳”，這個心跳如果沒做任何動作，就會打一個叫做 HEARTBEAT_OK的消息，這個消息在openclaw內部，一般是不會發送到客戶有感知的客戶端的，比如不會發到********上，但你在它的TUI上能看到這個消息，也就是上文中gateway自帶的那個網頁後臺。
跟定時任務的區別就是，用戶自己定義的cron，比如你跟agent說，每半小時幫我去 X（推特）上看看馬斯克有沒有發新帖子，這個cron任務，agent自己有權利創建和取消，它能干預。
Peter自己也說了，這個功能一開始，是他希望Openclaw隔一段時間能自己做點什麼，給他一點s、Surprise，但是LLM本身自己是不會主動做事的，所以他設計了一個叫“心跳”的機制，逼迫agent隔一段時間能夠“主動”做點什麼。
這個“主動”從人類的睡覺來看像是主動，但它依然是一種系統機制，並不是說LLM真的就會自主做什麼。"

最後是三個我感覺相對不怎麼重要的文件，統一解釋吧：

USER.md（用戶畫像）
作用：因爲 OpenClaw 是跨平臺的（能同時接管你的 WhatsApp、微信、飛書、Discord），這個文件用來統一記錄你是誰。包含你的工作偏好、時區、乃至你家人朋友的名字，讓 AI 無論在哪個軟件裏理你，都像同一個老熟人。
BOOTSTRAP.md（初始化腳本）：通常只在 OpenClaw 第一次部署或創建新 Agent 時存在。它包含一次性的引導任務。初始化完成後，這個文件通常會被刪除或廢棄。
TOOLS.md
作用：AI 使用本地電腦工具的說明書。OpenClaw 擁有極高的本地權限（比如能操作終端、瀏覽器、讀寫文件），這裏記錄了特定 API 或本地腳本的調用規範，防止 AI 亂敲代碼。