系統提示詞

OpenClaw 會為每次 Agent 執行建構自訂的系統提示詞。該提示詞由 OpenClaw 擁有，並不使用 pi-coding-agent 的預設提示詞。

該提示詞由 OpenClaw 組裝，並注入到每次 Agent 執行中。

提供者插件可以提供快取感知的提示詞指引，而無需替換完整的 OpenClaw 擁有的提示詞。提供者執行時可以：

替換一小組命名的核心區段（interaction_style, tool_call_style, execution_bias）
在提示詞快取邊界之上注入一個 穩定前綴 (stable prefix)
在提示詞快取邊界之下注入一個 動態後綴 (dynamic suffix)

使用提供者擁有的貢獻進行特定模型系列的調優。保留舊版 before_prompt_build 提示詞變更以實現相容性或真正的全域提示詞變更，而非正常的提供者行為。

結構

該提示詞刻意簡潔，並使用固定的區段：

Tooling：結構化工具的來源真實性提醒，加上執行時工具使用指引。
Safety：簡短的防護提醒，以避免權力尋求行為或規避監督。
Skills（可用時）：告訴模型如何隨需加載技能指令。
OpenClaw Self-Update：如何使用 config.schema.lookup 安全檢查配置，使用 config.patch 修補配置，使用 config.apply 替換完整配置，並且僅在明確的使用者請求下執行 update.run。僅限擁有者使用的 gateway 工具也會拒絕重寫 tools.exec.ask / tools.exec.security，包括正規化為這些受保護執行路徑的舊版 tools.bash.* 別名。
Workspace：工作目錄 (agents.defaults.workspace)。
Documentation：OpenClaw 文件的本地路徑（repo 或 npm 套件）以及閱讀時機。
Workspace Files (injected)：表示下方包含了引導檔案。
Sandbox（啟用時）：指示沙盒執行時、沙盒路徑，以及是否可用提權執行。
Current Date & Time：使用者本地時間、時區和時間格式。
Reply Tags：支援提供者的選用回覆標籤語法。
Heartbeats：心跳提示詞和確認行為。
Runtime：主機、作業系統、節點、模型、repo 根目錄（偵測到時）、思考層級（一行）。
Reasoning：目前可見性層級 + /reasoning 切換提示。

Tooling 區段還包含長期執行工作的執行時指引：

使用 cron 進行後續追蹤（check back later、提醒、週期性工作）而非 exec 睡眠迴圈、yieldMs 延遲技巧或重複的 process 輪詢
僅針對立即啟動並持續在背景執行的指令使用 exec / process
當啟用自動完成喚醒時，啟動指令一次，並在輸出內容或失敗時依賴基於推播的喚醒路徑
當您需要檢查正在執行的指令時，使用 process 來查看日誌、狀態、輸入或進行干預
如果任務較大，優先使用 sessions_spawn；子代理的完成是基於推播的，並會自動通知請求者
不要僅為了等待完成而在迴圈中輪詢 subagents list / sessions_list

當啟用實驗性的 update_plan 工具時，Tooling 也會指示模型僅將其用於非平凡的步驟工作，保持僅有一個 in_progress 步驟，並避免在每次更新後重複整個計畫。

系統提示中的安全防護措施僅供參考。它們指導模型行為但不強制執行策略。請使用工具策略、執行批准、沙盒和通道允許清單來進行強制執行；操作員可以刻意停用這些功能。

在具有原生批准卡片/按鈕的通道上，執行時提示現在會告訴代理優先依賴該原生批准 UI。僅當工具結果顯示聊天批准不可用或手動批准是唯一途徑時，才應包含手動 /approve 指令。

提示模式

OpenClaw 可以為子代理呈現較小的系統提示。執行時環境會為每次執行設定一個 promptMode（而非使用者可見的設定）：

full（預設）：包含上述所有部分。
minimal：用於子代理；省略 Skills、Memory Recall、OpenClaw Self-Update、Model Aliases、User Identity、Reply Tags、 Messaging、Silent Replies 和 Heartbeats。Tooling、Safety、 Workspace、Sandbox、Current Date & Time（已知時）、Runtime 和注入的內容仍然可用。
none：僅傳回基本身分行。

