程式碼與筆記本:配置、記憶與身份檔案的組織

2026 OpenClaw「靈魂與記憶」檔案實戰:SOUL / MEMORY / IDENTITY 配置順序、持久上下文與在遠端 Mac(VNC)下的視覺化編輯清單

約 15 分鐘閱讀 OpenClaw VNC 遠端 Mac

你已經能跑通 OpenClaw,但回答風格漂移、跨會話「失憶」、多專案串臺——往往不是因為模型,而是人格與記憶檔案沒有和目錄結構、憑據面對齊。本文面向 2026 年在 遠端 Mac(VNC) 上維護 OpenClaw 的中高階使用者:說明 SOUL / MEMORY / IDENTITY 的職責邊界、推薦載入與編輯順序、與站內已有 SecretRef、多專案隔離、常見報錯文章的銜接,並給出可在 VNC 會話裡逐項勾選的視覺化編輯清單。純 CLI 也能改檔案,但 macOS 許可權彈窗、瀏覽器控制檯與多視窗對照時,圖形桌面更不容易漏步驟。💡

① 三類檔案各自解決什麼問題

在 2026 年的 OpenClaw 工作流裡,模型能力升級很快,但「誰在說話、記得什麼、不能做什麼」若只靠系統提示裡臨時塞幾句,會在多會話、多外掛、多閘道器場景下迅速失控。把策略拆成 SOUL / MEMORY / IDENTITY 三類檔案,本質是把可版本化、可審查、可回滾的配置從「一次對話」裡抽離出來,接近運維裡的「策略即程式碼」思路。下面先分清職責,再談順序。

SOUL:價值觀、語氣、拒絕回答的邊界(例如不向使用者索要明文密碼、不執行破壞性 shell)。適合寫「永遠為真」的原則,而不是每日變更的任務狀態。

MEMORY:長期偏好與專案事實(常用倉庫路徑、釋出節奏、術語表)。應隨專案演進更新,但避免把金鑰、令牌寫進來;金鑰走 SecretRef 與 openclaw secrets

IDENTITY:對外名稱、渠道人格(例如 Telegram 與 Web 控制檯是否同一「人設」)、可選的展示用後設資料。保持簡短,避免與 SOUL 重複整段說教。

三者與執行時載入順序的關係可概括為:IDENTITY(我是誰)→ SOUL(我怎麼拒絕/怎麼說)→ MEMORY(我記得哪些事實);具體欄位名以你使用的 OpenClaw 版本文件為準,升級後請用 openclaw doctor 自檢(參見站內 v2026.4.5 升級文)。

實踐中常見錯誤包括:把整頁產品說明粘進 MEMORY(應放到站點或內部 Wiki,MEMORY 只保留摘要與連結);在 SOUL 裡寫具體客戶名與合同金額(應進工單系統或加密備註,MEMORY 只保留「客戶代號 + 溝通偏好」);以及多例項共用一份 MEMORY 導致專案 A 的路徑被專案 B 誤用——這與站內《多專案隔離》強調的工作目錄分桶是同一類問題。

② 決策矩陣:與 Skill、SecretRef、多專案目錄的關係

話題用三類檔案不要用三類檔案代替銜接站內文章
金鑰 / Token僅在 MEMORY 寫「存在某 SecretRef」的引用名明文 API Key《SecretRef 與審計》
可插拔能力SOUL 宣告「何時允許呼叫工具」把 Skill 教程全文塞進 MEMORY《Skill 技能市場實戰》
多客戶 / 多倉庫每例項一套檔案 + 獨立工作目錄混用同一 MEMORY《多專案隔離》
故障現象MEMORY 記「上次已驗證的 doctor 輸出摘要」把整頁日誌貼進 SOUL《常見報錯 10 解》

排障經驗法則:該不該做 → SOUL;事實是什麼 → MEMORY;對外叫什麼 → IDENTITY。勿把三類混寫,否則 diff 與回滾都痛。

② 續:典型症狀與應先改哪一類檔案

面向「能跑但怪異」階段,與《常見報錯 10 解》互補(彼處偏安裝/程序,此處偏策略與記憶)。建議在 VNC 裡邊看對話邊對照下表。

你觀察到的現象優先檢查常見根因建議動作
同提示詞兩次人設/敬語不一致IDENTITY 與 SOUL 語氣是否重複衝突形容詞或長短懸殊語氣歸 SOUL;IDENTITY 留名與渠道
堅持舊路徑/舊負責人MEMORY 與副本拷例項帶舊 MEMORY全文搜路徑;只留一份 canonical MEMORY
工具呼叫超出預期SOUL 工具邊界升級後 Skill 預設變寬doctor 看 enabled;SOUL 寫明需確認的操作
對話裡出現疑似金鑰片段MEMORY 是否誤寫明文從環境變數或 .env 整段貼上立即輪換金鑰;改 SecretRef;MEMORY 只保留引用名

② 再續:大版本升級後的最小合併與回滾

