---
read_when:
    - تغيير وقت تشغيل الوكيل، أو تمهيد مساحة العمل، أو سلوك الجلسة
summary: بيئة تشغيل الوكيل، وعقد مساحة العمل، وتمهيد الجلسة
title: بيئة تشغيل الوكيل
x-i18n:
    generated_at: "2026-04-30T07:51:06Z"
    model: gpt-5.5
    provider: openai
    source_hash: f4d65ee96cece296251d7d3a0512f12d2dfa900db0e5ffc0f37dcddae7ea55ad
    source_path: concepts/agent.md
    workflow: 16
---

يشغّل OpenClaw **وقت تشغيل وكيل مضمّنًا واحدًا** — عملية وكيل واحدة لكل
Gateway، مع مساحة عمله الخاصة وملفات التمهيد ومخزن الجلسات الخاص به. تغطي هذه الصفحة
عقد وقت التشغيل هذا: ما الذي يجب أن تحتويه مساحة العمل، وأي الملفات تُحقن،
وكيف تُمهّد الجلسات بالاستناد إليها.

## مساحة العمل (مطلوبة)

يستخدم OpenClaw دليل مساحة عمل وكيل واحدًا (`agents.defaults.workspace`) بوصفه دليل العمل **الوحيد** للوكيل (`cwd`) للأدوات والسياق.

موصى به: استخدم `openclaw setup` لإنشاء `~/.openclaw/openclaw.json` إذا كان مفقودًا وتهيئة ملفات مساحة العمل.

تخطيط مساحة العمل الكامل + دليل النسخ الاحتياطي: [مساحة عمل الوكيل](/ar/concepts/agent-workspace)

إذا كان `agents.defaults.sandbox` مفعّلًا، يمكن للجلسات غير الرئيسية تجاوز ذلك باستخدام
مساحات عمل لكل جلسة ضمن `agents.defaults.sandbox.workspaceRoot` (راجع
[إعدادات Gateway](/ar/gateway/configuration)).

## ملفات التمهيد (تُحقن)

داخل `agents.defaults.workspace`، يتوقع OpenClaw هذه الملفات القابلة للتعديل من المستخدم:

- `AGENTS.md` — تعليمات التشغيل + “الذاكرة”
- `SOUL.md` — الشخصية والحدود والنبرة
- `TOOLS.md` — ملاحظات الأدوات التي يحتفظ بها المستخدم (مثل `imsg` و`sag` والاصطلاحات)
- `BOOTSTRAP.md` — طقس تشغيل أولي لمرة واحدة (يُحذف بعد الإكمال)
- `IDENTITY.md` — اسم الوكيل/طابعه/رمزه التعبيري
- `USER.md` — ملف المستخدم + طريقة المخاطبة المفضلة

في أول دورة لجلسة جديدة، يحقن OpenClaw محتويات هذه الملفات مباشرة في سياق الوكيل.

تُتخطى الملفات الفارغة. تُقصّ الملفات الكبيرة وتُختصر مع علامة بحيث تبقى المطالبات خفيفة (اقرأ الملف للحصول على المحتوى الكامل).

إذا كان ملف مفقودًا، يحقن OpenClaw سطر علامة “ملف مفقود” واحدًا (وسيُنشئ `openclaw setup` قالبًا افتراضيًا آمنًا).

يُنشأ `BOOTSTRAP.md` فقط من أجل **مساحة عمل جديدة تمامًا** (لا توجد ملفات تمهيد أخرى). إذا حذفته بعد إكمال الطقس، فيجب ألا يُعاد إنشاؤه عند عمليات إعادة التشغيل اللاحقة.

لتعطيل إنشاء ملفات التمهيد بالكامل (لمساحات العمل المجهزة مسبقًا)، عيّن:

```json5
{ agents: { defaults: { skipBootstrap: true } } }
```

## الأدوات المدمجة

الأدوات الأساسية (read/exec/edit/write وأدوات النظام ذات الصلة) متاحة دائمًا،
وفقًا لسياسة الأدوات. `apply_patch` اختياري ومحكوم بواسطة
`tools.exec.applyPatch`. لا يتحكم `TOOLS.md` في الأدوات الموجودة؛ بل هو
إرشاد لكيف تريد _أنت_ استخدامها.

## Skills

يحمّل OpenClaw Skills من هذه المواقع (الأولوية الأعلى أولًا):

- مساحة العمل: `<workspace>/skills`
- Skills وكيل المشروع: `<workspace>/.agents/skills`
- Skills الوكيل الشخصية: `~/.agents/skills`
- المُدارة/المحلية: `~/.openclaw/skills`
- المضمّنة (المشحونة مع التثبيت)
- مجلدات Skills إضافية: `skills.load.extraDirs`

