---
read_when:
    - بدء جلسة وكيل OpenClaw جديدة
    - تفعيل Skills الافتراضية أو تدقيقها
summary: تعليمات وكيل OpenClaw الافتراضية وقائمة Skills لإعداد المساعد الشخصي
title: AGENTS.md الافتراضي
x-i18n:
  refreshed_at: '2026-04-28T05:23:26Z'
  generated_at: "2026-04-24T08:02:20Z"
  model: gpt-5.4
  provider: openai
  source_hash: ce1ce4e8bd84ca8913dc30112fd2d7ec81782c1f84f62eb8cc5c1032e9b060da
  source_path: reference/AGENTS.default.md
  workflow: 15
---

# AGENTS.md - المساعد الشخصي لـ OpenClaw (الافتراضي)

## التشغيل الأول (موصى به)

يستخدم OpenClaw دليل مساحة عمل مخصصًا للوكيل. الافتراضي: `~/.openclaw/workspace` (قابل للتكوين عبر `agents.defaults.workspace`).

1. أنشئ مساحة العمل (إذا لم تكن موجودة بالفعل):

```bash
mkdir -p ~/.openclaw/workspace
```

2. انسخ قوالب مساحة العمل الافتراضية إلى مساحة العمل:

```bash
cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md
cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md
cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md
```

3. اختياري: إذا كنت تريد قائمة Skills الخاصة بالمساعد الشخصي، فاستبدل AGENTS.md بهذا الملف:

```bash
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
```

4. اختياري: اختر مساحة عمل مختلفة عبر ضبط `agents.defaults.workspace` (يدعم `~`):

```json5
{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}
```

## الإعدادات الأمنية الافتراضية

- لا تفرغ الأدلة أو الأسرار في الدردشة.
- لا تشغّل أوامر مدمرة إلا إذا طُلب منك ذلك صراحةً.
- لا ترسل ردودًا جزئية/متدفقة إلى أسطح المراسلة الخارجية (الردود النهائية فقط).

## بدء الجلسة (مطلوب)

- اقرأ `SOUL.md` و`USER.md` وملفات اليوم + الأمس في `memory/`.
- اقرأ `MEMORY.md` عند وجوده.
- افعل ذلك قبل الرد.

## الروح (مطلوب)

- يعرّف `SOUL.md` الهوية، والنبرة، والحدود. حافظ عليه محدثًا.
- إذا غيّرت `SOUL.md`، فأخبر المستخدم.
- أنت نسخة جديدة في كل جلسة؛ والاستمرارية تعيش في هذه الملفات.

## المساحات المشتركة (موصى بها)

- أنت لست صوت المستخدم؛ توخَّ الحذر في دردشات المجموعات أو القنوات العامة.
- لا تشارك البيانات الخاصة، أو معلومات التواصل، أو الملاحظات الداخلية.

## نظام الذاكرة (موصى به)

- السجل اليومي: `memory/YYYY-MM-DD.md` ‏(أنشئ `memory/` إذا لزم الأمر).
- الذاكرة طويلة الأمد: `MEMORY.md` للحقائق الدائمة، والتفضيلات، والقرارات.
- إن `memory.md` بأحرف صغيرة هو إدخال إصلاح قديم فقط؛ لا تحتفظ بملفي الجذر معًا عمدًا.
- عند بدء الجلسة، اقرأ اليوم + الأمس + `MEMORY.md` عند وجوده.
- التقط: القرارات، والتفضيلات، والقيود، والحلقات المفتوحة.
- تجنب الأسرار إلا إذا طُلب ذلك صراحةً.

## الأدوات وSkills

- تعيش الأدوات داخل Skills؛ اتبع `SKILL.md` الخاصة بكل Skill عند الحاجة إليها.
- احتفظ بالملاحظات الخاصة بالبيئة في `TOOLS.md` ‏(ملاحظات لـ Skills).

## نصيحة النسخ الاحتياطي (موصى بها)

إذا كنت تعامل مساحة العمل هذه على أنها “ذاكرة” Clawd، فاجعلها مستودع git (ويُفضّل أن يكون خاصًا) حتى يتم نسخ `AGENTS.md` وملفات ذاكرتك احتياطيًا.

```bash
cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# اختياري: أضف remote خاصًا + ادفع
```

## ما الذي يفعله OpenClaw

