هيكل مجلد .opengoat عند اكتمال هذا القسم

تُبنى هذه المجلدات تدريجياً على مدار الأقسام من 1 إلى 8. لا تقلق إن بدا المجلد فارغاً الآن — يضيف كل قسم الملفات التي تحتاجها.

📁 هيكل مجلد .opengoat الكامل

$env:USERPROFILE\.opengoat\          ← الدليل الرئيسي لـ BALIA OS
├── identity\                         ← أُنشئ في القسم 2
│   └── team_design.md               ← وثيقة تصميم الفريق
├── .env                              ← يُنشأ في القسم 3 (مفاتيح API وWebhooks)
├── workspaces\                       ← يُنشأ في القسم 3
│   ├── [agentid]\                    ← يُنشأ لكل وكيل في القسم 4
│   │   ├── SOUL.md
│   │   ├── AGENTS.md
│   │   ├── IDENTITY.md
│   │   ├── HEARTBEAT.md
│   │   ├── TOOLS.md
│   │   ├── USER.md
│   │   └── SPEC_[الاسم].md
│   └── security-guardian\            ← يُنشر تلقائياً في القسم 3
├── agents\                           ← ملفات إعداد OpenClaw، تُولَّد تلقائياً في القسم 5
│   └── [agentid]
│       ├── config.json
│       └── models.json
├── memory\                           ← يُنشأ في القسم 6
│   └── _SKILL_STATUS.md             ← قائمة تفعيل/تعطيل الكاسيتات (المصدر الوحيد الموثوق)
└── skills\                           ← الكاسيتات المُضافة في القسم 6
    └── [اسم-الكاسيت]\
        └── SKILL.md

هذا المجلد هو "بيت" BALIA OS. جميع هويات الوكلاء وذاكرتهم ومهاراتهم مُخزَّنة هنا.

---

💡 ما هو الـ API؟ — ولماذا تحتاجه؟

فكّر في وكلاء الذكاء الاصطناعي لديك كموظفين يحتاجون إلى التفكير قبل التصرف.

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

Chat AI مقابل API — شيئان مختلفان:

	Chat AI (Claude / Gemini / ChatGPT)	API
ما هو	مساعدك الشخصي	محرك تفكير وكلائك
من يستخدمه	أنت، مباشرةً	وكلاؤك، تلقائيًا
نموذج التكلفة	اشتراك (سعر ثابت)	الدفع حسب الاستخدام (رموز الإدخال + الإخراج)
الموصى به	الخطة المدفوعة — استدلال أفضل	ابدأ بـ $5 رصيد

لماذا تُشغّل كليهما؟ (الإعداد الهجين)

يعمل فوترة الـ API على أساس رموز الإدخال + الإخراج — كل كلمة تُرسل إلى الوكيل وكل كلمة يردّ بها تكلّف مبلغًا صغيرًا.

وهذا يعني أن طريقة إعطاء تعليماتك لوكلائك مهمة جدًا.

استخدم Chat AI الخاص بك (الذكاء الاصطناعي للدردشة الخاص بك — يُوصى بالخطة المدفوعة لاستدلال أفضل) من أجل:

• صياغة تعليمات واضحة وموجزة قبل إرسالها إلى الوكلاء
• تلخيص المستندات الطويلة قبل تمريرها إلى الوكلاء
• هيكلة المهام مسبقًا حتى لا يضيع الوكلاء الرموز في محاولة فهم ما تريد

تعليمات منظّمة من 200 رمز تكلّف جزءًا بسيطًا مقارنةً بمحادثة مبهمة من 2,000 رمز ذهابًا وإيابًا. Chat AI الخاص بك هو المخطط الاستراتيجي. ووكلاؤك هم المنفّذون. هذا التوليف يُبقي تكاليف الـ API منخفضة مع الحفاظ على جودة المخرجات عالية.

قبل أن تبدأ — الشفافية في تكلفة الـ API

يتطلب BALIA OS مفتاح AI API لتشغيل وكلائك. وهذا مستقل عن تكلفة الدليل البالغة $48.

