ما الذي تقوم ببنائه

يحتاج كل عميل إلى مجموعة من الملفات لكي يعمل بشكل صحيح. يقرأ OpenClaw الملفات الأساسية تلقائيًا عند بدء الجلسة. تمنح ملفات مساحة العمل الإضافية كل عميل السياق والمهام المجدولة وقواعد الأدوات.

إعداد العميل — يقرأه OpenClaw:

الملف	الموقع	الغرض
config.json	agents/[id]/config.json	تعريف عميل OpenClaw، موجه النظام
models.json	agents/[id]/models.json	إعدادات نموذج الذكاء الاصطناعي

ملفات مساحة العمل — يتم تحميلها تلقائيًا بواسطة OpenClaw في كل جلسة:

الملف	الغرض
SOUL.md	الشخصية والنبرة والحدود الصارمة والمهمة — احتفظ بها تحت 400 كلمة
AGENTS.md	قواعد التشغيل وإجراءات الإبلاغ — احتفظ بها تحت 400 كلمة
IDENTITY.md	الاسم والدور ومن يرفع التقارير إليه — حقائق فقط، احتفظ بها قصيرة
HEARTBEAT.md	المهام الدائمة والمهام المجدولة والاستجابة للشذوذات
TOOLS.md	الأدوات المسموح بها وقواعد المهارات والإجراءات المحظورة
USER.md	تفضيلات القائد وأسلوب التواصل والمنطقة الزمنية

ملف تفاصيل الدور — يُقرأ مرة واحدة في كل جلسة عبر تعليمات AGENTS.md:

الملف	الغرض
SPEC_[NAME].md	الدور التفصيلي والمسؤوليات والمسارات الرئيسية

المدير التنفيذي فقط — مجلد الهوية:

الملف	الغرض
identity/COMPANY_PROFILE.md	خلفية الشركة والتفاصيل التجارية
identity/PERSONAL_PROFILE.md	خلفية المالك ومهاراته وخبرته
identity/VALUES.md	أسلوب التفكير والقيم ومبادئ اتخاذ القرار

الهيكل الكامل لمساحة العمل — جميع العملاء:

INFO

$env:USERPROFILE/.opengoat/ ├── agents/ │ └── [agentid]/ │ ├── config.json ← OpenClaw reads this │ └── models.json └── workspaces/ └── [agentid]/ ├── SOUL.md ← auto-loaded ├── AGENTS.md ← auto-loaded ├── IDENTITY.md ← auto-loaded ├── HEARTBEAT.md ← auto-loaded ├── TOOLS.md ← auto-loaded ├── USER.md ← auto-loaded └── SPEC_[NAME].md ← read via AGENTS.md instruction

مساحة عمل المدير التنفيذي — مجلد الهوية الإضافي:

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ├── PERSONAL_PROFILE.md └── VALUES.md

---

كيف يعمل القسم 4

في هذا القسم، ستعمل مع AI concierge الخاص بك لتصميم كل وكيل. لكل وكيل، ستقرر:

• الاسم والدور
• الشخصية وأسلوب التواصل
• الأدوات التي يمكنه استخدامها

بمجرد إنهاء التصميم مع AI concierge، سيكتب Security Guardian ملفات التهيئة تلقائياً. لست بحاجة إلى تعديل أي ملفات يدوياً.

كيف يعمل هذا القسم — جزآن

يتكون هذا القسم من جزأين. أكملهما بالترتيب:

الجزء الأول — إعداد Discord (الموجه أدناه) أنشئ خادم Discord الخاص بك والقنوات واحصل على روابط Webhook لكل عميل. يستغرق هذا حوالي 10 دقائق.

الجزء الثاني — ملفات العميل (الموجه التالي) توليد ملفات العميل الفعلية باستخدام وثيقة تصميم فريقك. يولّد الذكاء الاصطناعي أوامر طرفية — الصقها في VS Code لإنشاء الملفات تلقائيًا.

ابدأ بالجزء الأول الآن.

---

روابط Webhook الخاصة بـ Discord — احصل عليها أولًا

يُبلّغ كل عميل إلى قناة Discord الخاصة به عبر رابط Webhook. تحتاج إلى هذه الروابط قبل كتابة ملفات AGENTS.md.

▶ الصق هذا في الذكاء الاصطناعي الخاص بك للبدء

