---
read_when:
    - می‌خواهید بدانید «زمینه» در OpenClaw چه معنایی دارد
    - در حال عیب‌یابی این هستید که چرا مدل چیزی را «می‌داند» (یا آن را فراموش کرده است)
    - می‌خواهید سربار زمینه را کاهش دهید (/context, /status, /compact)
summary: 'زمینه: آنچه مدل می‌بیند، نحوه ساخته‌شدن آن، و نحوه بررسی آن'
title: زمینه
x-i18n:
    generated_at: "2026-04-29T22:42:20Z"
    model: gpt-5.5
    provider: openai
    source_hash: 537c989d1578a186a313698d3b97d75111fedb641327fb7a8b72e47b71b84b85
    source_path: concepts/context.md
    workflow: 16
---

«زمینه» یعنی **هر چیزی که OpenClaw برای یک اجرا به مدل می‌فرستد**. این مقدار با **پنجرهٔ زمینه** مدل (محدودیت توکن) محدود می‌شود.

مدل ذهنی مبتدی:

- **پرامپت سیستم** (ساخته‌شده توسط OpenClaw): قوانین، ابزارها، فهرست Skills، زمان/محیط اجرا، و فایل‌های workspace تزریق‌شده.
- **تاریخچهٔ مکالمه**: پیام‌های شما + پیام‌های دستیار برای این نشست.
- **فراخوانی‌ها/نتایج ابزار + پیوست‌ها**: خروجی فرمان، خواندن فایل، تصاویر/صوت، و غیره.

زمینه _همان «حافظه» نیست_: حافظه می‌تواند روی دیسک ذخیره شود و بعدا دوباره بارگذاری شود؛ زمینه چیزی است که داخل پنجرهٔ فعلی مدل قرار دارد.

## شروع سریع (بررسی زمینه)

- `/status` → نمای سریع «پنجرهٔ من چقدر پر است؟» + تنظیمات نشست.
- `/context list` → چه چیزهایی تزریق شده + اندازه‌های تقریبی (برای هر فایل + مجموع‌ها).
- `/context detail` → تفکیک عمیق‌تر: اندازه‌های هر فایل، هر schema ابزار، هر ورودی Skill، و اندازهٔ پرامپت سیستم.
- `/usage tokens` → افزودن پانویس مصرف هر پاسخ به پاسخ‌های عادی.
- `/compact` → خلاصه‌کردن تاریخچهٔ قدیمی‌تر در یک ورودی فشرده برای آزادکردن فضای پنجره.

همچنین ببینید: [فرمان‌های اسلش](/fa/tools/slash-commands)، [مصرف توکن و هزینه‌ها](/fa/reference/token-use)، [Compaction](/fa/concepts/compaction).

## خروجی نمونه

مقادیر بسته به مدل، ارائه‌دهنده، سیاست ابزار، و محتوای workspace شما متفاوت‌اند.

### `/context list`

```
🧠 Context breakdown
Workspace: <workspaceDir>
Bootstrap max/file: 12,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)
```

## چه چیزهایی در پنجرهٔ زمینه حساب می‌شوند

هر چیزی که مدل دریافت می‌کند حساب می‌شود، از جمله:

- پرامپت سیستم (همهٔ بخش‌ها).
- تاریخچهٔ مکالمه.
- فراخوانی‌های ابزار + نتایج ابزار.
- پیوست‌ها/رونوشت‌ها (تصاویر/صوت/فایل‌ها).
- خلاصه‌های Compaction و مصنوعات هرس.
- «پوشش‌ها» یا سربرگ‌های پنهان ارائه‌دهنده (قابل مشاهده نیستند، اما همچنان حساب می‌شوند).

## OpenClaw چگونه پرامپت سیستم را می‌سازد

پرامپت سیستم **متعلق به OpenClaw** است و در هر اجرا دوباره ساخته می‌شود. شامل موارد زیر است:

- فهرست ابزار + توضیح‌های کوتاه.
- فهرست Skills (فقط فراداده؛ پایین‌تر را ببینید).
- مکان workspace.
- زمان (UTC + زمان کاربرِ تبدیل‌شده، اگر پیکربندی شده باشد).
- فرادادهٔ محیط اجرا (میزبان/سیستم‌عامل/مدل/تفکر).
- فایل‌های bootstrap تزریق‌شدهٔ workspace زیر **Project Context**.

تفکیک کامل: [پرامپت سیستم](/fa/concepts/system-prompt).

## فایل‌های workspace تزریق‌شده (Project Context)

به‌طور پیش‌فرض، OpenClaw مجموعهٔ ثابتی از فایل‌های workspace را تزریق می‌کند (اگر موجود باشند):

- `AGENTS.md`
- `SOUL.md`
- `TOOLS.md`
- `IDENTITY.md`
- `USER.md`
- `HEARTBEAT.md`
- `BOOTSTRAP.md` (فقط اجرای نخست)

فایل‌های بزرگ برای هر فایل با استفاده از `agents.defaults.bootstrapMaxChars` (پیش‌فرض `12000` نویسه) کوتاه می‌شوند. OpenClaw همچنین با `agents.defaults.bootstrapTotalMaxChars` (پیش‌فرض `60000` نویسه) یک سقف کلی برای تزریق bootstrap در همهٔ فایل‌ها اعمال می‌کند. `/context` اندازه‌های **خام در برابر تزریق‌شده** و اینکه آیا کوتاه‌سازی رخ داده است یا نه را نشان می‌دهد.