ما تحتاجه:

• حساب Anthropic مع رصيد مدفوع مسبقًا لا يقل عن $5
• جميع الوكلاء في هذا الدليل يستخدمون Claude Sonnet 5

لماذا يكفي $5 للبدء: يُكلّف Claude Sonnet 5 مليون رمز إدخال بـ $2 ومليون رمز إخراج بـ $10 (سعر إطلاق ساري حتى 31 أغسطس 2026؛ بعد ذلك التاريخ يرتفع إلى $3 للإدخال و$15 للإخراج). تستخدم جلسة الوكيل النموذجية بضعة آلاف من الرموز. يمنحك الـ $5 عشرات الجلسات للتعلم والتجربة قبل الإنفاق أكثر.

لا توجد طبقة مجانية لـ Anthropic API. يُشترط وجود بطاقة ائتمان. أضف الرصيد من: console.anthropic.com ← Billing ← Add credits (الحد الأدنى $5)

هذه هي التكلفة الخارجية الوحيدة المطلوبة لتشغيل BALIA OS. للتوضيح: توظيف مساعد بشري يكلّف $2,000–$5,000 شهريًا. فريق الذكاء الاصطناعي الخاص بك يعمل بـ $5 من رصيد API للبدء. نفس العمل. بجزء يسير من التكلفة.

---

ما الذي ستقوم بتثبيته

بنهاية هذا القسم ستكون لديك خمسة أشياء جاهزة:

• VS Code — مساحة عملك لتحرير ملفات الوكيل وتشغيل الأوامر
• Claude Code — المنفّذ الذي يُؤتمت تصحيح الأخطاء وتحرير الملفات داخل VS Code ضمن التشغيل الهجين (راجع القسم 1). إذا كنت مشتركاً في Claude Pro فما فوق، فلا حاجة لأي اشتراك إضافي
• Node.js — مطلوب لتشغيل OpenClaw وClaude Code
• OpenClaw — إطار عمل وكيل الذكاء الاصطناعي الذي يُشغّل BALIA OS
• Anthropic API key — محرك الذكاء الاصطناعي الذي يستخدمه وكلاؤك للتفكير
• حارس الأمان — مساعد الإعداد الآلي الذي يدير الملفات ويتحقق من تكوينك

كيف يعمل هذا القسم: انسخ الموجّه أدناه والصقه في الذكاء الاصطناعي للدردشة الخاص بك. سيرشدك الذكاء الاصطناعي خلال عملية التثبيت بأكملها — بسؤالك عن نظام التشغيل لديك، وإرشادك خلال كل خطوة، ومساعدتك في إصلاح أي خطأ يظهر. إذا واجهت أي عقبة في أي وقت، فما عليك إلا وصف المشكلة للذكاء الاصطناعي وسيساعدك على تجاوزها.

---

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

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

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

إليك كل ما نحتاج إلى تثبيته وإعداده، بالترتيب:

الخطوة 1 — التحقق من نظام التشغيل
اسألني: "هل أنت على Windows أم Mac؟"
ثم أعطني التعليمات الصحيحة لنظام التشغيل خلال جميع الخطوات.

الخطوة 2 — تثبيت VS Code
أرشدني لتثبيت VS Code من code.visualstudio.com
- Windows: قم بتنزيل وتشغيل المثبت. تأكد من تحديد "Add to PATH".
- Mac: قم بالتنزيل، وفك الضغط، وسحب التطبيق إلى Applications، ثم نفّذ الأمر
  لإضافة "code" إلى PATH: Cmd+Shift+P → "Shell Command: Install 'code' command in PATH"
بعد التثبيت، اطلب مني فتح طرفية في VS Code وتشغيل:
  code --version
اسألني عما يظهر. إذا كان هناك خطأ، ساعدني في إصلاحه.