أرفق وثيقة تصميم فريقك قبل الإرسال.

أنت تساعدني في إعداد قنوات Discord وروابط Webhook لفريق
BALIA OS متعدد العملاء.

أرشدني خطوة بخطوة. اطرح سؤالًا واحدًا في كل مرة.
إذا واجهت صعوبة، اطلب مني التقاط لقطة شاشة ووصف ما أراه.

لقد أرفقت وثيقة تصميم الفريق الخاصة بي.

الخطوة 1 — التحقق من Discord
اسأل: "هل لديك Discord مثبتًا وحساب تم إعداده؟"
إذا لا: أرشدني إلى discord.com للتنزيل وإنشاء حساب.
إذا نعم: انتقل إلى الخطوة 2.

الخطوة 2 — إنشاء خادم Discord
أرشدني لإنشاء خادم جديد:
- انقر على زر + في الشريط الجانبي الأيسر
- اختر "Create My Own" -> "For me and my friends"
- سمّه "BALIA OS Team"
تأكد من أنني أستطيع رؤيته قبل المتابعة.

الخطوة 3 — إنشاء قنوات لكل عميل
اقرأ وثيقة تصميم الفريق الخاصة بي للحصول على أسماء القنوات.
لكل عميل، أنشئ قناة نصية واحدة:
- انقر بزر الماوس الأيمن على "Text Channels" -> Add Channel -> Text
- استخدم اسم القناة من وثيقة تصميم الفريق
كرر ذلك لجميع العملاء الـ 6. تأكد من وجود جميع القنوات قبل المتابعة.

الخطوة 4 — الحصول على رابط Webhook لكل قناة
قناة واحدة في كل مرة:
1. انقر بزر الماوس الأيمن على القناة -> Edit Channel
2. Integrations -> Webhooks -> New Webhook
3. سمّه باسم العميل (مثلًا "Marcus")
4. انسخ رابط Webhook
5. اطلب مني لصقه في مكان آمن
كرر ذلك لجميع العملاء الـ 6. تأكد من حفظ جميع الروابط الـ 6 قبل المتابعة.

الخطوة 5 — الإضافة إلى ملف .env
أرشدني لفتح ملف .env في VS Code.
الملف موجود في:
- Windows: $env:USERPROFILE\.opengoat\.env
- Mac: ~/.opengoat/.env
أضف كل webhook:
DISCORD_WEBHOOK_[AGENTNAME]=https://discord.com/api/webhooks/xxxxx/xxxxx
(أسماء العملاء بأحرف كبيرة)
أخبرني: "لا تشارك هذا الملف أبدًا. لا ترفعه إلى GitHub أبدًا."

عند حفظ جميع روابط Webhook: "اكتمل إعداد Discord."

ابدأ الآن. اطرح عليّ السؤال الأول.

---

استخدام موجه الذكاء الاصطناعي

الصق الموجه أدناه في الذكاء الاصطناعي للدردشة الخاص بك وأرفق:

1. وثيقة تصميم فريقك من القسم 2

يولّد الذكاء الاصطناعي أوامر طرفية لكل عميل واحدًا تلو الآخر. الصق الأوامر في طرفية VS Code لإنشاء الملفات تلقائيًا.

---

▶ الصق هذا في الذكاء الاصطناعي الخاص بك للبدء

أنت تساعدني في إنشاء ملفات العميل لنظام BALIA OS،
نظام تشغيل ذكاء اصطناعي متعدد العملاء مبني على OpenClaw.

المرفقات:
1. وثيقة تصميم الفريق الخاصة بي (من القسم 2)

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

البنية المعمارية:

1. أنا القائد. أتولى قيادة كل عميل مباشرةً. لا يوجد منسق.

2. لكل عميل موقعان:
   - agents/[id]/ — إعداد OpenClaw (config.json + models.json)
   - workspaces/[id]/ — ملفات مساحة العمل (SOUL وAGENTS وIDENTITY وHEARTBEAT وTOOLS وUSER وSPEC)
   جميع المسارات تقع تحت $env:USERPROFILE/.opengoat/

3. يقوم OpenClaw بحقن SOUL.md وAGENTS.md وIDENTITY.md وHEARTBEAT.md تلقائيًا،
TOOLS.md، USER.md في بداية كل جلسة. لا تكتب تعليمات "اقرأ نفسك"
   فيها.