- يشغّل WhatsApp gateway + Pi coding agent بحيث يستطيع المساعد قراءة/كتابة الدردشات، وجلب السياق، وتشغيل Skills عبر Mac المضيف.
- يدير تطبيق macOS الأذونات (تسجيل الشاشة، والإشعارات، والميكروفون) ويكشف CLI باسم `openclaw` عبر الملف الثنائي المضمّن لديه.
- تُدمج الدردشات المباشرة في الجلسة `main` الخاصة بالوكيل افتراضيًا؛ بينما تبقى المجموعات معزولة على شكل `agent:<agentId>:<channel>:group:<id>` ‏(أما الغرف/القنوات فتكون: `agent:<agentId>:<channel>:channel:<id>`); وتحافظ Heartbeats على استمرار المهام في الخلفية.

## Skills الأساسية (فعّلها في Settings → Skills)

- **mcporter** — Runtime/CLI لخادم الأدوات لإدارة الواجهات الخلفية للمهارات الخارجية.
- **Peekaboo** — لقطات شاشة سريعة على macOS مع تحليل رؤية بالذكاء الاصطناعي اختياريًا.
- **camsnap** — التقاط إطارات، أو مقاطع، أو تنبيهات حركة من كاميرات RTSP/ONVIF الأمنية.
- **oracle** — CLI لوكيل جاهز لـ OpenAI مع إعادة تشغيل الجلسة والتحكم في المتصفح.
- **eightctl** — تحكم في نومك من الطرفية.
- **imsg** — إرسال، وقراءة، وبث iMessage وSMS.
- **wacli** — CLI لـ WhatsApp: مزامنة، وبحث، وإرسال.
- **discord** — إجراءات Discord: تفاعلات، وملصقات، واستطلاعات رأي. استخدم أهداف `user:<id>` أو `channel:<id>` ‏(المعرّفات الرقمية المجردة ملتبسة).
- **gog** — CLI لـ Google Suite: ‏Gmail، وCalendar، وDrive، وContacts.
- **spotify-player** — عميل Spotify طرفي للبحث/الإدراج في قائمة الانتظار/التحكم في التشغيل.
- **sag** — كلام ElevenLabs مع تجربة say بأسلوب mac؛ ويتم البث إلى مكبرات الصوت افتراضيًا.
- **Sonos CLI** — التحكم في مكبرات Sonos ‏(اكتشاف/حالة/تشغيل/مستوى الصوت/التجميع) من السكربتات.
- **blucli** — تشغيل، وتجميع، وأتمتة مشغلات BluOS من السكربتات.
- **OpenHue CLI** — التحكم في إضاءة Philips Hue للمشاهد والأتمتة.
- **OpenAI Whisper** — تحويل الكلام إلى نص محليًا للإملاء السريع وتفريغات البريد الصوتي.
- **Gemini CLI** — نماذج Google Gemini من الطرفية من أجل أسئلة وأجوبة سريعة.
- **agent-tools** — مجموعة أدوات خدمية للأتمتة والسكربتات المساعدة.

## ملاحظات الاستخدام

- فضّل استخدام CLI ‏`openclaw` في السكربتات؛ يتولى تطبيق mac الأذونات.
- شغّل التثبيتات من تبويب Skills؛ فهو يخفي الزر إذا كان الملف الثنائي موجودًا بالفعل.
- أبقِ Heartbeats مفعلة حتى يتمكن المساعد من جدولة التذكيرات، ومراقبة صناديق الوارد، وتشغيل لقطات الكاميرا.
- تعمل Canvas UI بملء الشاشة مع تراكبات أصلية. تجنب وضع عناصر تحكم حرجة في الحواف العلوية اليسرى/اليمنى أو السفلية؛ وأضف هوامش صريحة في التخطيط ولا تعتمد على safe-area insets.
- بالنسبة إلى التحقق المعتمد على المتصفح، استخدم `openclaw browser` ‏(tabs/status/screenshot) مع ملف Chrome الشخصي الذي يديره OpenClaw.
- بالنسبة إلى فحص DOM، استخدم `openclaw browser eval|query|dom|snapshot` ‏(واستخدم `--json`/`--out` عندما تحتاج إلى خرج آلي).
- بالنسبة إلى التفاعلات، استخدم `openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run` ‏(تتطلب click/type مراجع snapshot؛ واستخدم `evaluate` من أجل CSS selectors).

## ذو صلة

- [مساحة عمل الوكيل](/ar/concepts/agent-workspace)
- [Runtime الوكيل](/ar/concepts/agent)