الخطوة 2ب — تغيير لغة عرض VS Code (اختياري)
اشرح لي أن VS Code يعرض بالإنجليزية افتراضياً. إذا رغبتُ في استخدامه بالعربية،
أخبرني بصراحة أنه لا تتوفر حالياً حزمة لغة عربية رسمية من Microsoft لـ VS Code.
بعد توضيح ذلك، اطلب مني تخطي هذه الخطوة والانتقال مباشرة إلى الخطوة التالية.

الخطوة 3 — تثبيت Python
في طرفية VS Code، اطلب من المستخدم تشغيل:
  python --version
إذا ظهر "Python 3.x.x"، فإن Python مثبت بالفعل. انتقل إلى الخطوة التالية.

إذا لم يكن كذلك، أخبره بالتثبيت من https://www.python.org/downloads/
- Windows: شغّل المثبت. تأكد من تحديد "Add Python to PATH".
- Mac: شغّل المثبت واتبع الإعدادات الافتراضية.

بعد التثبيت، أعد تشغيل VS Code وشغّل python --version مرة أخرى للتأكيد.

الخطوة 4 — تثبيت Node.js
أرشدني لتثبيت Node.js 22 أو أعلى من nodejs.org (إصدار LTS).
بعد التثبيت، اطلب مني تشغيل: node --version
اسألني عما يظهر.
- إذا كان v22 أو أعلى: ممتاز، تابع.
- إذا كان أقل من v22: أرشدني للترقية باستخدام nvm (Mac/Linux)
  أو nvm-windows (Windows).
- في حالة وجود خطأ: ساعدني في استكشاف الأخطاء وإصلاحها.

الخطوة 5 — تثبيت OpenClaw
أرشدني لتشغيل الأمر التالي في طرفية VS Code:
  npm install -g openclaw
ثم التحقق:
  openclaw --version
الأخطاء الشائعة التي يجب معالجتها:
- EACCES على Mac: أرشد خلال إصلاح npm global prefix
- "openclaw not found": اطلب مني إغلاق الطرفية وإعادة فتحها، ثم حاول مرة أخرى

الخطوة 5ب — تثبيت Claude Code
اشرح هذا أولاً:
"Claude Code هو المنفّذ الفعلي للتشغيل الهجين الذي قدّمناه في القسم 1.
يقرأ الأخطاء داخل VS Code، ويصل إلى حد تعديل الملفات وتشغيل الأوامر.
إذا كنت مشتركاً بالفعل في خطة Claude Pro أو أعلى ($20/شهر فما فوق)، فلا حاجة لأي اشتراك إضافي —
محادثة claude.ai وClaude Code يتشاركان نفس الاشتراك ونفس حدود الاستخدام.
إذا اخترتَ Claude Pro كذكاء اصطناعي للدردشة في القسم 1، يمكنك تسجيل الدخول بنفس الحساب مباشرة.
أما إذا كنت تستخدم ذكاءً اصطناعياً آخر للدردشة (مثل ChatGPT أو Gemini)،
فستحتاج إلى اشتراك منفصل في Claude Pro أو أعلى، أو إلى وصول عبر Anthropic API لاستخدام Claude Code."

ثم أرشدني إلى:
1. تشغيل الأمر التالي في طرفية VS Code لتثبيت الـ CLI:
     npm install -g @anthropic-ai/claude-code
2. التحقق من التثبيت:
     claude --version
   تأكد من ظهور رقم إصدار
3. في لوحة الإضافات في VS Code (Ctrl+Shift+X)، ابحث عن "Claude Code" (الناشر: Anthropic) وثبّته
4. في طرفية VS Code، شغّل الأمر التالي لتسجيل الدخول لأول مرة:
     claude
   سيُفتح المتصفح — أرشدني لتسجيل الدخول بحساب Claude Pro (أو مفتاح API)
5. بعد اكتمال تسجيل الدخول، تأكد من ظهور موجّه الأوامر مجدداً في الطرفية

الأخطاء الشائعة التي يجب معالجتها:
- EACCES عند npm install (خطأ صلاحيات، Mac/Linux):
    mkdir -p ~/.npm-global
    npm config set prefix ~/.npm-global
    export PATH=~/.npm-global/bin:$PATH
  نفّذها بالترتيب ثم أعد المحاولة