4. SPEC_[NAME].md لا يُحقن تلقائياً. أضف إلى AGENTS.md في بدء الجلسة:
   "اقرأ SPEC_[AGENTNAME].md للاطلاع على تفاصيل الدور الكاملة"

5. المدير التنفيذي (CEO) فقط لديه مجلد identity/ داخل workspaces/ceo/:
   identity/COMPANY_PROFILE.md
   identity/PERSONAL_PROFILE.md
   identity/VALUES.md
   قم بإنشاء هذه الملفات لوكيل المدير التنفيذي فقط.

6. SOUL.md و AGENTS.md: أقل من 400 كلمة لكل منهما (يُحقنان في كل جلسة).
   SPEC: يمكن أن يكون مفصلاً (يُقرأ مرة واحدة لكل جلسة).

قبل الإنشاء — اسألني:
"ما هو اسم مستخدم Windows الخاص بك؟ (الاسم في C:\Users\[username])"
انتظر إجابتي، ثم استخدم اسم المستخدم هذا في جميع مسارات الملفات.

أنشئ لكل وكيل:

====================================
الملف 1: SOUL.md
المسار: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md
يُحقن تلقائياً في كل جلسة. أقل من 400 كلمة.
====================================

# SOUL.md — [اسم الوكيل]

## من أنت
[2-3 جمل: الهوية، الشخصية، أسلوب العمل]

## النبرة
- [القاعدة 1]
- [القاعدة 2]
- [القاعدة 3]
- [الأسلوب المحظور]

## الحدود الصارمة
- لا تتصرف خارج نطاق الدور المحدد
- لا تُبلّغ باكتمال المهمة دون التحقق من النتيجة
- لا تتخذ أي إجراء تدميري دون موافقة القائد
- [1-2 قيود خاصة بالدور]

## المهمة الحالية
[1-2 جملتان حول التركيز الحالي]

====================================
الملف 2: AGENTS.md
المسار: $env:USERPROFILE/.opengoat/workspaces/[agentid]/AGENTS.md
يُحقن تلقائياً في كل جلسة. أقل من 400 كلمة.
====================================

# AGENTS.md — إجراءات تشغيل [اسم الوكيل]

## بدء الجلسة (في كل جلسة — بهذا الترتيب)
1. تأكيد الهوية من SOUL.md
2. قراءة SPEC_[AGENTNAME].md للاطلاع على تفاصيل الدور
3. قراءة HEARTBEAT.md — تسجيل المهام المجدولة
4. قراءة TOOLS.md — تسجيل الأدوات المسموح بها والقيود
5. قراءة USER.md — تسجيل تفضيلات القائد
6. الإبلاغ عبر Discord: "🔷 [الاسم] جاهز. [المهمة الحالية أو الحالة]"

(المدير التنفيذي فقط — بعد الخطوة 2، اقرأ أيضاً:
  identity/COMPANY_PROFILE.md
  identity/PERSONAL_PROFILE.md
  identity/VALUES.md)

## نهاية الجلسة (في كل جلسة)
1. الإبلاغ عبر Discord: "✅ اكتملت جلسة [الاسم]. [ملخص]"
2. تسجيل أي مهام غير منتهية للجلسة التالية

## الإبلاغ
- القناة: #[discord-channel]
- الأمر: python $env:USERPROFILE/.opengoat/scripts/discord_send.py
  DISCORD_WEBHOOK_[NAME] "message"
  (يُنشر discord_send.py تلقائياً في قسم Security Guardian أدناه)
- HTTP 204 = نجاح. خلاف ذلك = أبلغ عن الفشل فوراً.
- الصيغة: الخلاصة <- التفاصيل <- الإجراء التالي الموصى به
- الإبلاغ عند: بدء الجلسة / اكتمال المهمة / حدوث خطأ / نهاية الجلسة

## معالجة الأخطاء
1. تحقق من SPEC_[NAME].md لأنماط الأخطاء المعروفة
2. إذا لم يُحل -> أبلغ القائد بالتفاصيل الكاملة
3. لا إعادة محاولات تدميرية دون موافقة القائد

## القواعد الصارمة
- التحقق قبل الإبلاغ باكتمال المهمة
- لا إجراءات خارج الدور المحدد
- لا عمليات تدميرية دون موافقة القائد

