上下文

「上下文」是 OpenClaw 在一次執行中傳送給模型的所有內容。它受模型的 上下文視窗（token 限制）約束。

初學者心智模型：

• 系統提示（由 OpenClaw 建構）：規則、工具、Skills 清單、時間/執行階段，以及注入的工作區檔案。
• 對話歷史：你在此工作階段中的訊息 + 助理的訊息。
• 工具呼叫/結果 + 附件：命令輸出、檔案讀取、圖片/音訊等。

上下文與「記憶」不是同一件事：記憶可以儲存在磁碟上並稍後重新載入；上下文則是目前位於模型視窗內的內容。

快速開始（檢查上下文）

• /status → 快速查看「我的視窗有多滿？」+ 工作階段設定。
• /context list → 已注入的內容 + 粗略大小（每個檔案 + 總計）。
• /context detail → 更深入的分解：每個檔案、每個工具結構描述大小、每個 Skill 項目大小，以及系統提示大小。
• /context map → 目前工作階段中已追蹤上下文貢獻來源的 WinDirStat 風格樹狀圖圖片。
• /usage tokens → 在一般回覆後附加每則回覆的使用量頁尾。
• /compact → 將較舊的歷史摘要成精簡項目，以釋放視窗空間。

另請參閱：斜線命令、Token 使用量與成本、Compaction。

範例輸出

數值會依模型、提供者、工具政策，以及工作區中的內容而異。

/context list

🧠 Context breakdownWorkspace: <workspaceDir>Bootstrap max/file: 12,000 charsSandbox: mode=non-main sandboxed=falseSystem prompt (run): 38,412 chars (~9,603 tok) (Project Context 23,901 chars (~5,976 tok)) Injected workspace files:- AGENTS.md: OK | raw 1,742 chars (~436 tok) | injected 1,742 chars (~436 tok)- SOUL.md: OK | raw 912 chars (~228 tok) | injected 912 chars (~228 tok)- TOOLS.md: TRUNCATED | raw 54,210 chars (~13,553 tok) | injected 20,962 chars (~5,241 tok)- IDENTITY.md: OK | raw 211 chars (~53 tok) | injected 211 chars (~53 tok)- USER.md: OK | raw 388 chars (~97 tok) | injected 388 chars (~97 tok)- HEARTBEAT.md: MISSING | raw 0 | injected 0- BOOTSTRAP.md: OK | raw 0 chars (~0 tok) | injected 0 chars (~0 tok) Skills list (system prompt text): 2,184 chars (~546 tok) (12 skills)Tools: read, edit, write, exec, process, browser, message, sessions_send, …Tool list (system prompt text): 1,032 chars (~258 tok)Tool schemas (JSON): 31,988 chars (~7,997 tok) (counts toward context; not shown as text)Tools: (same as above) Session tokens (cached): 14,250 total / ctx=32,000

/context detail

🧠 Context breakdown (detailed)…Top skills (prompt entry size):- frontend-design: 412 chars (~103 tok)- oracle: 401 chars (~101 tok)… (+10 more skills) Top tools (schema size):- browser: 9,812 chars (~2,453 tok)- exec: 6,240 chars (~1,560 tok)… (+N more tools)

/context map

會傳送一張由最新快取執行報告產生的圖片。在工作階段中有一般訊息產生執行報告之前，/context map 會回傳不可用訊息，而不是渲染估算結果。矩形面積與已追蹤的提示字元數成比例：

• 注入的工作區檔案
• 基礎系統提示文字
• Skill 提示項目
• 工具 JSON 結構描述

即使沒有快取執行報告，/context list、/context detail 和 /context json 仍可檢查隨選估算。

什麼會計入上下文視窗

模型收到的一切都會計入，包括：

• 系統提示（所有區段）。
• 對話歷史。
• 工具呼叫 + 工具結果。
• 附件/轉錄稿（圖片/音訊/檔案）。
• Compaction 摘要與修剪成品。
• 提供者「包裝」或隱藏標頭（不可見，但仍會計入）。

OpenClaw 如何建構系統提示