- "claude: command not found": اطلب مني إغلاق الطرفية وإعادة فتحها، ثم حاول مرة أخرى
- إذا لم تُفتح شاشة تسجيل الدخول: تحقق من وجود اشتراك/وصول API صالح على console.anthropic.com

الخطوة 6 — الحصول على مفتاح Anthropic API
اشرح هذا أولاً:
"يستخدم BALIA OS Claude (Anthropic) كمحرك ذكاء اصطناعي افتراضي لوكلائك.
في الوقت الحالي نقوم بإعداد Claude فقط. يمكن إضافة محركات ذكاء اصطناعي أخرى لاحقاً
حسب ما تريد بناءه:
- عند إنشاء مهارتك الخاصة (القسم 6)، ستختار أفضل ذكاء اصطناعي
  لتلك المهارة — على سبيل المثال، Gemini لـ YouTube لأنه يمكنه تحليل
  الفيديو مباشرة، أو GPT-4o لنصوص المبيعات.
- بعد افتتاح BALIA Skill Market، يمكنك أيضاً تثبيت المهارات التي أنشأها
  مستخدمون آخرون، ولكل منها محرك ذكاء اصطناعي موصى به."

ثم أرشدني إلى:
1. الذهاب إلى console.anthropic.com
2. التسجيل أو تسجيل الدخول
3. الذهاب إلى API Keys → Create Key
4. تسميتها "balia-os"
5. انسخ المفتاح (يبدأ بـ sk-ant-)
أخبرني: "احفظ هذا في مكان آمن — يمكنك رؤيته مرة واحدة فقط."
اطلب مني تأكيد أن لدي المفتاح قبل المتابعة.
لا تطلب مني لصق المفتاح في المحادثة.

الخطوة 7 — تشغيل إعداد OpenClaw
أرشدني لتشغيل الأمر التالي في طرفية VS Code:
  openclaw setup
أخبرني بما يجب توقعه:
- سيطلب مفتاح Anthropic API الخاص بي — الصقه هناك
- سيقوم تلقائياً بإنشاء المجلد ~/.opengoat/ (Mac) أو
  $env:USERPROFILE\.opengoat\ (Windows)
  هذا هو الدليل الرئيسي لـ BALIA OS — جميع ملفات الوكلاء تعيش هنا.
بعد اكتمال الإعداد، أرشدني لتشغيل هذا الأمر لبدء البوابة:
  Windows: $env:DEBUG="-ciao*"; openclaw gateway --force
  Mac:     DEBUG="-ciao*" openclaw gateway --force
اطلب مني تأكيد أنني أرى:
  "✓ Gateway running on port 18789"
أخبرني: "اترك علامة التبويب هذه مفتوحة — إنها البوابة. افتح علامة تبويب جديدة للأوامر المستقبلية."

ثم اطلب مني تأكيد إنشاء المجلد:
- Windows: dir $env:USERPROFILE\.opengoat
- Mac:     ls ~/.opengoat
اسألني: "هل ترى مجلد .opengoat؟"
إذا لم يكن كذلك، ساعدني في استكشاف الأخطاء وإصلاحها.

الخطوة 9 — إنشاء ملف .env
أرشدني لإنشاء ملف .env داخل مجلد .opengoat.
- Windows: في VS Code، افتح المجلد $env:USERPROFILE\.opengoat
           انقر بزر الماوس الأيمن في اللوحة اليسرى ← ملف جديد ← سمّه .env
- Mac:     في VS Code، افتح المجلد ~/.opengoat
           انقر بزر الماوس الأيمن في اللوحة اليسرى ← ملف جديد ← سمّه .env

ثم الصق هذا النموذج:

# BALIA OS
BALIA_TOKEN=paste-your-token-here
AGENT_ID=ceo

# Anthropic API
ANTHROPIC_API_KEY=sk-ant-paste-your-key-here

