上下文¶

「Context」是 OpenClaw 在一次執行中送給模型的所有內容。它受限於模型的 context window（權杖上限）。 It is bounded by the model’s context window (token limit).

新手心智模型：

• System prompt（由 OpenClaw 建立）：規則、工具、Skills 清單、時間／執行期資訊，以及注入的工作區檔案。
• Conversation history：此工作階段中你的訊息 + 助手的訊息。
• Tool 呼叫／結果 + 附件：指令輸出、檔案讀取、影像／音訊等。

Context 不等同於「memory」：memory 可以儲存在磁碟上並於稍後重新載入；context 則是位於模型目前視窗中的內容。

快速開始（檢視 context）¶

• /status → 快速查看「我的視窗用了多少？」+ 工作階段設定。
• /context list → 注入了哪些內容 + 大致大小（每個檔案 + 總計）。
• /context detail → 更深入的拆解：每個檔案、每個工具 schema 的大小、每個 skill 條目的大小，以及 system prompt 的大小。
• /usage tokens → 在一般回覆後附加每次回覆的使用量頁尾。
• /compact → 將較舊的歷史摘要成精簡條目以釋放視窗空間。

另請參閱：Slash commands、Token 使用量與成本、Compaction。

範例輸出¶

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

/context list¶

🧠 Context breakdown
Workspace: <workspaceDir>
Bootstrap max/file: 20,000 chars
Sandbox: mode=non-main sandboxed=false
System 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 window¶

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

• System prompt（所有區段）。
• Conversation history。
• Tool 呼叫 + Tool 結果。
• 附件／逐字稿（圖片／音訊／檔案）。
• Compaction 摘要與修剪產物。
• 提供者的「包裝器」或隱藏標頭（不可見，但仍會計入）。

OpenClaw 如何建構 system prompt¶

System prompt 由 OpenClaw 持有，且每次執行都會重建。內容包含： It includes:

• 工具清單 + 簡短描述。
• Skills 清單（僅中繼資料；見下文）。
• 工作區位置。
• 時間（UTC + 若有設定則轉換為使用者時間）。
• 執行階段中繼資料（主機／作業系統／模型／思考）。
• 在 Project Context 下注入的工作區啟動檔案。

完整拆解：System Prompt。

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

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

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

大型檔案會依檔案使用 agents.defaults.bootstrapMaxChars 進行截斷（預設 20000 個字元）。/context 會顯示 原始 vs 注入 的大小，以及是否發生截斷。 /context shows raw vs injected sizes and whether truncation happened.

Skills：注入的內容 vs 隨需載入¶

System prompt 會包含精簡的 skills 清單（名稱 + 描述 + 位置）。這份清單具有實際的負擔。 This list has real overhead.

Skill instructions are not included by default. Skill 的指示 預設不會 包含。模型被期望在 需要時 才 read 該 skill 的 SKILL.md。

Tools：有兩種成本¶

Tools 以兩種方式影響 context：

1. System prompt 中的 Tool 清單文字（你看到的「Tooling」）。
2. 工具結構定義（JSON）。這些會傳送給模型，使其能夠呼叫工具。即使你看不到其純文字內容，它們仍會計入上下文。

/context detail 會拆解最大的 tool schema，讓你看出主要佔用來源。

指令、指示詞與「行內捷徑」¶

Slash commands 由 Gateway 閘道器 處理，行為略有不同： There are a few different behaviors:

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

詳細說明：Slash commands。

工作階段、壓縮與裁剪（哪些內容會被保留）¶

跨訊息會保留哪些內容取決於所使用的機制：

• 一般歷史紀錄會保留在工作階段逐字稿中，直到依政策進行壓縮／裁剪。
• Compaction 會將摘要持續寫入逐字稿，並保留近期訊息。
• Pruning 會從單次執行的 記憶體中 prompt 移除舊的 tool 結果，但不會改寫逐字稿。

文件：Session、Compaction、Session pruning。

/context 實際回報的是什麼¶

/context 在可用時，偏好最新的 以執行建構 的 system prompt 報告：

• System prompt (run) = 從最近一次嵌入式（具工具呼叫能力）執行中擷取，並保存在工作階段儲存區中。
• System prompt (estimate) = 當不存在執行報告時即時計算（或透過不產生報告的 CLI 後端執行時）。

Either way, it reports sizes and top contributors; it does not dump the full system prompt or tool schemas.