Agent 執行環境
OpenClaw Agent 執行環境的核心概念,包括引導檔案、技能與工具、工作階段管理及訊息導向機制。
核心概念
OpenClaw 的 Agent 執行環境建立在 pi-mono 之上,以單一嵌入式 Agent 運作。它需要一個工作區目錄(agents.defaults.workspace)作為 Agent 的工作目錄,用於所有工具和上下文。
引導檔案
在首次工作階段回合時,OpenClaw 會將六個使用者可編輯的檔案注入到 Agent 上下文中:
- AGENTS.md:操作指令與記憶
- SOUL.md:人設、邊界與語調
- TOOLS.md:使用者維護的工具筆記
- BOOTSTRAP.md:一次性初始化儀式
- IDENTITY.md:Agent 名稱與識別資訊
- USER.md:使用者個人資料
空白檔案會被跳過。大型檔案會被修剪和截斷並附上標記,以保持提示精簡。
可透過在設定中設置 { agent: { skipBootstrap: true } } 來停用引導檔案的建立。
技能與工具
系統從三個位置載入技能,工作區檔案在名稱衝突時優先。核心工具(read/exec/edit/write)始終可用,受工具策略約束。apply_patch 需要特定的設定閘控。
工作階段管理
工作階段逐字稿以 JSONL 檔案儲存於 ~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl。舊版 Pi/Tau 工作階段資料夾不會被參考。
訊息導向
在 steer 佇列模式下,入站訊息會在每次工具呼叫後注入到當前執行中。替代模式(followup、collect)會將訊息排隊直到回合完成。
串流與模型設定
Block streaming 預設為關閉。模型參照使用 provider/model 格式,以第一個正斜線進行分割。
最低必要設定
agents.defaults.workspacechannels.whatsapp.allowFrom(強烈建議)