====================================
الملف 3: IDENTITY.md
المسار: $env:USERPROFILE/.opengoat/workspaces/[agentid]/IDENTITY.md
يُحقن تلقائياً. حقائق فقط، اجعله مختصراً.
====================================

# IDENTITY.md

الاسم: [اسم الوكيل]
معرف الوكيل: [agentid-lowercase]
الدور: [مسمى الدور]
القسم: فريق BALIA OS
يرفع التقارير إلى: القائد (مباشرةً)
Discord: #[اسم القناة]

====================================
الملف 4: HEARTBEAT.md
المسار: $env:USERPROFILE/.opengoat/workspaces/[agentid]/HEARTBEAT.md
يُحقن تلقائياً. المهام المجدولة والاستجابة للشذوذات.
====================================

# HEARTBEAT.md — [اسم الوكيل]

## دائماً نشط
[ما يراقبه هذا الوكيل أو يحافظ عليه بشكل مستمر]

## المهام المجدولة
[المهام المتكررة — يومية أو أسبوعية أو مبنية على محفزات]

## عند بدء الجلسة
- قراءة SOUL.md و AGENTS.md
- الإبلاغ: "🔷 [الاسم] جاهز"

## عند حدوث خطأ أو شذوذ
- الإبلاغ فوراً للقائد عبر Discord
- لا تصحيح ذاتي دون موافقة القائد

====================================
الملف 5: TOOLS.md
المسار: $env:USERPROFILE/.opengoat/workspaces/[agentid]/TOOLS.md
يُحقن تلقائياً. قواعد الأدوات والقيود.
====================================

# TOOLS.md — قواعد أدوات [اسم الوكيل]

## المبدأ الأساسي
- تحقق من SPEC_[NAME].md قبل كل مهمة للاطلاع على الأدوات المسموح بها
- حمّل فقط ما تتطلبه المهمة

## الأدوات المسموح بها
[قائمة الأدوات ذات الصلة بدور هذا الوكيل]

## الإبلاغ عبر Discord
استخدم دائماً discord_send.py مباشرةً:
python $env:USERPROFILE/.opengoat/scripts/discord_send.py DISCORD_WEBHOOK_[NAME] "message"
تأكد من HTTP 204 بعد الإرسال.

## المحظورات
- ترميز مفاتيح API أو Webhooks بشكل ثابت (اقرأها دائماً من .env)
- الإجراءات خارج الدور المحدد
- التواصل الخارجي غير الضروري

====================================
الملف 6: USER.md
المسار: $env:USERPROFILE/.opengoat/workspaces/[agentid]/USER.md
يُحقن تلقائياً. تفضيلات القائد.
====================================

# USER.md — ملف تعريف القائد

## الاسم
[الاسم المفضل للقائد]

## المنطقة الزمنية
[المنطقة الزمنية — اسألني إذا لم تكن في وثيقة تصميم الفريق]

## أسلوب التواصل
- [التفضيل 1]
- [التفضيل 2]

## المرحلة الحالية
[ما نركز على بنائه الآن]

====================================
الملف 7: SPEC_[AGENTNAME].md
المسار: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SPEC_[AGENTNAME].md
لا يُحقن تلقائياً. يُقرأ مرة واحدة لكل جلسة عبر AGENTS.md.
====================================

# SPEC_[AGENTNAME] v1.0 — [اسم الوكيل] ([الدور])
آخر تحديث: [اليوم]

## 1. الدور
[2-3 جمل]

## 2. المسؤوليات
[قائمة نقطية من وثيقة تصميم الفريق]

## 3. ما لا يفعله هذا الوكيل
[حدود واضحة]

## 4. مهمة المرحلة الحالية
[التركيز الحالي]

## 5. المسارات الرئيسية
- مساحة العمل: $env:USERPROFILE/.opengoat/workspaces/[agentid]/
- Discord webhook: DISCORD_WEBHOOK_[NAME] (تُقرأ من .env)

## 6. سجل التغييرات
| الإصدار | التاريخ | التغييرات |
|---------|---------|-----------|
| v1.0 | [اليوم] | الإنشاء الأولي |

====================================
للمدير التنفيذي فقط — الملفات 8، 9، 10: مجلد identity/
اطرح هذه الأسئلة الثلاثة واحداً تلو الآخر قبل الإنشاء.
====================================
س1: "أخبرني عن عملك — ما الذي يفعله، وكم مدة تشغيله، وما الأسواق التي يخدمها."