當設定 promptMode=minimal 時，額外注入的提示會被標記為 Subagent Context（子代理程式情境），而非 Group Chat Context（群組聊天情境）。

工作區引導注入

引導檔案會經過修剪並附加在 Project Context（專案情境）之下，以便模型無需明確讀取即可查看身分和設定檔情境：

AGENTS.md
SOUL.md
TOOLS.md
IDENTITY.md
USER.md
HEARTBEAT.md
BOOTSTRAP.md（僅限全新的工作區）
MEMORY.md（如果存在），否則使用 memory.md 作為小寫的備案

所有這些檔案在每個回合都會被 注入至情境視窗，這意味著它們會消耗 token。請保持內容簡潔——特別是 MEMORY.md，因為它會隨時間增長，導致意想不到的高情境使用率和更頻繁的壓縮。

注意： memory/*.md 每日檔案不會自動注入。它們是透過 memory_search 和 memory_get 工具按需存取的，因此除非模型明確讀取它們，否則它們不會計入情境視窗。

大型檔案會以標記截斷。每個檔案的最大大小由 agents.defaults.bootstrapMaxChars 控制（預設值：20000）。跨檔案注入的引導內容總計上限由 agents.defaults.bootstrapTotalMaxChars 限制（預設值：150000）。遺失的檔案會注入一個簡短的遺失檔案標記。發生截斷時，OpenClaw 可以在 Project Context 中注入警告區塊；請透過 agents.defaults.bootstrapPromptTruncationWarning 控制此行為（off、once、always；預設值：once）。

子代理程式工作階段僅會注入 AGENTS.md 和 TOOLS.md（其他引導檔案會被過濾掉，以保持子代理程式的情境精簡）。

內部掛鉤可以透過 agent:bootstrap 攔截此步驟，以變更或替換注入的引導檔案（例如將 SOUL.md 交換為替代人格）。

如果您想要讓代理程式聽起來不太通用，請從 SOUL.md Personality Guide 開始。

要檢查每個注入檔案的貢獻程度（原始檔案 vs 注入內容、截斷，加上工具 schema 開銷），請使用 /context list 或 /context detail。請參閱 Context。

時間處理

當已知使用者時區時，系統提示詞會包含一個專用的 Current Date & Time 區塊。為了保持提示詞快取的穩定性，它現在僅包含時區（沒有動態時鐘或時間格式）。

當代理程式需要當前時間時，請使用 session_status；狀態卡片包含時間戳記行。同一個工具可以選擇性地設定每個會話的模型覆寫（model=default 會清除它）。

設定方式：

agents.defaults.userTimezone
agents.defaults.timeFormat (auto | 12 | 24)

有關完整行為細節，請參閱 Date & Time。

技能

當存在符合條件的技能時，OpenClaw 會注入一個精簡的 available skills list (formatSkillsForPrompt)，其中包含每個技能的 檔案路徑。提示詞指示模型使用 read 載入列出路徑處的 SKILL.md （工作區、受管理或隨附）。如果沒有符合條件的技能，則會省略 Skills 區塊。

符合條件包括技能元數據閘道、執行時環境/設定檢查，以及當配置了 agents.defaults.skills 或 agents.list[].skills 時的有效代理程式技能允許清單。

<available_skills>
  <skill>
    <name>...</name>
    <description>...</description>
    <location>...</location>
  </skill>
</available_skills>

這既保持了基礎提示詞的精簡，同時又啟用了針對性的技能使用。

文件

如果有可用的文件，系統提示會包含一個 Documentation（文件） 部分，指向本機 OpenClaw 文件目錄（即 repo workspace 中的 docs/ 或隨附的 npm 套件文件），並且還會註記公開鏡像、原始碼 repo、社群 Discord 以及 ClawHub (https://clawhub.ai) 以便探索技能。該提示會指示模型優先查閱本機文件以了解 OpenClaw 的行為、指令、設定或架構，並且在可行時自行執行 openclaw status（僅在無法存取時才詢問使用者）。