يمكن حجب Skills بواسطة الإعداد/البيئة (راجع `skills` في [إعدادات Gateway](/ar/gateway/configuration)).

## حدود وقت التشغيل

يُبنى وقت تشغيل الوكيل المضمّن على نواة وكيل Pi (النماذج والأدوات
ومسار المطالبة). إدارة الجلسات والاكتشاف وتوصيل الأدوات وتسليم القنوات
هي طبقات يملكها OpenClaw فوق تلك النواة.

## الجلسات

تُخزّن نسخ الجلسات بصيغة JSONL في:

- `~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl`

معرّف الجلسة ثابت ويختاره OpenClaw.
لا تُقرأ مجلدات الجلسات القديمة من أدوات أخرى.

## التوجيه أثناء البث

عندما يكون وضع الطابور `steer`، تُحقن الرسائل الواردة في التشغيل الحالي.
يُسلّم التوجيه المصطف **بعد انتهاء دورة المساعد الحالية من
تنفيذ استدعاءات أدواتها**، وقبل استدعاء LLM التالي. يفرّغ Pi كل رسائل
التوجيه المعلّقة معًا لـ `steer`؛ أما `queue` القديم فيفرّغ رسالة واحدة لكل
حد نموذج. لم يعد التوجيه يتخطى استدعاءات الأدوات المتبقية من رسالة
المساعد الحالية.

عندما يكون وضع الطابور `followup` أو `collect`، تُحتجز الرسائل الواردة حتى
تنتهي الدورة الحالية، ثم تبدأ دورة وكيل جديدة مع الحمولات المصطفة. راجع
[الطابور](/ar/concepts/queue) و[طابور التوجيه](/ar/concepts/queue-steering) لمعرفة وضع
وسلوك الحدود.

يرسل بث الكتل كتل المساعد المكتملة بمجرد انتهائها؛ وهو
**معطّل افتراضيًا** (`agents.defaults.blockStreamingDefault: "off"`).
اضبط الحد عبر `agents.defaults.blockStreamingBreak` (`text_end` مقابل `message_end`؛ الافتراضي text_end).
تحكّم في تقطيع الكتل اللين باستخدام `agents.defaults.blockStreamingChunk` (القيمة الافتراضية
800–1200 حرف؛ يفضّل فواصل الفقرات، ثم الأسطر الجديدة؛ والجمل أخيرًا).
ادمج المقاطع المبثوثة باستخدام `agents.defaults.blockStreamingCoalesce` لتقليل
الإزعاج الناتج عن الأسطر المفردة (دمج قائم على الخمول قبل الإرسال). تتطلب القنوات غير Telegram
تعيين `*.blockStreaming: true` صراحةً لتمكين ردود الكتل.
تُصدر ملخصات الأدوات المطوّلة عند بدء الأداة (بلا تأخير تجميعي)؛ ويبث Control UI
مخرجات الأدوات عبر أحداث الوكيل عند توفرها.
تفاصيل أكثر: [البث + التقطيع](/ar/concepts/streaming).

## مراجع النماذج

تُحلّل مراجع النماذج في الإعدادات (مثل `agents.defaults.model` و`agents.defaults.models`) بالتقسيم عند أول `/`.

- استخدم `provider/model` عند إعداد النماذج.
- إذا كان معرّف النموذج نفسه يحتوي على `/` (بنمط OpenRouter)، فأضف بادئة المزوّد (مثال: `openrouter/moonshotai/kimi-k2`).
- إذا حذفت المزوّد، يحاول OpenClaw استخدام اسم مستعار أولًا، ثم مطابقة مزوّد مهيأ فريدة لمعرّف النموذج الدقيق ذلك، وبعدها فقط يعود إلى مزوّد الإعداد الافتراضي. إذا لم يعد ذلك المزوّد يوفّر النموذج الافتراضي المهيأ، يعود OpenClaw إلى أول مزوّد/نموذج مهيأ بدلًا من إظهار افتراضي قديم لمزوّد تمت إزالته.

## الإعدادات (الحد الأدنى)

كحد أدنى، عيّن:

- `agents.defaults.workspace`
- `channels.whatsapp.allowFrom` (موصى به بشدة)

---

_التالي: [محادثات المجموعات](/ar/channels/group-messages)_ 🦞

## ذات صلة

- [مساحة عمل الوكيل](/ar/concepts/agent-workspace)
- [توجيه متعدد الوكلاء](/ar/concepts/multi-agent)
- [إدارة الجلسات](/ar/concepts/session)
