本網站為獨立社群專案,與 OpenClaw 官方無任何關聯。內容僅供參考。 了解更多

翻譯文件

本頁為社群翻譯版本,可能與官方最新內容有出入。 查看官方英文原文 →

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 佇列模式下,入站訊息會在每次工具呼叫後注入到當前執行中。替代模式(followupcollect)會將訊息排隊直到回合完成。

串流與模型設定

Block streaming 預設為關閉。模型參照使用 provider/model 格式,以第一個正斜線進行分割。

最低必要設定

  • agents.defaults.workspace
  • channels.whatsapp.allowFrom(強烈建議)