---
read_when:
    - تغيير سلوك وقت تشغيل الوكيل، أو تمهيد مساحة العمل، أو الجلسة
summary: وقت تشغيل الوكيل، وعقد مساحة العمل، وتهيئة الجلسة
title: بيئة تشغيل الوكيل
x-i18n:
    generated_at: "2026-06-27T17:27:00Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 2fb4d3f0bb6e8aa2a23d00f5def5eb0ffa152bc75f82a12c40ac7ed00776011c
    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` إلا من أجل **مساحة عمل جديدة تمامًا** (لا توجد ملفات تمهيد أخرى). بينما يكون معلقًا، يُبقيه OpenClaw في سياق المشروع ويضيف إرشادات تمهيد إلى مطالبة النظام للطقس الأولي بدلًا من نسخه إلى رسالة المستخدم. إذا حذفته بعد إكمال الطقس، فلا ينبغي إعادة إنشائه عند عمليات إعادة التشغيل اللاحقة.

بعد ملاحظة مساحة عمل، يحتفظ OpenClaw أيضًا بعلامة تصديق في دليل الحالة لمسار مساحة العمل. إذا اختفت مساحة عمل تم التصديق عليها مؤخرًا أو مُسحت، يرفض بدء التشغيل إعادة بذر `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 على مجلدات مجمّعة مثل
`<workspace>/skills/personal/foo/SKILL.md`؛ تظل Skill معروضة باسم frontmatter
المسطح الخاص بها، مثل `foo`.

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

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

وقت تشغيل الوكيل المضمّن مملوك لـ OpenClaw: يشارك اكتشاف النماذج، وتوصيل الأدوات،
وتجميع المطالبات، وإدارة الجلسات، وتسليم القنوات سطح وقت تشغيل متكاملًا واحدًا.

## الجلسات

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

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

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

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

تُوجّه المطالبات الواردة التي تصل في منتصف التشغيل إلى التشغيل الحالي افتراضيًا.
يتم تسليم التوجيه **بعد انتهاء دور المساعد الحالي من تنفيذ استدعاءات
أدواته**، قبل استدعاء LLM التالي، ولم يعد يتخطى استدعاءات الأدوات المتبقية
من رسالة المساعد الحالية.

`/queue steer` هو سلوك التشغيل النشط الافتراضي. تجعل `/queue followup` و
`/queue collect` الرسائل تنتظر دورًا لاحقًا بدلًا من التوجيه.
أما `/queue interrupt` فيلغي التشغيل النشط بدلًا من ذلك. راجع [قائمة الانتظار](/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` صراحةً لتمكين ردود الكتل.
تُصدر ملخصات الأدوات المطوّلة عند بدء الأداة (من دون debounce)؛ وتبث 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)