حوكمة الأمن للذكاء الاصطناعي الفاعل
____ ____ ____ _
/ __ \ ___ / __/___ ___ ___ ___ / ___|| | __ _ __ __
/ / / / / _ \/ /_// _ \ / _ \ / __|/ _ \| | | |/ _` |\ \ /\ / /
/ /_/ / / __/ __// __/| | | |\__ \ __/| |___ | | (_| | \ V V /
/_____/ \___/_/ \___/ |_| |_||___/\___| \____||_|\__,_| \_/\_/
حوكمة أمنية لوكلاء البرمجة بالذكاء الاصطناعي وبيئات التشغيل الوكيلية.
افحص القدرات قبل استخدامها، وافحص حركة المرور أثناء التشغيل، وصدّر أدلة تدقيق دائمة.
يجمع DefenseClaw بين واجهة سطر أوامر للمشغّل مكتوبة بلغة Python، وبوابة مكتوبة بلغة Go، وخطافات الموصلات، والسياسة، والماسحات الضوئية، ومصدّرات المراقبة. وهو طبقة فرض وأدلة؛ ولا يثبت أن وكيلاً أو تفاعلاً مع نموذج أو قدرة طرف ثالث خالية من المخاطر.
تفشل الخطافات مغلقةً افتراضيًا. فقط عمليات نشر Cisco Secure Client تجعل تسليم الخطافات افتراضيًا مفتوحًا عند عدم تحديد سياسة؛ وهناك يظل إعداد الفشل المغلق الصريح ورفض السياسات الصالحة فعّالين. راجع أوضاع الفشل للاطلاع على نطاق Secure Client.
curl -LsSf https://github.com/cisco-ai-defense/defenseclaw/releases/latest/download/install.sh | bash
defenseclaw quickstart
ثم اقرأ docs. على Windows الأصلي، راجع Install DefenseClaw.
يُعد موقع توثيق DefenseClaw المصدر الموثوق للتثبيت والإعداد والتهيئة والأوامر وسير عمل المشغّل:
| الموضوع | الدليل الأساسي |
|---|---|
| Install | Install DefenseClaw |
| First run | Quickstart |
| Upgrade | Upgrade |
| Windows | Native Windows |
| Connectors | Connector compatibility |
| Guardrails | Guardrail setup |
| Configuration | Configuration reference |
| CLI | CLI reference |
| Observability | Observability |
يقتصر 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، الذي يشغّل مثبّت أحدث إصدار؛ راجع صفحة الترقية.
مجالات المصدر الرئيسية هي:
| المجال | المسار |
|---|---|
| واجهة سطر الأوامر وواجهة TUI بلغة Python | 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. والشركات التابعة لها.