Agent runtime

OpenClaw 運行一個 單一的內嵌代理運行時——每個 Gateway 一個代理程序，擁有專屬的工作區、啟動檔案和會話存儲。本頁面涵蓋了該運行時契約：工作區必須包含什麼、哪些檔案會被注入，以及會話如何針對其進行引導。

Workspace (required)

OpenClaw 使用單個代理工作區目錄 (agents.defaults.workspace) 作為代理用於工具和上下文的唯一工作目錄 (cwd)。

建議：如果缺失，請使用 openclaw setup 建立 ~/.openclaw/openclaw.json 並初始化工作區檔案。

完整的工作區佈局 + 備份指南：Agent workspace

如果啟用了 agents.defaults.sandbox，非主要會話可以使用 agents.defaults.sandbox.workspaceRoot 下的每個會話工作區來覆蓋此設置（請參閱 Gateway configuration）。

Bootstrap files (injected)

在 agents.defaults.workspace 內，OpenClaw 預期這些使用者可編輯的檔案：

AGENTS.md - 操作指令 + “記憶”
SOUL.md - 角色設定、邊界、語氣
TOOLS.md - 用戶維護的工具說明（例如 imsg、sag、慣例）
BOOTSTRAP.md - 一次性首次運行儀式（完成後刪除）
IDENTITY.md - 代理名稱/氛圍/表情符號
USER.md - 用戶資料 + 首選地址

在新會話的第一輪對話中，OpenClaw 會將這些檔案的內容注入到系統提示詞的項目上下文中。

空白檔案會被跳過。大型檔案會被修剪並用標記截斷，以保持提示精簡（讀取檔案以獲取完整內容）。

如果檔案遺失，OpenClaw 會注入一行單獨的「檔案遺失」標記（並且 openclaw setup 將建立一個安全的預設範本）。

BOOTSTRAP.md 僅為 全新的工作區 建立（不存在其他啟動檔案）。當它處於待處理狀態時，OpenClaw 會將其保留在項目上下文中，並為初始儀式添加系統提示詞引導，而不是將其複製到用戶訊息中。如果您在完成儀式後將其刪除，則不應在後續重啟時重新建立它。

若要完全停用啟動檔案的建立（對於已預先植入的工作區），請設定：

{ agents: { defaults: { skipBootstrap: true } } }

內建工具

核心工具（讀取/執行/編輯/寫入及相關系統工具）始終可用，但受工具策略約束。apply_patch 是可選的，並由 tools.exec.applyPatch 控制開關。TOOLS.md 並不控制哪些工具存在；它是關於您希望如何使用它們的指導。

技能

OpenClaw 會從以下位置載入技能（優先順序由高至低）：

工作區：<workspace>/skills
專案代理程式技能：<workspace>/.agents/skills
個人代理程式技能：~/.agents/skills
受管理/本機：~/.openclaw/skills
內建（隨安裝程式提供）
額外技能資料夾：skills.load.extraDirs

技能可以透過設定/環境變數進行限制（請參閱 Gateway configuration 中的 skills）。

執行時期邊界

嵌入式代理程式執行時期是建構在 Pi 代理程式核心（模型、工具和提示管線）之上。會話管理、探索、工具連線和通道傳遞則是在該核心之上的 OpenClaw 擁有層。

會話

會話逐字稿會以 JSONL 格式儲存於：

~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl

會話 ID 是穩定的，並由 OpenClaw 選擇。不會讀取來自其他工具的舊版會話資料夾。

串流時的導引

在執行期間到達的輸入提示預設會被導引至當前執行中。導引會在當前助手回合完成執行其工具呼叫後、在下一次 LLM 呼叫之前傳遞，並且不再跳過當前助手訊息中剩餘的工具呼叫。

/queue steer 是預設的主動執行行為。/queue followup 和 /queue collect 會讓訊息等待後續回合而不是進行導引。 /queue interrupt 則會中止主動執行。關於佇列和邊界行為，請參閱 Queue 和 Steering queue。

區塊串流會在完成後立即發送已完成的助手區塊；它預設為關閉 (agents.defaults.blockStreamingDefault: "off")。透過 agents.defaults.blockStreamingBreak 調整邊界 (text_end vs message_end；預設為 text_end)。使用 agents.defaults.blockStreamingChunk 控制軟區塊分塊（預設為 800-1200 個字元；優先段落分隔，然後是換行符號；最後是句子）。使用 agents.defaults.blockStreamingCoalesce 合併串流區塊以減少單行垃圾訊息（發送前基於閒置時間合併）。非 Telegram 頻道需要明確的 *.blockStreaming: true 才能啟用區塊回覆。詳細的工具摘要會在工具開始時發出（無防抖）；控制 UI 會在可用時透過代理事件串流工具輸出。更多細節：Streaming + chunking。

Model refs

設定中的模型參考（例如 agents.defaults.model 和 agents.defaults.models）透過在第一個 / 處分割來進行解析。

在配置模型時請使用 provider/model。
如果模型 ID 本身包含 /（OpenRouter 風格），請包含供應商前綴（例如：openrouter/moonshotai/kimi-k2）。
如果您省略提供者，OpenClaw 會先嘗試別名，然後是該確切模型 ID 的唯一已設定提供者匹配，最後才回退到已設定的預設提供者。如果該提供者不再公開已設定的預設模型，OpenClaw 會回退到第一個已設定的提供者/模型，而不是顯示陳舊的已移除提供者預設值。

Configuration (minimal)

至少設定:

agents.defaults.workspace
channels.whatsapp.allowFrom （強烈建議）

下一則：群組聊天 🦞