---
read_when:
    - تغيير وقت تشغيل الوكيل، أو تهيئة مساحة العمل، أو سلوك الجلسة
summary: وقت تشغيل الوكيل، وعقد مساحة العمل، وتهيئة الجلسة
title: وقت تشغيل الوكيل
x-i18n:
    generated_at: "2026-04-05T12:39:52Z"
    model: gpt-5.4
    provider: openai
    source_hash: e2ff39f4114f009e5b1f86894ea4bb29b1c9512563b70d063f09ca7cde5e8948
    source_path: concepts/agent.md
    workflow: 15
---

# وقت تشغيل الوكيل

يشغّل OpenClaw وقت تشغيل وكيل مضمّنًا واحدًا.

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

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

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

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

إذا كان `agents.defaults.sandbox` مفعّلًا، يمكن للجلسات غير الرئيسية تجاوز ذلك باستخدام
مساحات عمل لكل جلسة ضمن `agents.defaults.sandbox.workspaceRoot` (راجع
[Gateway configuration](/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
{ agent: { 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 configuration](/gateway/configuration)).

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

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

## الجلسات

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

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

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

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

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

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

يرسل بث الكتل كتل المساعد المكتملة بمجرد انتهائها؛ وهو
**معطّل افتراضيًا** (`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
ببث مخرجات الأدوات عبر أحداث الوكيل عند توفرها.
مزيد من التفاصيل: [البث + التجزئة](/concepts/streaming).

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

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

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

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

كحد أدنى، اضبط:

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

---

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