> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 上下文

# 上下文

「Context」是 **OpenClaw 在一次執行中送給模型的所有內容**。它受限於模型的 **context window**（權杖上限）。 「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](/tools/slash-commands)、[Token 使用量與成本](/reference/token-use)、[Compaction](/concepts/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 結果。
* Attachments/transcripts (images/audio/files).
* Compaction 摘要與修剪產物。
* 提供者的「包裝器」或隱藏標頭（不可見，但仍會計入）。

## OpenClaw 如何建構 system prompt

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

* 工具清單 + 簡短描述。
* Skills 清單（僅中繼資料；見下文）。
* 工作區位置。
* 時間（UTC + 若有設定則轉換為使用者時間）。
* Runtime metadata (host/OS/model/thinking).
* 在 **Project Context** 下注入的工作區啟動檔案。

完整拆解：[System Prompt](/concepts/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. OpenClaw 亦會透過 `agents.defaults.bootstrapTotalMaxChars`（預設 `24000` 字元）對所有檔案的 bootstrap 注入總量進行上限限制。 `/context` shows **raw vs injected** sizes and whether truncation happened.

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

System prompt 會包含精簡的 **skills 清單**（名稱 + 描述 + 位置）。這份清單具有實際的負擔。 This list has real overhead. 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. **Tool schemas** (JSON). These are sent to the model so it can call tools. They count toward context even though you don’t see them as plain text.

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

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

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

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

詳細說明：[Slash commands](/tools/slash-commands)。

## Sessions, compaction, and pruning (what persists)

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

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

文件：[Session](/concepts/session)、[Compaction](/concepts/compaction)、[Session pruning](/concepts/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.