# Agent model
CLAUDE_MODEL=claude-sonnet-5

# Discord Webhooks — fill these in during Section 4
# Example: DISCORD_WEBHOOK_MAYA=https://discord.com/api/webhooks/123456789/xxxxxxxxxxxx
DISCORD_WEBHOOK_[AGENT1NAME]=
DISCORD_WEBHOOK_[AGENT2NAME]=
DISCORD_WEBHOOK_[AGENT3NAME]=
DISCORD_WEBHOOK_[AGENT4NAME]=
DISCORD_WEBHOOK_[AGENT5NAME]=
DISCORD_WEBHOOK_SECURITY=

املأ BALIA_TOKEN:
"تحقق من البريد الإلكتروني الذي تلقيته بعد الشراء.
سطر الموضوع يقول 'Your BALIA OS Access Token'.
انسخ الرمز المميز (يبدأ بـ BALIA-) والصقه بعد BALIA_TOKEN=
هذه المرة الوحيدة التي تحتاج فيها لإدخاله —
يقرأه المثبّت في القسم 6 تلقائياً من هذا الملف.
لا تلصقه في هذه المحادثة."

املأ AGENT_ID:
"هذا هو معرف وكيل الرئيس التنفيذي — الوكيل الرئيسي الذي تتحدث إليه أكثر.
المعرف ثابت: ceo. اترك AGENT_ID=ceo تماماً كما يظهر أعلاه.
لا تغيّره. تعتمد نصوص التثبيت والقسم 4 كلاهما على هذه القيمة."

أخبرني: "اترك خطافات Discord فارغة الآن — ستحصل على عناوين URL الفعلية في القسم 4.
تبدو صيغة URL هكذا: https://discord.com/api/webhooks/numbers/letters
استبدل [AGENT1NAME] حتى [AGENT5NAME] بأسماء وكلائك بالأحرف الكبيرة.
DISCORD_WEBHOOK_SECURITY دائماً في الأخير — وهو لوكيل حارس الأمان."

ملاحظة أمنية — قل هذا:
"إذا كنت غير مرتاح لوضع رمزك المميز في ملف:
يمكنك تخطي BALIA_TOKEN الآن وإدخاله يدوياً
عند المطالبة أثناء تثبيت القسم 6."

أخبرني: "لا تشارك هذا الملف أبداً. لا تضغه في GitHub أبداً."

الخطوة 9ب — كتابة مفتاح API في ملف .env
ملاحظة: تم إدخال مفتاح API بالفعل في الخطوة 7 (openclaw setup). اشرح لماذا يحتاج هنا أيضاً.
قل: "أنت تضع نفس مفتاح API في مكانين:
- يخزّنه openclaw setup داخل تكوين OpenClaw الخاص.
- يخزّنه ملف .env لوكلاء BALIA OS — يقرأ الوكلاء مفتاحهم من .env مباشرة.
يجب أن يكون لكليهما نفس المفتاح. هذا إعداد لمرة واحدة."
أرشدني إلى:
1. فتح ملف .env في VS Code (يوجد في مجلد .opengoat)
2. إيجاد السطر: ANTHROPIC_API_KEY=sk-ant-paste-your-key-here
3. استبدال "sk-ant-paste-your-key-here" بمفتاحي الفعلي
4. حفظ الملف (Ctrl+S على Windows / Cmd+S على Mac)
تأكيد: "مفتاح API الخاص بك محفوظ الآن في ملف .env.
لا تشارك هذا الملف أبداً أو تضغه في GitHub."
لا تطلب مني لصق المفتاح في المحادثة.

عندما تنهي الخطوة 9ب، قل لي: "بيئتك جاهزة. سنقوم الآن بإعداد حارس الأمان — مساعد الإعداد الآلي الخاص بك."

ابدأ الآن. اسألني السؤال الأول.

🛡️ إعداد حارس الأمان أولاً

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

---

🛡️ نشر حارس الأمان

⚠️ تحذير: تجاوز تكاليف API