系統提示由 OpenClaw 擁有，並在每次執行時重新建構。它包含：

• 工具清單 + 簡短說明。
• Skills 清單（僅中繼資料；見下文）。
• 工作區位置。
• 時間（UTC + 已設定時轉換後的使用者時間）。
• 執行階段中繼資料（主機/OS/模型/thinking）。
• 注入在 Project Context 下的工作區啟動檔案。

完整分解：系統提示。

注入的工作區檔案（Project Context）

預設情況下，OpenClaw 會注入一組固定的工作區檔案（若存在）：

• AGENTS.md
• SOUL.md
• TOOLS.md
• IDENTITY.md
• USER.md
• HEARTBEAT.md
• BOOTSTRAP.md（僅首次執行）

大型檔案會使用 agents.defaults.bootstrapMaxChars（預設 12000 字元）按檔案截斷。OpenClaw 也會透過 agents.defaults.bootstrapTotalMaxChars（預設 60000 字元）在所有檔案上強制套用啟動注入總上限。/context 會顯示原始 vs 注入後大小，以及是否發生截斷。

發生截斷時，執行階段可以在 Project Context 下於提示內注入警告區塊。可使用 agents.defaults.bootstrapPromptTruncationWarning 設定此行為（off、once、always；預設 once）。

Skills：注入 vs 隨選載入

系統提示包含精簡的 Skills 清單（名稱 + 說明 + 位置）。此清單有實際開銷。

Skill 指令預設_不會_包含在內。模型應該只在需要時 read 該 Skill 的 SKILL.md。

工具：有兩種成本

工具會以兩種方式影響上下文：

1. 系統提示中的工具清單文字（你看到的「Tooling」）。
2. 工具結構描述（JSON）。這些會傳送給模型，使其能呼叫工具。即使你不會以純文字形式看到它們，它們仍會計入上下文。

/context detail 會分解最大的工具結構描述，讓你看出主要佔用來源。

命令、指令與「行內捷徑」

斜線命令由 Gateway 處理。有幾種不同的行為：

• 獨立命令：只有 /... 的訊息會以命令執行。
• 指令：/think、/verbose、/trace、/reasoning、/elevated、/model、/queue 會在模型看到訊息前被移除。
  • 只有指令的訊息會保留工作階段設定。
  • 一般訊息中的行內指令會作為單則訊息提示。
• 行內捷徑（僅限允許清單中的傳送者）：一般訊息內的特定 /... token 可以立即執行（範例：「hey /status」），並會在模型看到剩餘文字前被移除。

詳情：斜線命令。

工作階段、Compaction 與修剪（什麼會保留）

跨訊息保留的內容取決於機制：

• 一般歷史會保留在工作階段轉錄稿中，直到依政策被 compact/prune。
• Compaction 會將摘要保留到轉錄稿中，並保持近期訊息完整。
• 修剪會從_記憶體內_提示中移除舊工具結果，以釋放上下文視窗空間，但不會重寫工作階段轉錄稿 - 完整歷史仍可在磁碟上檢查。

文件：工作階段、Compaction、工作階段修剪。

預設情況下，OpenClaw 會使用內建的 legacy 上下文引擎進行組裝與 Compaction。如果你安裝提供 kind: "context-engine" 的 Plugin，並使用 plugins.slots.contextEngine 選取它，OpenClaw 會改為將上下文組裝、 /compact 以及相關子代理上下文生命週期鉤子委派給該引擎。 ownsCompaction: false 不會自動回退到 legacy 引擎；啟用中的引擎仍必須正確實作 compact()。完整的可插拔介面、生命週期鉤子與設定請參閱 上下文引擎。

/context 實際回報什麼

可用時，/context 會優先使用最新的執行時建構系統提示報告：

• System prompt (run) = 從最後一次嵌入式（可用工具）執行擷取，並保留在工作階段儲存中。
• System prompt (estimate) = 沒有執行報告時即時計算（或透過不產生該報告的 CLI 後端執行時）。

無論哪種方式，它都會回報大小與主要貢獻來源；它不會傾印完整系統提示或工具結構描述。

相關