ما الذي يحدث في هذا القسم
ستقوم بتسجيل كل وكيل مع OpenClaw وإعطائه أمره الأول. بنهاية هذا القسم، سيكون جميع الوكلاء الـ 6 في حالة عمل — يُبلّغون عبر قنوات Discord الخاصة بهم ومستعدون لاستقبال تعليماتك.
طريقتان للتواصل مع وكلاؤك:
| الطريقة | الأنسب لـ | كيف تعمل |
|---|---|---|
| OpenGoat UI | المبتدئون — واجهة مرئية | لوحة تحكم عبر المتصفح، انقر لتحديد الوكيل، واكتب رسالتك |
| VS Code terminal | موصى به — أسرع وأكثر تحكماً | openclaw agent --agent [id] "your message" |
كلتا الطريقتين تعملان. ابدأ بأيهما يبدو لك مريحاً.
النهج الموصى به — هجين مع الذكاء الاصطناعي: عندما تبدأ للتو، احتفظ بمحادثة الذكاء الاصطناعي للدردشة الخاص بك مفتوحة جنباً إلى جنب مع وكلاؤك. إذا لم يعمل أمر ما أو لم تكن متأكداً مما تكتب، فقط صف الوضع للذكاء الاصطناعي واطلب المساعدة. هذا بالضبط كيف أدار معظم الناس — بما في ذلك فريق BALIA OS — الأمور في البداية. لا تحتاج إلى إتقان الطرفية في اليوم الأول. نافذة محادثة الذكاء الاصطناعي متاحة دائماً كمساعدك.
كيف يعمل هذا القسم
الصق الأمر أدناه في الذكاء الاصطناعي للدردشة الخاص بك. سيرشدك الذكاء الاصطناعي خلال تسجيل جميع الوكلاء الـ 6 وإرسال أمرك الأول لكل منهم. أرفق وثيقة تصميم الفريق حتى يعرف الذكاء الاصطناعي معرّفات وكلاؤك ومسارات مساحة العمل.
إذا حدث خطأ ما، صف المشكلة أو التقط لقطة شاشة وشاركها — سيساعدك الذكاء الاصطناعي في إصلاحها.
▶ الصق هذا في الذكاء الاصطناعي للبدء
أرفق وثيقة تصميم الفريق قبل الإرسال.
أنت تساعدني في تسجيل وإطلاق فريق BALIA OS متعدد الوكلاء الخاص بي
على OpenClaw.
لقد أرفقت وثيقة تصميم الفريق. اقرأها للحصول على معرّفات وكلائي
وأسمائهم قبل البدء.
قبل أن نبدأ، اسألني:
"ما هو اسم مستخدم Windows الخاص بك؟ (الاسم في C:\Users\[username])"
استخدم هذا الاسم في جميع مسارات الملفات طوال هذه الجلسة.
جميع ملفات وكلائي موجودة تحت $env:USERPROFILE/.opengoat/
أرشدني خطوة بخطوة. خطوة واحدة في كل مرة. إذا واجهت خطأ،
ساعدني في إصلاحه قبل المتابعة. إذا تعثرت، اطلب مني مشاركة
لقطة شاشة أو لصق رسالة الخطأ.
إليك ما نحتاج إلى القيام به:
الخطوة 1 — تشغيل البوابة
أخبرني: "سنبدأ بوابة OpenClaw بأمر يُصفّي
السجلات الصاخبة في الخلفية حتى تظل الطرفية قابلة للقراءة."
أرشدني لفتح تبويب طرفية VS Code جديد وتشغيل الأمر الصحيح
لنظام التشغيل الخاص بي (اسألني عن نظام التشغيل إذا لم تعرف بعد):
Windows:
$env:DEBUG="-ciao*"; openclaw gateway --force
Mac:
DEBUG="-ciao*" openclaw gateway --force
اشرح ما يفعله هذا:
"الجزء DEBUG='-ciao*' يُخفي سجلات اكتشاف الشبكة في الخلفية التي
ستفيض الطرفية بخلاف ذلك. علم --force يمسح أي نسخة سابقة من البوابة.
ستظل طرفيتك نظيفة وقابلة للقراءة."
اطلب مني تأكيد أنني أرى: "✓ Gateway running on port 18789"
أخبرني بترك هذا التبويب الطرفي مفتوحاً — يجب أن تستمر البوابة في العمل.
إذا كان هناك خطأ، ساعدني في إصلاحه قبل المتابعة.
الخطوة 2 — تسجيل كل وكيل مع OpenClaw
لكل من وكلائي الـ 6 (اقرأ المعرّفات من وثيقة تصميم الفريق)،
أرشدني لتشغيل هذا الأمر في طرفية VS Code:
Windows:
openclaw agents add [agentid] --workspace $env:USERPROFILE\.opengoat\workspaces\[agentid]
Mac:
openclaw agents add [agentid] --workspace ~/.opengoat/workspaces/[agentid]
مثال (Windows): openclaw agents add marcus --workspace C:\Users\john\.opengoat\workspaces\marcus
(marcus مثال — استبدله بمعرّفات وكلائك الفعلية من وثيقة تصميم الفريق.)
أظهر لي جميع الأوامر الـ 6 دفعة واحدة مع معرّفات وكلائي الفعلية واسم المستخدم.
اطلب مني تشغيلها واحداً تلو الآخر وتأكيد نجاح كل منها قبل
الانتقال إلى التالي.
بعد تسجيل جميع الـ 6، أرشدني للتحقق:
openclaw agents list
اطلب مني تأكيد ظهور جميع الوكلاء الـ 6 في القائمة.
الخطوة 2ب — التحقق من تسجيل حارس الأمان
تم تسجيل حارس الأمان مع OpenClaw بالفعل في القسم 4.
أرشدني للتحقق من وجوده:
openclaw agents list
اطلب مني تأكيد ظهور security-guardian في القائمة.
إذا كان غائباً، أرشدني لتشغيل:
Windows:
openclaw agents add security-guardian --workspace $env:USERPROFILE\.opengoat\workspaces\security-guardian
Mac:
openclaw agents add security-guardian --workspace ~/.opengoat/workspaces/security-guardian
ثم تحقق من القائمة مرة أخرى قبل المتابعة.
الخطوة 3 — إعادة تشغيل البوابة
بعد تسجيل الوكلاء، تحتاج البوابة إلى إعادة التشغيل لتحميلهم.
أرشدني لتشغيل:
openclaw gateway restart
اطلب مني تأكيد أن البوابة تعمل مرة أخرى قبل المتابعة.
الخطوة 4 — تشغيل حارس الأمان (PM2)
يعمل حارس الأمان باستمرار في الخلفية باستخدام PM2.
أرشدني لتشغيله:
pm2 start $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\guardian.js --name security-guardian
(Mac: استبدل المسار بـ ~/.opengoat/workspaces/security-guardian/scripts/guardian.js)
ثم احفظ قائمة عمليات PM2 حتى تُعاد تلقائياً عند إعادة التشغيل:
pm2 save
اطلب مني تأكيد رؤية حارس الأمان في قائمة PM2:
pm2 list
ثم اطلب مني تأكيد رؤية رسالة بدء التشغيل في قناة Discord #security-channel.
الخطوة 5 — إرسال أول أمر عبر طرفية VS Code (موصى به)
اشرح هذا أولاً:
"طرفية VS Code هي الطريقة الموصى بها للتحدث إلى وكلاؤك.
الأمر هو:
openclaw agent --agent [agentid] 'رسالتك هنا'
هذا يرسل رسالة مباشرة إلى ذلك الوكيل المحدد."
أرشدني لإرسال أمر اختبار إلى الوكيل الأول:
openclaw agent --agent [first-agentid] 'من فضلك قدّم نفسك وأكد
أنك قرأت SOUL.md وAGENTS.md وIDENTITY.md وHEARTBEAT.md
وTOOLS.md وUSER.md.
ثم أبلغ في قناة Discord الخاصة بك أنك متصل بالإنترنت.'
اسألني: "ماذا ردّ الوكيل؟
هل رأيت رسالة تظهر في قناة Discord الخاصة به؟"
إذا نعم: رائع — انتقل إلى الوكيل التالي.
إذا لا: ساعدني في استكشاف الأخطاء وإصلاحها.كرر الخطوات مع جميع الوكلاء الستة.
الخطوة 6 — (اختياري) إعداد واجهة OpenGoat UI بعد التأكد من عمل جميع الوكلاء عبر الطرفية، اعرض ما يلي: "يمكنك أيضاً التحدث إلى وكلائك من خلال واجهة OpenGoat UI — لوحة تحكم بصرية في المتصفح. هل تود إعدادها أيضاً؟ تمنحك واجهة قابلة للنقر لاختيار الوكلاء وإرسال الرسائل دون الحاجة إلى كتابة أوامر في الطرفية." في حال الموافقة: أرشدني إلى:
- فتح تبويب طرفية جديد في VS Code
- تشغيل: opengoat start
- سيفتح المتصفح تلقائياً مع واجهة OpenGoat UI أرشدني خلال الواجهة — كيفية اختيار وكيل وإرسال رسالة. (إذا لم يفتح المتصفح تلقائياً، انتقل إلى http://localhost:19123) في حال الرفض: تخطَّ هذه الخطوة وانتقل إلى الخطوة 7.
الخطوة 7 — التأكيد النهائي راجع معي قائمة التحقق التالية: □ تسجيل جميع الوكلاء الستة (يعرض openclaw agents list جميع الستة) □ تسجيل Security Guardian (يظهر security-guardian في القائمة) □ تشغيل Security Guardian في PM2 (يُظهر pm2 list حالته online) □ تشغيل البوابة (المنفذ 18789) □ استجاب كل وكيل للأمر الأول □ نشر كل وكيل في قناة Discord الخاصة به □ (اختياري) واجهة OpenGoat UI متاحة على localhost:19123
الخطوة 8 — إنشاء CLAUDE.md بعد التأكد من تسجيل جميع الوكلاء الستة (بما في ذلك Security Guardian) وعملهم، أرشدني لإنشاء CLAUDE.md — ملف التعليمات الذي تتم قراءته تلقائياً بواسطة Claude Code في VS Code في بداية كل جلسة:
"الآن دعنا ننشئ ملف CLAUDE.md الخاص بك. سيتم إنشاؤه تلقائياً بناءً على إعداد فريقك المكتمل بالفعل، ولا تحتاج إلى ملء أي شيء يدوياً."
Windows: cd $env:USERPROFILE.opengoat\workspaces\security-guardian node generate_claude_md.js
Mac: cd ~/.opengoat/workspaces/security-guardian node generate_claude_md.js
اطلب مني تأكيد أنني أرى رسالة تنتهي تقريباً بهذا الشكل: [OK] CLAUDE.md generated: (مسارك).opengoat\CLAUDE.md
إذا كان CLAUDE.md موجوداً بالفعل، فسيقوم النص البرمجي تلقائياً بعمل نسخة احتياطية أولاً، ثم يسأل عما إذا كان سيتم الكتابة فوقه. "yes" تعني الكتابة فوقه (النسخة الاحتياطية تمت بالفعل)؛ "no" تعني أن المحتوى الجديد سيُحفظ باسم CLAUDE_generated_draft.md، بينما يبقى CLAUDE.md الحالي دون أي تغيير على الإطلاق.
إذا سُئلت عن المستوى الذي تم شراؤه (T1 / T2 / T3)، أرشدني لإدخال المستوى الفعلي الذي تم شراؤه.
بعد الإنشاء، اطلب مني فتح $env:USERPROFILE.opengoat\CLAUDE.md للتأكد من عرض اسم الفريق والأدوار بشكل صحيح.
عند تحديد جميع المربعات، قل: "فريق BALIA OS الخاص بك يعمل الآن. جميع الوكلاء الستة يعملون ويرسلون تقاريرهم إلى Discord. أنت جاهز للقسم 6 — بناء مهارتك الأولى."
ابدأ الآن. اسألني السؤال الأول.
حول CLAUDE.md
CLAUDE.md هو ملف تتم قراءته تلقائياً في كل مرة تبدأ فيها جلسة Claude Code. يُخبر هذا الملف فريق الذكاء الاصطناعي الخاص بك بهيكل الفريق وقواعد الأمان وسياق المشروع، حتى لا تضطر لشرحها مرة أخرى في كل جلسة.
يتضمن تلقائياً:
- تكوين الفريق (أسماء وأدوار الوكلاء)
- الحظر المطلق للعمليات المدمرة (يتطلب نسخاً احتياطياً قبل حذف/الكتابة فوق الملفات)
- قواعد التعامل مع المعلومات الحساسة (مفاتيح API، عناوين URL الخاصة بـ webhook لا يجب عرضها كنص عادي)
- إعداد لغة الإخراج
يمكنك تخصيص الأقسام الموجودة أسفل هذا الملف بحرية: أضف قواعد خاصة بالمشروع، أوامر تستخدمها بكثرة، اصطلاحات البرمجة، إلخ.
لا تحذف أو تعدل أبداً: قسمي "الحظر المطلق للعمليات المدمرة (حرج — اتبع دائماً — لا تحذف)" و"التعامل مع المعلومات الحساسة (لا تحذف)". يتم عرض هذين القسمين بلغتك المختارة (متوفر بـ 20 لغة). يشكل هذان القسمان أساس أمان فريقك.
إذا كان CLAUDE.md موجوداً بالفعل: قبل الكتابة فوقه، سيقوم النص البرمجي generate_claude_md.js بنسخ الملف الحالي احتياطياً إلى مجلد 99_Backups\ مع طابع زمني (مثل CLAUDE.md_20260705_143000.bak). بهذه الطريقة لن تفقد أبداً القواعد التي قمت بتخصيصها — يمكنك نسخ الأجزاء اللازمة من النسخة الاحتياطية إلى الملف الجديد يدوياً.
التحدث إلى وكلائك يومياً
بعد اكتمال الإعداد، إليك طريقة إصدار الأوامر:
تشغيل البوابة (افعل هذا أولاً في كل جلسة):
Windows:
$env:DEBUG="-ciao*"; openclaw gateway --forceMac:
DEBUG="-ciao*" openclaw gateway --forceاترك تبويب الطرفية هذا يعمل. افتح تبويباً جديداً للأوامر الأخرى.
عبر طرفية VS Code:
# التحدث إلى وكيل محدد
openclaw agent --agent marcus "Summarize what you worked on today"
# التحقق من قائمة الوكلاء
openclaw agents list
# إعادة تشغيل البوابة عند الحاجة
openclaw gateway restart
marcusمثال فقط — استبدله بمعرّف وكيلك الخاص (مثلاً--agent ceoأو--agent nova).
عبر واجهة OpenGoat UI:
- افتح تبويب طرفية جديد في VS Code
- شغّل:
opengoat start - يفتح المتصفح تلقائياً مع واجهة OpenGoat UI
- اختر الوكيل من اللوحة اليسرى
- اكتب رسالتك واضغط Enter (إذا لم يفتح المتصفح تلقائياً: انتقل إلى http://localhost:19123)
عبر Discord (للتقارير فقط — ليس للأوامر): Discord هو المكان الذي ينشر فيه وكلاؤك تقاريرهم. يمكنك قراءة تحديثاتهم هنا. إرسال الأوامر إلى الوكلاء عبر Discord يتطلب Discord Bot — وهذا إعداد متقدم غير مشمول في T1. استخدم طرفية VS Code أو واجهة OpenGoat UI لإصدار الأوامر في الوقت الحالي.
إذا لم يستجب وكيل
تحقق من هذه النقاط بالترتيب:
هل البوابة تعمل؟
openclaw gateway restartهل الوكيل مسجّل؟
openclaw agents listإذا لم يكن وكيلك مدرجاً، أعد تشغيل أمر
agents addمن الخطوة 2.هل ملفات مساحة العمل في المكان الصحيح؟
تأكد من وجود SOUL.md وAGENTS.md وIDENTITY.md في:
Windows:
$env:USERPROFILE\.opengoat\workspaces\[agentid]\Mac:
~/.opengoat/workspaces/[agentid]/هل مفتاح API مُعيَّن بشكل صحيح؟ افتح
.env(في مجلد.opengoatالخاص بك) وتأكد من ملءANTHROPIC_API_KEY.
إذا كنت لا تزال عالقاً، الصق رسالة الخطأ في الذكاء الاصطناعي للدردشة الخاص بك واطلب المساعدة.
التحقق من إعدادك
بعد التأكد من عمل جميع الوكلاء، شغّل:
Windows:
node $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\verify_setup.js --section 5Mac:
node ~/.opengoat/workspaces/security-guardian/scripts/verify_setup.js --section 5يؤكد هذا تسجيل جميع الوكلاء الستة، وعمل Security Guardian، واستعدادك للقسم 6.