OpenClaw 在 2026 年仍會以較高頻率迭代:canonical 路徑、enabled 標誌、外掛預設策略都可能變化。升級後若只動二進位制不改三檔案,易出現「模型仍按舊邊界說話,但執行時已允許新工具」的策略漂移。建議每次大版本:備份三檔案 → 讀發行說明裡與工具/許可權/Gateway 相關的 breaking 行 → 執行 openclaw doctor,把與三檔案相關的告警原文貼工單(勿整頁日誌進 SOUL)→ 在 SOUL 增補新禁止/確認項,在 MEMORY 更新埠、控制檯 URL、約定路徑 → 在 VNC 下回歸:發訊息、觸發 Skill、看控制檯網路錯誤。

回滾時:對話越權優先恢復上一版 SOUL;事實錯誤導致誤操作優先恢復 MEMORY。回滾後再跑 doctor。使用 secrets plan/apply 時,工單裡分列記錄「策略檔案版本」與「secrets 版本」,避免只回滾其一。租用節點者務必將三檔案納入 Git/加密倉或物件儲存,勿僅存桌面單一副本(可對照站內《雲端 Mac 續費與資料》匯出思路)。

③ 落地步驟:從空目錄到可審計的最小閉環

1

確認 OpenClaw 版本與配置根目錄

在終端執行 openclaw --versionopenclaw doctor,記錄 canonical 路徑(見 v2026.4.5 升級文)。

2

建立或更新 IDENTITY:一句話名稱 + 渠道差異

避免與品牌名衝突;若多語言,註明預設回覆語言。

3

編寫 SOUL:邊界優先於「人設修辭」

列出禁止行為(例如擅自對外發郵件)、與合規相關的提醒。

4

編寫 MEMORY:事實與偏好,不含金鑰

倉庫根路徑、發版日、術語對照;金鑰僅寫 SecretRef 名。

5

在 VNC 下用 GUI 編輯器儲存為 UTF-8

避免 Windows 側編輯引入 BOM 或 CRLF 導致解析異常。

6

重啟或熱載入後走一輪對話迴歸

同一提示詞連問兩次,觀察語氣與事實是否一致。

7

把變更記入團隊工單或內部 README

便於審計與回滾;與 SecretRef 的 plan/apply 記錄對齊。

④ VNC 會話中的視覺化核對表

遠端 Mac 的 VNC 桌面裡,推薦並排開啟:① 配置檔案目錄(Finder 或 VS Code)、② 瀏覽器中的 Gateway/控制檯(若啟用)、③ 官方或站內參考文件。這樣當 macOS 彈出「是否允許自動化/錄屏/通訊錄」等許可權框時,你能立即看到是哪一個步驟觸發,並把結論寫回 SOUL(例如「未經使用者顯式同意不開啟桌面錄製」)。純 SSH 會話往往要來回切換視窗,容易漏點「允許」,留下半配置狀態;而 VNC 與本地使用 Mac 的認知模型一致,更適合作為團隊標準操作環境

  • □ 三檔案路徑與例項根目錄一致,無「複製錯目錄」的第二份副本
  • □ MEMORY 中無明文金鑰;openclaw secrets audit(若可用)無異常
  • □ SOUL 中的禁止項與團隊安全策略一致
  • □ 瀏覽器控制檯(若使用 Web Gateway)無配置載入報錯
  • □ 多專案場景:當前會話使用的工作目錄與 MEMORY 描述匹配

⑤ 可引用原則與 FAQ

原則 1:檔案越小越易審計;把長篇教程留在部落格與官方文件,MEMORY 只放「指向何處的指標」。
原則 2:升級 OpenClaw 後優先跑 doctor,再改 SOUL 裡的工具邊界描述。
原則 3:在 VNC 裡並排開啟「配置檔案 + 控制檯 + 文件」三視窗,比純 SSH 更不容易漏看許可權彈窗。
原則 4:每次大版本升級後,先備份三檔案再合併發行說明中的 breaking 項;不要把發行說明全文貼進 SOUL,只摘「影響工具邊界」的條目。

問:能否用生成器一次性寫滿 MEMORY? 可以作草稿,但必須人工刪除敏感資訊與過時事實,否則模型會「自信地」引用錯誤狀態。

問:團隊多人改同一例項怎麼辦? 應使用 Git 或受控文件庫跟蹤變更,並在工單裡關聯 PR;避免在聊天裡互傳整份 MEMORY 導致版本分叉。

延伸閱讀:站內《OpenClaw 憑據與安全:SecretRef》《多專案隔離》《常見報錯 10 解》《v2026.4.5 升級與 doctor --fix》。若你使用 Gateway 公網訪問,請同步閱讀《Gateway 反代》以便在 SOUL 中準確描述「對外暴露的邊界」。

結語:人格與記憶是「可運維資產」,不是一次性提示詞

在純 Windows 或 Linux 上透過隧道跑代理也能對話,但往往要額外處理路徑、許可權與圖形授權的一致性;本地沒有 Mac 時,完整 macOS 桌面 + 瀏覽器 + 鑰匙序列為與 OpenClaw 實際落地環境更貼近。若你不想採購整機,又希望把 SOUL/MEMORY/IDENTITY 當成可審計、可回滾的配置面來維護,租賃帶 VNC 的遠端 Mac(如 VNCMac),配合幫助頁連線說明與站內 OpenClaw 系列文章,通常是時間成本更低的路徑。

在完整 macOS 桌面上穩定迭代 OpenClaw 配置

選擇遠端 Mac 節點與訪問方式;幫助頁含 SSH 與 VNC。站內 OpenClaw 部署、憑據與排錯文章可交叉閱讀。