🦞 ClawGuard v3

مجموعة أدوات أمان الذكاء الاصطناعي للمؤسسات - دفاع نشط مدفوع بـ SKILL.md

المفهوم الأساسي

الدفاع الأساسي لـ ClawGuard v3 ليس في الكود، بل في SKILL.md!

كل ملف SKILL.md في كل وحدة هو بحد ذاته دليل دفاع كامل:

• يخبر الوكيل متى يتم التشغيل
• يوجه الوكيل كيفية الكشف
• يوفر أنماط وقواعد كشف محددة
• يحدد صيغة الإخراج ومعايير القرار

البرامج النصية هي مجرد أدوات مساعدة؛ الذكاء الحقيقي يكمن في SKILL.md.

🎯 وحدات الأمان الخمس

إجمالي التوثيق: 2,714 سطرًا (الإصدار v2 يحتوي على 2,226 سطرًا مع 3 وحدات فقط)

📂 هيكل الوحدة

تحتوي كل وحدة على:

auditor-skill/
├── SKILL.md      ← دليل الدفاع الأساسي (الأهم!)
├── _meta.json    ← البيانات الوصفية
├── cli.js        ← أداة CLI المساعدة
└── src/          ← وحدات الكود المساعدة

محتويات SKILL.md الأساسية

يتضمن كل SKILL.md:

1. متى يتم التشغيل - متى يجب على الوكيل استخدام هذه الوحدة
2. كيفية التنفيذ - خطوات الكشف التفصيلية وسير العمل
3. مكتبة أنماط الكشف - قواعد مطابقة regex وأنماط محددة
4. معايير القرار - كيفية إخراج النتائج ومستويات المخاطر
5. أمثلة - حالات استخدام فعلية

🚀 بدء سريع

الاستخدام عبر الوكيل (موصى به)

أخبر الوكيل بما تريد القيام به، وسيقرأ SKILL.md وينفذ:

User: Help me audit this skill: /workspace/skills/weather-tool
        ↓
Agent reads auditor-skill/SKILL.md
        ↓
Agent executes audit according to SKILL.md guidelines
        ↓
Output audit results

الاستخدام عبر CLI

# Audit Skill
cd auditor-skill && node cli.js /path/to/skill

# Check Configuration
cd checker-skill && node cli.js ~/.openclaw/openclaw.json

# Detect Threats
cd detect-skill && node cli.js --monitor

# Runtime Guardian
cd guardian-skill && node cli.js start

# Detect Injection
cd shield-skill && node cli.js defend "test text"

📋 تفاصيل الوحدات

Auditor - تدقيق ما قبل التثبيت (679 سطرًا)

سيناريوهات التشغيل: قبل تثبيت Skill جديد

الميزات الأساسية في SKILL.md:

• كشف مخاطر تنفيذ الأوامر (أكثر من 100 نمط)
• كشف مخاطر الوصول إلى الملفات
• كشف مخاطر طلبات الشبكة
• كشف انحراف النية (جديد في v3)
• فحص كتل كود SKILL.md (جديد في v3)
• تحليل أمان سلسلة التوريد
• ربط MITRE ATT&CK

مخرجات القرار:

🟢 آمن → يمكن التثبيت
🟡 يحتاج مراجعة → يمكن التثبيت بعد التأكيد
🔴 عالي الخطورة → لا يُنصح بالتثبيت

Checker - فحص الإعدادات (476 سطرًا)

سيناريوهات التشغيل: فحص أمان الإعدادات

الميزات الأساسية في SKILL.md:

• فحص إعدادات البوابة
• فحص إعدادات تنفيذ الأدوات
• فحص إعدادات العزل (Sandbox)
• فحص أمان الشبكة
• توصيات التقوية (جديد في v3)
• إصلاح بنقرة واحدة (جديد في v3)

مخرجات القرار:

⚠️ تم العثور على مشكلات + توصيات إصلاح محددة + تقوية بنقرة واحدة

Detect - كشف التهديدات (615 سطرًا)

سيناريوهات التشغيل: المراقبة في الوقت الفعلي وفحص التهديدات