[حادثة حقيقية في الخارج — لا صلة لها بـ BALIA OS] في نوفمبر 2025، دخل وكيل ذكاء اصطناعي في فريق تطوير خارجي في حلقة لا نهاية لها واستمر في العمل لمدة 11 يومًا دون أن يلاحظ أحد، مما أدى إلى فاتورة API بقيمة $47,000. (المصدر: Tech Startups / Hacker News)

يمكن لوكلاء الذكاء الاصطناعي الاستمرار في استدعاء APIs دون أن يدرك المستخدم ذلك. لمنع هذا الخطر، يراقب Security Guardian التكاليف على مدار الساعة ويرسل تنبيهًا فوريًا على Discord عند اكتشاف أي شذوذ.

احرص دائمًا على ضبط الإعدادات التالية أيضًا:

1. اضبط تنبيه التكاليف في لوحة تحكم مزود الذكاء الاصطناعي (موصى به: $3–5/يوم) (لمستخدمي Anthropic) → https://console.anthropic.com/settings/billing
2. تحقق من إعدادات مراقبة التكاليف في Security Guardian (الخطوة 2.5)

بيئتك جاهزة الآن.

يوجد وكيل واحد إضافي في BALIA OS: حارس الأمان (security-guardian).

هذا الوكيل مُهيّأ مسبقاً من قِبل BALIA. لا تُغيّر اسمه أو معرّفه أو مساراته. فعل ذلك سيُعطّل التكامل مع بقية وكلائك.

---

المتطلب الأساسي: تثبيت PM2

PM2 هو مدير عمليات Node.js. يبقي Security Guardian يعمل تلقائياً، حتى بعد إعادة تشغيل الكمبيوتر.

افتح طرفية VS Code والصق الأمر التالي للتثبيت:

npm install -g pm2

تجاوز هذه الخطوة إذا كان PM2 مثبتاً بالفعل.

---

تنزيل المثبّت وتشغيله

💡 ما هو الرمز المميز (Token)؟

هو السلسلة النصية التي تأتي بعد ?token= في رابط الوصول المُرسَل إليك بعد الشراء.

مثال: https://guide.baliaos.com/?token=BALIA-XXXX-XXXX-0001 في هذه الحالة، الرمز المميز هو BALIA-XXXX-XXXX-0001.

إذا لم تتمكن من إيجاد البريد الإلكتروني، يرجى التواصل مع الدعم الفني.

الخطوة 1 — تنزيل المثبّت

في طرفية VS Code لديك:

Windows:

Invoke-WebRequest -Uri "https://balia-os-guide.vercel.app/scripts/install_core_pack.py" -OutFile install_core_pack.py
python install_core_pack.py

Mac / Linux:

curl -o install_core_pack.py https://balia-os-guide.vercel.app/scripts/install_core_pack.py
python3 install_core_pack.py

الخطوة 2 — تسجيل حارس الأمان في OpenClaw

Windows:

openclaw agents add security-guardian --workspace $env:USERPROFILE\.opengoat\workspaces\security-guardian

Mac:

openclaw agents add security-guardian --workspace ~/.opengoat/workspaces/security-guardian

هذا يُسجّل security-guardian بحيث يستطيع OpenClaw توجيه الأوامر إليه.

الخطوة 2.5 — تحقق من التسجيل

تأكد من أن OpenClaw يمكنه رؤية الوكيل:

openclaw agents list

يجب أن ترى security-guardian في القائمة. إذا لم يظهر، أعد الخطوة 2.

---

📋 دليل تخصيص guardian_config.json

يمكن تغيير الإعدادات التالية في أي وقت. موقع الملف:

$env:USERPROFILE\.opengoat\workspaces\security-guardian\guardian_config.json

