你已經能跑通 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 續費與資料》匯出思路)。
③ 落地步驟:從空目錄到可審計的最小閉環
確認 OpenClaw 版本與配置根目錄
在終端執行 openclaw --version 與 openclaw doctor,記錄 canonical 路徑(見 v2026.4.5 升級文)。
建立或更新 IDENTITY:一句話名稱 + 渠道差異
避免與品牌名衝突;若多語言,註明預設回覆語言。
編寫 SOUL:邊界優先於「人設修辭」
列出禁止行為(例如擅自對外發郵件)、與合規相關的提醒。
編寫 MEMORY:事實與偏好,不含金鑰
倉庫根路徑、發版日、術語對照;金鑰僅寫 SecretRef 名。
在 VNC 下用 GUI 編輯器儲存為 UTF-8
避免 Windows 側編輯引入 BOM 或 CRLF 導致解析異常。
重啟或熱載入後走一輪對話迴歸
同一提示詞連問兩次,觀察語氣與事實是否一致。
把變更記入團隊工單或內部 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
問:能否用生成器一次性寫滿 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 系列文章,通常是時間成本更低的路徑。