الميزات الأساسية في SKILL.md:

• كشف تهديدات تنفيذ الأوامر
• كشف تهديدات عمليات الملفات
• كشف تهديدات الشبكة
• كشف حقن الأوامر
• تحليل ارتباط سلسلة الهجمات
• تكامل Guardian (جديد في v3)

مخرجات القرار:

🔴 حرج → إجراء فوري مطلوب
🟠 عالي → طلب تأكيد
🟡 متوسط → تسجيل وتحذير

Guardian - الحارس وقت التشغيل (451 سطرًا)

سيناريوهات التشغيل: عندما تكون مراقبة السلوك مطلوبة

الميزات الأساسية في SKILL.md:

• مراقبة السلوك في الوقت الفعلي
• اعتراض العمليات الخطرة
• إعادة تشغيل جلسة التدقيق
• تجميد الطوارئ (جديد في v3)
• الحفاظ على الأدلة (جديد في v3)
• محرك القواعد (جديد في v3)

القواعد الأساسية:

Deny: /etc/*, /root/*, /.ssh/*
Confirm: rm -rf, chmod 777, killall
Log: All operations

Shield - الدرع النشط (493 سطرًا)

سيناريوهات التشغيل: فحص أمان إدخال المستخدم

الميزات الأساسية في SKILL.md:

• كشف حقن ترميز Base64 (جديد في v3)
• كشف ترميز Hex/Unicode (جديد في v3)
• كشف الأحرف صفرية العرض (جديد في v3)
• كشف اختطاف الأدوار
• كشف هجمات كسر القيود (Jailbreak)
• كشف اختطاف سلسلة التعليمات (جديد في v3)
• التحقق من النية (جديد في v3)

سير عمل الكشف:

Encoding → Hijacking → Jailbreak → Chain Hijacking → Intent Drift

🔍 كشف انحراف النية (الميزة الأساسية في v3)

ما هو انحراف النية؟

عدم تطابق الوظيفة المعلنة للـ Skill مع السلوك الفعلي:

طريقة الكشف

1. استخراج الوظيفة المعلنة من SKILL.md
2. تحليل السلوك الفعلي في الكود
3. المقارنة للتحقق من التطابق
4. وضع علامة عالية الخطورة في حالة عدم التطابق

📁 هيكل المشروع

ClawGuardv3/
├── auditor-skill/           # تدقيق ما قبل التثبيت (679 سطرًا SKILL.md)
│   ├── SKILL.md          # ⭐ دليل الدفاع الأساسي
│   ├── _meta.json
│   ├── cli.js
│   └── src/
│       ├── auditor.js
│       ├── sast-analyzer.js
│       ├── intent-drift-detector.js
│       └── supply-chain-analyzer.js
├── checker-skill/           # فحص الإعدادات (476 سطرًا SKILL.md)
│   ├── SKILL.md          # ⭐ دليل الدفاع الأساسي
│   ├── _meta.json
│   ├── cli.js
│   └── src/
│       └── checker.js
├── detect-skill/            # كشف التهديدات (615 سطرًا SKILL.md)
│   ├── SKILL.md          # ⭐ دليل الدفاع الأساسي
│   ├── _meta.json
│   ├── cli.js
│   └── src/
│       └── detector.js
├── guardian-skill/           # الحارس وقت التشغيل (451 سطرًا SKILL.md)
│   ├── SKILL.md          # ⭐ دليل الدفاع الأساسي
│   ├── _meta.json
│   ├── cli.js
│   └── src/
│       └── guardian.js
├── shield-skill/            # الدرع النشط (493 سطرًا SKILL.md)
│   ├── SKILL.md          # ⭐ دليل الدفاع الأساسي
│   ├── _meta.json
│   ├── cli.js
│   └── src/
│       └── shield.js
└── shared/
    └── rules/
        └── interceptor-rules.js

🆚 مقارنة v2 مع v3

مقارنة الوحدات

📄 الترخيص

MIT License

الإصدار: v3.0.0 آخر تحديث: 2026-03-21