defenseclaw v0.8.9
حوكمة الأمن للذكاء الاصطناعي الفاعل
____ ____ ____ _
/ __ \ ___ / __/___ ___ ___ ___ / ___|| | __ _ __ __
/ / / / / _ \/ /_// _ \ / _ \ / __|/ _ \| | | |/ _` |\ \ /\ / /
/ /_/ / / __/ __// __/| | | |\__ \ __/| |___ | | (_| | \ V V /
/_____/ \___/_/ \___/ |_| |_||___/\___| \____||_|\__,_| \_/\_/
DefenseClaw
حوكمة أمنية لـ OpenClaw وبيئات تشغيل الذكاء الاصطناعي الوكيلية.
افحص القدرات قبل استخدامها، وراقب حركة المرور أثناء التشغيل، وصدّر أدلة تدقيق دائمة.
يجمع DefenseClaw بين واجهة سطر أوامر للمشغّل مكتوبة بلغة Python، وبوابة مكتوبة بلغة Go، وخطافات الموصلات، والسياسات، والماسحات الضوئية، ومصدّرات المراقبة. وهو طبقة إنفاذ وأدلة؛ ولا يثبت أن وكيلاً أو تفاعلاً مع نموذج أو قدرة طرف ثالث خالية من المخاطر.
التوثيق
يُعد موقع توثيق DefenseClaw المصدر الموثوق للتثبيت والإعداد والتهيئة والأوامر وسير عمل المشغّل:
| الموضوع | الدليل المعتمد |
|---|---|
| التثبيت | تثبيت DefenseClaw |
| التشغيل الأول | البدء السريع |
| الترقية | الترقية |
| Windows | Windows الأصلي |
| الموصلات | توافق الموصلات |
| الحواجز الوقائية | إعداد الحواجز الوقائية |
| التهيئة | مرجع التهيئة |
| CLI | مرجع CLI |
| المراقبة | المراقبة |
تقتصر ملفات Markdown في المستودع على إرشادات المساهمين، وعقود التنفيذ، والملاحظات المحلية للحزم، ومراجع المخططات المُولّدة، وبيانات الاختبار، وسجلات التصميم التاريخية. ابدأ من docs/README.md.
تطوير المصدر
أهداف المصدر هي أدوات للمساهمين. وهي ليست مسار تثبيت أو ترقية لمضيف مُدار عبر الإصدارات؛ استخدم أدلة الموقع أعلاه لتلك المهام. عقود سلسلة الأدوات المُدرجة في المستودع هي Python >=3.10,<3.14 (pyproject.toml) و Go 1.26.4 (go.mod). يختبر CI مكونات TypeScript باستخدام Node.js 24.
git clone https://github.com/cisco-ai-defense/defenseclaw.git
cd defenseclaw
make build
make test
make check
make lint
ينتج make build مخرجات نسخة العمل دون نشرها أو تغيير حالة التثبيت المُدار؛ وقد تُنشئ خطوة pycli الخاصة به أو تُحدّث مجلد .venv المشترك المحلي في المستودع. شغّل make help قبل استخدام أهداف المصدر التي تغيّر الحالة. تشترك جميع أهداف المصدر المحلية في مجلد .venv واحد مُقفل وجاهز للاختبار؛ ولا يوجد بيئة Python منفصلة للإنتاج مقابل التطوير لاختيارها. يقوم make test و make check و make py-lint بتهيئة تلك البيئة عند الحاجة. يعيد make all بناء نسخة العمل الحالية وتفعيلها عن قصد للتطوير المحلي؛ أما الأهداف الأدنى مستوى make install و make dev-install و scripts/install-dev.sh فتُنفّذ قواعد ملكية المصدر وليست مسار ترقية. تُرقّى عمليات تثبيت الإصدارات باستخدام defenseclaw upgrade، الذي يشغّل مثبّت أحدث إصدار؛ راجع صفحة الترقية.
مناطق المصدر الرئيسية هي:
| المنطقة | المسار |
|---|---|
| Python CLI و TUI | cli/defenseclaw/ |
| أوامر بوابة Go | cmd/ |
| حزم تنفيذ Go | internal/ |
| إضافة OpenClaw | extensions/defenseclaw/ |
| حزم السياسات | policies/ |
| المخططات المُصدّرة | schemas/ |
| أتمتة الإصدارات والمطورين | scripts/ |
| الاختبارات وبيانات الاختبار | test/ وملفات *_test.* المحلية للمكونات |
راجع CONTRIBUTING.md لسير عمل طلبات السحب و SECURITY.md للإبلاغ الخاص عن الثغرات.
الترخيص
Apache-2.0. راجع LICENSE و NOTICE.
حقوق النشر 2026 Cisco Systems, Inc. والشركات التابعة لها.