وقتی کوتاه‌سازی رخ می‌دهد، محیط اجرا می‌تواند یک بلوک هشدار داخل پرامپت را زیر Project Context تزریق کند. این را با `agents.defaults.bootstrapPromptTruncationWarning` (`off`، `once`، `always`؛ پیش‌فرض `once`) پیکربندی کنید.

## Skills: تزریق‌شده در برابر بارگذاری برحسب نیاز

پرامپت سیستم یک **فهرست Skills** فشرده را شامل می‌شود (نام + توضیح + مکان). این فهرست سربار واقعی دارد.

دستورالعمل‌های Skill به‌طور پیش‌فرض گنجانده نمی‌شوند. انتظار می‌رود مدل `SKILL.md` مربوط به Skill را **فقط هنگام نیاز** `read` کند.

## ابزارها: دو هزینه وجود دارد

ابزارها به دو شکل روی زمینه اثر می‌گذارند:

1. **متن فهرست ابزار** در پرامپت سیستم (چیزی که به‌عنوان «ابزاردهی» می‌بینید).
2. **schemaهای ابزار** (JSON). این‌ها به مدل فرستاده می‌شوند تا بتواند ابزارها را فراخوانی کند. با اینکه آن‌ها را به‌صورت متن ساده نمی‌بینید، در زمینه حساب می‌شوند.

`/context detail` بزرگ‌ترین schemaهای ابزار را تفکیک می‌کند تا ببینید چه چیزی غالب است.

## فرمان‌ها، دستورها، و «میان‌برهای درون‌خطی»

فرمان‌های اسلش توسط Gateway مدیریت می‌شوند. چند رفتار متفاوت وجود دارد:

- **فرمان‌های مستقل**: پیامی که فقط `/...` باشد به‌عنوان فرمان اجرا می‌شود.
- **دستورها**: `/think`، `/verbose`، `/trace`، `/reasoning`، `/elevated`، `/model`، `/queue` پیش از اینکه مدل پیام را ببیند حذف می‌شوند.
  - پیام‌های فقط-دستور تنظیمات نشست را پایدار می‌کنند.
  - دستورهای درون‌خطی در یک پیام عادی به‌عنوان راهنمای همان پیام عمل می‌کنند.
- **میان‌برهای درون‌خطی** (فقط فرستنده‌های allowlistشده): بعضی توکن‌های `/...` داخل یک پیام عادی می‌توانند فورا اجرا شوند (نمونه: «hey /status»)، و پیش از اینکه مدل متن باقی‌مانده را ببیند حذف می‌شوند.

جزئیات: [فرمان‌های اسلش](/fa/tools/slash-commands).

## نشست‌ها، Compaction، و هرس (چه چیزی پایدار می‌ماند)

اینکه چه چیزی در میان پیام‌ها پایدار می‌ماند به سازوکار بستگی دارد:

- **تاریخچهٔ عادی** در رونوشت نشست پایدار می‌ماند تا زمانی که طبق سیاست فشرده/هرس شود.
- **Compaction** یک خلاصه را در رونوشت پایدار می‌کند و پیام‌های اخیر را دست‌نخورده نگه می‌دارد.
- **هرس** نتایج ابزار قدیمی را از پرامپت _درون‌حافظه‌ای_ حذف می‌کند تا فضای پنجرهٔ زمینه آزاد شود، اما رونوشت نشست را بازنویسی نمی‌کند — تاریخچهٔ کامل همچنان روی دیسک قابل بررسی است.

مستندات: [نشست](/fa/concepts/session)، [Compaction](/fa/concepts/compaction)، [هرس نشست](/fa/concepts/session-pruning).

به‌طور پیش‌فرض، OpenClaw از موتور زمینهٔ داخلی `legacy` برای مونتاژ و
Compaction استفاده می‌کند. اگر Pluginی نصب کنید که `kind: "context-engine"` ارائه می‌دهد و
آن را با `plugins.slots.contextEngine` انتخاب کنید، OpenClaw مونتاژ زمینه،
`/compact`، و hookهای چرخهٔ عمر زمینهٔ subagent مرتبط را به‌جای آن به همان
موتور واگذار می‌کند. `ownsCompaction: false` باعث fallback خودکار به موتور
`legacy` نمی‌شود؛ موتور فعال همچنان باید `compact()` را درست پیاده‌سازی کند. برای
رابط قابل اتصال کامل، hookهای چرخهٔ عمر، و پیکربندی، [موتور زمینه](/fa/concepts/context-engine) را ببینید.

## `/context` واقعا چه چیزی گزارش می‌کند

`/context` در صورت وجود، گزارش پرامپت سیستم **ساخته‌شده در اجرا**ی اخیر را ترجیح می‌دهد:

- `System prompt (run)` = از آخرین اجرای تعبیه‌شده (دارای قابلیت ابزار) گرفته شده و در store نشست پایدار شده است.
- `System prompt (estimate)` = وقتی گزارش اجرا وجود ندارد (یا هنگام اجرا از طریق یک backend CLI که گزارش تولید نمی‌کند) در لحظه محاسبه می‌شود.

در هر دو حالت، اندازه‌ها و مشارکت‌کنندگان اصلی را گزارش می‌کند؛ **کل** پرامپت سیستم یا schemaهای ابزار را dump نمی‌کند.

## مرتبط

- [موتور زمینه](/fa/concepts/context-engine) — تزریق زمینهٔ سفارشی از طریق plugins
- [Compaction](/fa/concepts/compaction) — خلاصه‌کردن مکالمه‌های طولانی
- [پرامپت سیستم](/fa/concepts/system-prompt) — پرامپت سیستم چگونه ساخته می‌شود
- [حلقهٔ عامل](/fa/concepts/agent-loop) — چرخهٔ کامل اجرای عامل
