تحصين الأمن (3): الدفاع ضد حقن الأوامر وتدقيق الأمن
الهدف في جملة واحدة: صدّ حقن الأوامر — ضع ضوابط على المدخلات غير الموثوقة التي تدخل Gateway، ونظّف بيانات الاعتماد الصريحة، واجتز تدقيقًا أمنيًا واحدًا باستخدام openclaw secrets audit --check.
إشعار أمني GHSA-pw3x-g8v8-fvj2: النسخة المرجعية لهذا الدرس 2026.10.9 متأثرة، يُرجى الترقية أولاً
في 2026-11-19، أصدرت OpenClaw إشعارًا عالي الخطورة (CVSS 8.8): "delegation could skip approval for restricted agents". حتى في حالة كانت سياسة الأدوات تمنع بالفعل تنفيذ الأوامر وكتابة الملفات، لا يزال بإمكان أداة openclaw كتابة إعدادات دائمة دون موافقة، مما يتيح للـ agent المقيّد فتح تنفيذ أوامر على المضيف.
- الإصدارات المتأثرة: ≥ 2026.9.2 و < 2026.10.33، بالإضافة إلى 2026.11.1 ~ 2026.11.3. كُتب هذا الدرس وفقًا لـ 2026.10.9، وهي ضمن النطاق المتأثر.
- إصدارات الإصلاح: الترقية في قناة stable إلى 2026.11.4 أو أحدث؛ والترقية في قناة extended-stable إلى 2026.10.33.
- إجراء تخفيف مؤقت قبل الترقية: ضبط
tools.exec.modeعلىask، ورفض تغييرات التفويض غير الموثوقة.
تحقق أولًا من إصدارك باستخدام openclaw --version. لمعرفة كيفية اختيار القناة وكيفية الترقية والتراجع، راجع الترقية وقنوات الإصدارات. نص الإشعار الأصلي: https://github.com/openclaw/openclaw/security/advisories/GHSA-pw3x-g8v8-fvj2
المتطلب السابق: أكمل أولًا «تحصين الأمن (1): التحكم في الوصول والهوية»؛ أما صلاحيات الأدوات وبيئة العزل فانظر «تحصين الأمن (2)».
التحضير
- OpenClaw 2.0 (الإصدار v2026.8.1) أو أحدث، ويستند هذا الدرس إلى نسخة المستودع 2026.10.9.
- إعدادات Gateway تعمل بشكل طبيعي: القنوات متصلة، ومزوّد نموذج واحد على الأقل مُهيّأ.
- إمكانية تشغيل
openclawCLI في الطرفية.
اتبع خطواتي
الخطوة 1: حصر أسطح الحقن
الإجراء: اسرد جميع مصادر الإدخال التي تدخل سياق Gateway — رسائل القنوات، وskills، والمحتوى الذي تعيده أدوات MCP، وصفحات الويب التي يجلبها المتصفح. حدّد لكل بند «موثوق / غير موثوق». وتذكّر قاعدة واحدة: عملية Gateway هي حدود الثقة الوحيدة، أما النموذج وagent harness فهما مجرد إضافات قابلة للاستبدال، وأي محتوى تعيده الإضافات يُعامل دائمًا كمدخل غير موثوق.
النتيجة المتوقعة: قائمة «مصدر الإدخال → مستوى الثقة → الأدوات التي يمكن تشغيلها». أي أداة يمكن لمصدر غير موثوق تشغيلها، ارجع إلى الدرس السابق لشدّ صلاحياتها.
الخطوة 2: نقل بيانات الاعتماد وإزالة النصوص الصريحة
الإجراء: قد تختبئ بيانات الاعتماد الصريحة في أربعة أماكن: openclaw.json و.env وأرشيفات auth-profile JSON المتقاعدة وagents/*/agent/models.json المُولَّد. أعد كتابة كل بند إلى SecretRef — يدعم أربعة أنواع من كتل provider هي env وfile وexec وstore، ويمكن لـ exec الاتصال مباشرة بـ 1Password وBitwarden وVault وpass وsops. ضع المفاتيح المشتركة للفريق في SQLite secret store مشترك، ومرّر حركة الشبكة الصادرة لجلب المفاتيح عبر قائمة السماح (allowlist) الخاصة بـ egress proxy.
النتيجة المتوقعة: لم يعد يظهر أي مفتاح API صريح في الملفات المذكورة أعلاه. لاحظ أن SecretRef يُفعَّل لكل بند اعتماد على حدة (opt-in) ولا يُرحَّل تلقائيًا.
الخطوة 3: تشغيل التدقيق
الإجراء: نفّذ
openclaw secrets audit --checkتحقق مما إذا كانت هناك نصوص صريحة متبقية. أما بنود التدقيق الكاملة لـ hardened-baseline ومعاملات الأوامر المقابلة لها، فالمرجع هو وثائق security الرسمية.@@I18N_KEEP_000019@@
النتيجة المتوقعة: يُظهر التقرير عدم وجود أي بقايا نصية صريحة (plaintext residue). وإذا وُجدت بقايا، فارجع وفق الملف الذي يشير إليه التقرير إلى الخطوة 2 لمتابعة النقل.
التحقق
- أعد تشغيل Gateway وتأكد من أن جميع القنوات والنماذج تعمل بشكل طبيعي — بيانات الاعتماد تُحمَّل الآن من SecretRef.
- شغّل
openclaw secrets audit --checkمرة أخرى، وتكون النتيجة عدم وجود بقايا. - أرسل رسالة تحريضية في قناة الاختبار (مثلًا تطلب قراءة
.env)، وتأكد من أن الموافقة تُربَط بالطلب والأمر والجلسة والشخص المحددين بدقة، لا أن تُمرَّر بصمت — هذا هو السلوك الجوهري في نموذج أمان 2.0.
الأخطاء الشائعة
- الاكتفاء بتنظيف
openclaw.jsonوإغفال.envوagents/*/agent/models.jsonالمُولَّد، فيظل التدقيق يبلّغ عن نصوص صريحة. - الاعتقاد بأن تفعيل SecretRef ينهي كل شيء: فهو يُفعَّل لكل بند اعتماد على حدة، وكل بند اعتماد يجب نقله بشكل منفصل حتى يصبح تقرير audit نظيفًا.
- دمج مخرجات skills أو أدوات MCP مباشرة في السياق: هذا يوسّع أسطح الحقن، ويجب أن يقترن بوسم الثقة في الخطوة 1 وصلاحيات الأدوات من الدرس السابق.
- @@I18N_KEEP_000020@@ قائمة بنود الإعدادات الافتراضية المحددة التي يوصي بها hardened-baseline، ستُستكمل بعد التحقق من الوثائق الرسمية.
الدرس التالي
بعد أن يصبح خط الأساس الأمني جاهزًا للعمل، تبقى مهمة أخيرة وهي مواكبة الإصدارات للإصلاحات الأمنية: الدرس التالي الترقية وقنوات الإصدارات يشرح كيفية الاختيار بين stable و extended-stable و beta، وكيفية الترقية والتراجع عند صدور إعلان أمني. أما الأوامر وخيارات الإعدادات الشائعة الاستخدام في العمليات اليومية، فهي مجمّعة في مرجع سريع لأوامر وإعدادات CLI.