---
read_when:
    - می‌خواهید بدانید «زمینه» در OpenClaw به چه معناست
    - در حال اشکال‌زدایی این هستید که چرا مدل چیزی را «می‌داند» (یا آن را فراموش کرده است)
    - می‌خواهید سربار زمینه را کاهش دهید (/context، /status، /compact)
summary: 'زمینه: مدل چه چیزی می‌بیند، چگونه ساخته می‌شود و چگونه می‌توان آن را بررسی کرد'
title: زمینه
x-i18n:
    generated_at: "2026-07-27T16:22:56Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 1eb3d342a601a447487640587f746cc80a133ede338a880741f53c3e01f20ed1
    source_path: concepts/context.md
    workflow: 16
---

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

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

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

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

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

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

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

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

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

### `/context list`

```text
🧠 تفکیک زمینه
فضای کاری: <workspaceDir>
حداکثر راه‌اندازی/فایل: 12,000 نویسه
سندباکس: mode=non-main sandboxed=false
پرامپت سیستمی (اجرا): 38,412 نویسه (~9,603 توکن) (زمینهٔ پروژه 23,901 نویسه (~5,976 توکن))

فایل‌های تزریق‌شدهٔ فضای کاری:
- AGENTS.md: تأیید | خام 1,742 نویسه (~436 توکن) | تزریق‌شده 1,742 نویسه (~436 توکن)
- SOUL.md: تأیید | خام 912 نویسه (~228 توکن) | تزریق‌شده 912 نویسه (~228 توکن)
- TOOLS.md: کوتاه‌شده | خام 54,210 نویسه (~13,553 توکن) | تزریق‌شده 20,962 نویسه (~5,241 توکن)
- IDENTITY.md: تأیید | خام 211 نویسه (~53 توکن) | تزریق‌شده 211 نویسه (~53 توکن)
- USER.md: تأیید | خام 388 نویسه (~97 توکن) | تزریق‌شده 388 نویسه (~97 توکن)
- HEARTBEAT.md: موجود نیست | خام 0 | تزریق‌شده 0
- BOOTSTRAP.md: تأیید | خام 0 نویسه (~0 توکن) | تزریق‌شده 0 نویسه (~0 توکن)

فهرست Skills (متن پرامپت سیستمی): 2,184 نویسه (~546 توکن) (12 Skill)
ابزارها: read، edit، write، exec، process، browser، message، sessions_send، …
فهرست ابزارها (متن پرامپت سیستمی): 1,032 نویسه (~258 توکن)
طرح‌واره‌های ابزار (JSON): 31,988 نویسه (~7,997 توکن) (در زمینه محاسبه می‌شود؛ به‌صورت متن نمایش داده نمی‌شود)
ابزارها: (همان موارد بالا)

توکن‌های نشست (ذخیره‌شده در کش): مجموع 14,250 / ctx=32,000
```

### `/context detail`

```text
🧠 تفکیک زمینه (تفصیلی)
…
بزرگ‌ترین Skills (اندازهٔ ورودی پرامپت):
- frontend-design: 412 نویسه (~103 توکن)
- oracle: 401 نویسه (~101 توکن)
… (+10 Skill دیگر)

بزرگ‌ترین ابزارها (اندازهٔ طرح‌واره):
- browser: 9,812 نویسه (~2,453 توکن)
- exec: 6,240 نویسه (~1,560 توکن)
… (+N ابزار دیگر)
```

### `/context map`

تصویری را ارسال می‌کند که از جدیدترین گزارش اجرای ذخیره‌شده در کش به‌همراه رونوشت نشست تولید شده است. پیش از اینکه یک پیام عادی در نشست گزارش اجرا تولید کند، `/context map` به‌جای رندر یک برآورد، پیام دردسترس‌نبودن را برمی‌گرداند. مساحت مستطیل متناسب با نویسه‌های ردیابی‌شدهٔ پرامپت است:

- رونوشت گفتگو (پیام‌های کاربر، پاسخ‌های دستیار، نتایج ابزار، خلاصه‌های Compaction)، به‌علاوهٔ زمینهٔ محیط اجرای هر نوبت و افزوده‌های پرامپت هوک که فقط به مدل می‌رسند
- فایل‌های تزریق‌شدهٔ فضای کاری
- متن پایهٔ پرامپت سیستمی
- ورودی‌های پرامپت Skill
- طرح‌واره‌های JSON ابزار

گروه گفتگو هم‌زمان با نشست رشد می‌کند، بنابراین نقشه در هر نوبت تغییر می‌کند؛ پس از Compaction، در یک کاشی خلاصه‌ها جمع می‌شود.

`/context list`، `/context detail` و `/context json` همچنان می‌توانند هنگامی که هیچ گزارش اجرایی در کش نیست، برآوردی عنداللزوم را بررسی کنند.

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

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

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

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

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

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

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

## فایل‌های تزریق‌شدهٔ فضای کاری (زمینهٔ پروژه)

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

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

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

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

## Skills: تزریق‌شده در برابر بارگذاری عنداللزوم

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

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

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

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

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

`/context detail` بزرگ‌ترین طرح‌واره‌های ابزار را تفکیک می‌کند تا بتوانید عامل‌های غالب را ببینید.

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

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

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

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

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

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

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

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

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

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

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

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

در هر دو حالت، اندازه‌ها و بزرگ‌ترین عوامل مشارکت‌کننده را گزارش می‌کند؛ **کل** پرامپت سیستمی یا طرح‌واره‌های ابزار را تخلیه نمی‌کند. در حالت تفصیلی، رونوشت نشست را نیز با همان گزارهٔ پیامِ گفتگوی واقعی که Compaction استفاده می‌کند مقایسه می‌کند تا تشخیص مصرف بالای پرامپت/کش از تاریخچهٔ گفتگوی قابل فشرده‌سازی آسان‌تر شود.

## مرتبط

<CardGroup cols={2}>
  <Card title="موتور زمینه" href="/fa/concepts/context-engine" icon="puzzle-piece">
    تزریق سفارشی زمینه از طریق Pluginها.
  </Card>
  <Card title="Compaction" href="/fa/concepts/compaction" icon="compress">
    خلاصه‌سازی گفتگوهای طولانی برای نگه‌داشتن آن‌ها در پنجرهٔ مدل.
  </Card>
  <Card title="پرامپت سیستمی" href="/fa/concepts/system-prompt" icon="message-lines">
    نحوهٔ ساخت پرامپت سیستمی و آنچه در هر نوبت تزریق می‌کند.
  </Card>
  <Card title="حلقهٔ عامل" href="/fa/concepts/agent-loop" icon="arrows-rotate">
    چرخهٔ کامل اجرای عامل، از پیام ورودی تا پاسخ نهایی.
  </Card>
</CardGroup>