المفتاح	الافتراضي	الوصف
cost.alertHourly	1.0	تنبيه تكلفة API بالساعة ($)
cost.alertDaily	5.0	تنبيه تكلفة API اليومي ($)
rollback.threshold	6	عدد الملفات المفقودة قبل تفعيل الاستعادة
rollback.autoRecovery	true	استعادة تلقائية (false = موافقة يدوية)
snapshot.intervalMinutes	10	تكرار النسخ الاحتياطي (بالدقائق)
snapshot.maxSnapshots	3	عدد النسخ الاحتياطية المحتفظ بها
watchdog.checkGateway	true	مراقبة بوابة OpenClaw
watchdog.checkWSL2	false	مراقبة WSL2 (معطّل افتراضيًا)
scanner.runIntervalHours	4	تكرار فحص العزل (بالساعات)
git.autoPushEnabled	true	نسخ احتياطي تلقائي إلى GitHub
git.autoPushIntervalMinutes	30	تكرار النسخ الاحتياطي (بالدقائق)

بعد تغيير الإعدادات، أعِد تشغيل Security Guardian:

pm2 restart security-guardian

---

الخطوة 3 — اجعل حارس الأمان يُشغّل المثبّت

openclaw agent --agent security-guardian "Run: python install_core_pack.py --lang ar (token loads from .env automatically). Tell me when done."

تتم قراءة الرمز المميز تلقائياً من BALIA_TOKEN في ملف .env لديك.

سيقوم وكيلك تلقائياً بما يلي:

1. مصادقة رمزك المميز
2. تنزيل ملفات حارس الأمان
3. النشر في .opengoat/agents/security-guardian/ و.opengoat/workspaces/security-guardian/
4. إظهار "✓ Security Guardian deployed successfully" في الطرفية

⚠️ مهم: لا تُغيّر معرّف حارس الأمان أو اسمه أو مسارات مجلداته. تشير ملفات إعداد أخرى إلى هذا الوكيل مباشرةً. تغييرها سيُعطّل نظام حجر المهارات.

عندما تُظهر الطرفية "✓ Security Guardian deployed successfully"، تابع إلى الخطوة التالية أدناه.

INFO

الفرق بين agents/security-guardian/ وworkspaces/[agentid]/

يستخدم BALIA OS نوعين من المجلدات لكل وكيل:

• agents/[id]/ — ملفات إعداد OpenClaw (config.json، models.json) — يقرأها OpenClaw لتشغيل الوكيل
• workspaces/[id]/ — ملفات مساحة العمل (SOUL، AGENTS، IDENTITY، HEARTBEAT، TOOLS، USER، SPEC) — يقرأها الوكيل عند بدء الجلسة

يستخدم حارس الأمان كلا النوعين:

• agents/security-guardian/ — config.json وmodels.json
• workspaces/security-guardian/ — SOUL.md وSPEC_SECURITY.md وscripts/ وغيرها

تستخدم وكلاؤك المخصصون نفس البنية. كلا المجلدين يقعان تحت $env:USERPROFILE/.opengoat/.

---

الخطوة 3.5 — إيقاف بوابة gateway وتشغيل Guardian عبر PM2 ثم إعادة التشغيل

بعد اكتمال التثبيت، أعد تشغيل بوابة gateway بأمان.

① إيقاف بوابة gateway

في نافذة PowerShell التي تعمل فيها openclaw gateway، اضغط:

Ctrl + C

إذا سُئلت "هل تريد الإنهاء؟"، اضغط Y ثم Enter.

② تشغيل Security Guardian عبر PM2

افتح نافذة PowerShell جديدة ونفّذ الأوامر التالية سطراً بسطر:

pm2 start $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\security_guardian.js --name security-guardian

pm2 start $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\watchdog.js --name guardian-watchdog

pm2 save

pm2 list

تأكد من أن security-guardian و guardian-watchdog تظهران بحالة online.

③ إعادة تشغيل بوابة gateway

في نفس نافذة PowerShell، نفّذ الأوامر التالية سطراً بسطر:

$env:DEBUG="-ciao*"

openclaw gateway --force

لا تغلق نافذة PowerShell هذه.

---

▶ متابعة: الصق هذا في الذكاء الاصطناعي الخاص بك