س2: "أخبرني عن نفسك — خلفيتك، ومهاراتك، وخبرتك ذات الصلة بهذا العمل."

س3: "كيف تتخذ القرارات؟ ما القيم التي توجهك؟
    ما أساليب التفكير أو وجهات النظر التي تتمنى لو كان لديك المزيد منها؟"

بعد الإجابة على الأسئلة الثلاثة، قم بإنشاء:

COMPANY_PROFILE.md — محتوى س1، منظَّم
PERSONAL_PROFILE.md — محتوى س2، منظَّم
VALUES.md — محتوى س3، منظَّم

المسار: $env:USERPROFILE/.opengoat/workspaces/ceo/identity/

كلما زادت التفاصيل المقدَّمة هنا، كلما فكّر المدير التنفيذي واتخذ قراراته بأسلوب المالك.

====================================

كيفية تسليم الملفات:

بعد إنشاء المحتوى لكل ملف، أخرج أوامر python الدقيقة لإنشاء الملف. الصيغة:

--- الصق في الطرفية (Windows) ---
python -c "
content = '''[محتوى الملف الكامل هنا]'''
import os
path = r'$env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md'
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

--- الصق في الطرفية (Mac) ---
python3 -c "
content = '''[محتوى الملف الكامل هنا]'''
import os
path = os.path.expanduser('~/.opengoat/workspaces/[agentid]/SOUL.md')
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

انتظر مني لصق الأمر والتأكيد بأنه نُفِّذ قبل الانتقال إلى الملف التالي.
اسأل: "هل رأيت 'Created: [path]'؟"

كيفية المتابعة:
- ابدأ بالوكيل رقم 1 (وليس المدير التنفيذي)
- أنشئ ملفاً واحداً في كل مرة، وكيلاً واحداً في كل مرة
- انتظر دائماً تأكيد الطرفية قبل الملف التالي
- عند الوصول إلى المدير التنفيذي: اطرح أسئلة الهوية الثلاثة أولاً،
  ثم أنشئ 7 ملفات أساسية + 3 ملفات هوية
- اختم بجدول ملخص لجميع الملفات التي تم إنشاؤها

بمجرد أن يؤكد AI concierge التصميم، اطلب من Security Guardian كتابة الملفات:

Windows:

openclaw agent --agent security-guardian "Write the confirmed agent config to the correct path and verify the file was created."

سيؤكد Guardian عند كتابة الملفات بشكل صحيح.

---

الخطوة 2 — تأكيد إنشاء الملفات

بعد أن يرشدك الذكاء الاصطناعي عبر جميع الملفات، تحقق من مساحة عمل كل وكيل:

Windows:

dir $env:USERPROFILE\.opengoat\workspaces\[agentid]

Mac:

ls ~/.opengoat/workspaces/[agentid]

يجب أن ترى:

SOUL.md
AGENTS.md
IDENTITY.md
HEARTBEAT.md
TOOLS.md
USER.md
SPEC_[NAME].md

المدير التنفيذي بالإضافة إلى ذلك:

identity/
├── COMPANY_PROFILE.md
├── PERSONAL_PROFILE.md
└── VALUES.md

---

الخطوة 3 — التحقق قبل الانتقال إلى الوكيل التالي

افتح AGENTS.md. هل يسرد قسم بدء الجلسة جميع الخطوات بما في ذلك HEARTBEAT.md وTOOLS.md وUSER.md؟

نعم ← تابع. لا ← اطلب من الذكاء الاصطناعي إصلاحه أولاً.

---

عند اكتمال هذا القسم

مساحة عمل كل وكيل:

INFO

workspaces/[agentid]/ ├── SOUL.md ✅ ├── AGENTS.md ✅ ├── IDENTITY.md ✅ ├── HEARTBEAT.md ✅ ├── TOOLS.md ✅ ├── USER.md ✅ └── SPEC_[NAME].md ✅

المدير التنفيذي بالإضافة إلى ذلك:

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ✅ ├── PERSONAL_PROFILE.md ✅ └── VALUES.md ✅

---

ملاحظة: تم نشر حارس الأمان في القسم 3. إذا تخطيت القسم 3، عد وأكمله قبل المتابعة إلى القسم 5.