🛡️ TrustMyAgent

حارس أمن لوكلاء OpenClaw

الموقع • مركز الثقة • بداية سريعة • المساهمة

وكيل أمني مشابه لـ EDR لوكلاء OpenClaw. يقوم بتشغيل 41 فحصًا أمنيًا عبر 14 مجالًا، ويحسب درجة الثقة (0-100)، ويرسل القياسات عن بعد إلى لوحة Trust Center مركزية حيث يمكن للبشر والوكلاء الآخرين التحقق من الجدارة بالثقة.

عديم الحالة حسب التصميم - يعمل بالكامل في الذاكرة، لا يخزن أي شيء محليًا، لا يترك أي أثر على المضيف.

لماذا

وكلاء الذكاء الاصطناعي أقوياء ولكن غير شفافين. عندما يعمل وكيل على جهاز، كيف تعرف أنه لا:

• تسريب أسرار من متغيرات البيئة؟
• إنشاء عمليات مشبوهة؟
• الوصول إلى ملفات لا ينبغي؟
• التشغيل بصلاحيات مفرطة؟
• الاتصال بخدمات تسريب البيانات؟

يجيب TrustMyAgent على هذه الأسئلة كل 15 دقيقة وينشر النتائج إلى Trust Center عام حتى يتمكن أي شخص من التحقق من الوضع الأمني للوكيل.

بداية سريعة

كمهارة OpenClaw (موصى به)

انسخ إلى دليل مهارات مساحة العمل الخاصة بك:

# From your OpenClaw workspace
mkdir -p skills/trustmyagent
cp -r /path/to/trust-my-agent-ai/* skills/trustmyagent/

بعد التثبيت، اطلب من الوكيل تشغيل الإعداد:

"إعداد TrustMyAgent"

سيتبع الوكيل تعليمات الإعداد في SKILL.md لتثبيت التبعيات، وتشغيل تقييم اختباري، وإنشاء مهمة cron (*/15 * * * *) في تيار الجلسة agent:security:main. راجع SKILL.md للحصول على خطوات الإعداد الكاملة.

مستقل

# Run assessment and send telemetry (agent name from IDENTITY.md)
python3 run.py

المتطلبات

• Python 3.8+
• openssl (لفحوصات TLS)
• لا تبعيات pip - فقط المكتبة القياسية

المجالات الأمنية

تسجيل الثقة

• أي فشل حرج يحدد الدرجة عند 49 (غير موثوق)
• 3+ إخفاقات عالية الخطورة تحد الدرجة عند 69 (منخفض)

أنواع الفحوصات

فحوصات Bash (20) - أوامر شل تفحص بيئة المضيف. معرفة في checks/openclaw_checks.json.

حساسات Python/الرسائل (10) - فحوصات برمجية تحلل الأسرار، نصوص الجلسات، تكوينات MCP، بيانات المهارات، منشورات Moltbook، وسمعة المالك. معرفة في checks/message_checks.json.

فحوصات البنية التحتية لـ OpenClaw (11) - فحوصات Python لأمان تنفيذ العقد، معالجة الوسائط، البوابة، الهوية، والوكيل الفرعي. معرفة في checks/nodes_media_checks.json.

جميع أنواع الفحوصات تكتشف تلقائيًا macOS مقابل Linux وتستخدم أوامر مناسبة للنظام الأساسي.

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

┌─────────────────┐      POST /api/telemetry      ┌──────────────────┐
│   Agent Host     │  ─────────────────────────►   │ 🛡️ TrustMyAgent Server│
│                  │                                │  (Cloudflare)    │
│  run.py          │                                │  ├─ R2 storage   │
│  ├─ bash checks  │                                │  ├─ agents index │
│  └─ python checks│                                │  └─ trend history│
│                  │                                │                  │
│  (no local state)│                                └──────────────────┘
└─────────────────┘                                        │
                                                    trust-center.html
                                                    (public dashboard)

التهيئة

يتم قراءة اسم الوكيل تلقائيًا من ملف IDENTITY.md (قسم # Name). يتراجع إلى متغير البيئة OPENCLAW_AGENT_NAME، ثم "OpenClaw Agent".

كتابة فحوصات مخصصة

فحص Bash

أضف إلى checks/openclaw_checks.json:

{
  "check_id": "CUSTOM-001",
  "name": "My custom check",
  "description": "What this check verifies",
  "category": "integrity",
  "severity": "medium",
  "command": "echo 'SAFE'",
  "expected_output": "SAFE",
  "pass_condition": "contains"
}

فحص Python

أضف التعريف إلى checks/message_checks.json والمعالج إلى run.py:

@python_check("CUSTOM-002")
def check_something(check: dict) -> Tuple[bool, str]:
    # Return (passed: bool, message: str)
    return True, "Everything looks good"

المساهمة

راجع CONTRIBUTING.md للإرشادات. نرحب بـ:

• فحوصات أمنية جديدة لتهديدات ناشئة
• تحسينات دعم المنصات (Windows, ARM)
• التكامل مع أطر عمل إضافية للوكلاء
• تحسينات لوحة Trust Center

الترخيص

MIT - بنته Anecdotes AI لمنظومة OpenClaw.