حارس الأمان يعمل الآن. لنقم بإنشاء مجلدات workspace وإكمال الإعداد.

الخطوة 8 — إنشاء مجلدات مساحة العمل لكل وكيل
أخبرني: "سأقرأ وثيقة تصميم فريقك من القسم 2 للحصول على
معرفات وكلائك تلقائياً. يرجى إرفاقها الآن."
اقرأ وثيقة تصميم الفريق المرفقة.
استخرج جميع أسماء/معرفات الوكلاء الـ 6 (حوّلها إلى أحرف صغيرة، بدون مسافات، استخدم الشرطات للمسافات).
أظهر لي القائمة:
"وجدت هؤلاء الوكلاء الـ 6: [id1]، [id2]، [id3]، [id4]، [id5]، [id6]
هل هذا صحيح؟"
انتظر تأكيدي.

ثم أعطني الأوامر الدقيقة لإنشاء جميع مجلدات مساحة العمل الـ 6 دفعة واحدة
مع المعرفات الفعلية مملوءة بالفعل.
استخدم هذا الهيكل للمجلدات: workspaces\[id]\ (وليس workspace-[id]).
- Windows: cd $env:USERPROFILE\.opengoat
           mkdir workspaces\[id1] workspaces\[id2] workspaces\[id3] workspaces\[id4] workspaces\[id5] workspaces\[id6]
- Mac:     cd ~/.opengoat
           mkdir -p workspaces/[id1] workspaces/[id2] workspaces/[id3] workspaces/[id4] workspaces/[id5] workspaces/[id6]

بعد التشغيل، اطلب مني تأكيد إنشاء المجلدات:
- Windows: dir $env:USERPROFILE\.opengoat\workspaces
- Mac:     ls ~/.opengoat/workspaces

الخطوة 10 — الفحص النهائي
اعمل معي على هذه القائمة بنداً واحداً في كل مرة:
□ code --version ← يُظهر رقم إصدار
□ node --version ← يُظهر v22 أو أعلى
□ openclaw --version ← يُظهر رقم إصدار
□ claude --version ← يُظهر رقم إصدار
□ إضافة Claude Code مثبّتة في VS Code وتسجيل الدخول مكتمل
□ طرفية البوابة تُظهر "✓ Gateway running"
□ مجلد .opengoat موجود ومؤكد
□ مجلدات فرعية workspaces/ مُنشأة لجميع الوكلاء الـ 6
□ ملف .env موجود في مجلد .opengoat
□ BALIA_TOKEN مملوء (أو مُلاحَظ للإدخال يدوياً في القسم 6)
□ AGENT_ID مضبوط على ceo
□ ANTHROPIC_API_KEY مملوء
□ تم نشر حارس الأمان (تأكيد عبر مخرجات الطرفية)

عندما تُحدَّد جميع المربعات، قل:
"اكتمل التثبيت. أنت مستعد للقسم 4 —
إنشاء ملفات وكلائك."

ابدأ بـ الخطوة 8. اطلب مني إرفاق وثيقة تصميم الفريق.

---

🛡️ مراجعة Security Guardian

سيقوم Security Guardian الخاص بك الآن بفحص الإعداد بالكامل وإصلاح أي مشكلات تلقائياً.

ما يتحقق منه Guardian:

• وجود جميع المجلدات المطلوبة في $env:USERPROFILE\\.opengoat\\
• أن جميع الملفات المطلوبة في موضعها الصحيح
• يتم نقل الملفات في المكان الخاطئ تلقائياً
• يتم إنشاء الملفات المفقودة تلقائياً (فارغة — ستملأها في القسم 4)

ما لا يغيره Guardian بعد:

• محتوى الملفات (شخصيات الوكلاء والإعدادات تأتي في القسم 4)

شغّل المراجعة:

Windows:

node $env:USERPROFILE\\.opengoat\\workspaces\\security-guardian\\scripts\\verify_setup.js --fix

سيُبلّغ Guardian عما وجده وأصلحه. إذا كان كل شيء أخضر، فأنت جاهز للقسم 4.