openclaw security

أدوات الأمان (تدقيق + إصلاحات اختيارية).

ذات صلة:

• دليل الأمان: الأمان

التدقيق

openclaw security auditopenclaw security audit --deepopenclaw security audit --deep --password <password>openclaw security audit --deep --token <token>openclaw security audit --fixopenclaw security audit --json

يبقى الأمر العادي security audit على مسار الإعدادات/نظام الملفات/للقراءة فقط البارد. ولا يكتشف مجمّعات أمان وقت تشغيل الـ Plugin افتراضيًا، لذلك لا تحمّل عمليات التدقيق الروتينية كل وقت تشغيل Plugin مثبّت. استخدم --deep لتضمين مجسّات Gateway الحية بأفضل جهد ومجمّعات تدقيق الأمان المملوكة للـ Plugin؛ ويمكن للمتصلين الداخليين الصريحين أيضًا اختيار تلك المجمّعات المملوكة للـ Plugin عندما يكون لديهم بالفعل نطاق وقت تشغيل مناسب.

يحذّر التدقيق عندما يتشارك عدة مرسلين في الرسائل الخاصة الجلسة الرئيسية ويوصي بـ وضع الرسائل الخاصة الآمن: session.dmScope="per-channel-peer" (أو per-account-channel-peer للقنوات متعددة الحسابات) لصناديق الوارد المشتركة. هذا مخصص لتقوية صناديق الوارد التعاونية/المشتركة. لا يُنصح بإعداد Gateway واحد مشترك بين مشغّلين غير موثوقين/خصوم متبادلين؛ افصل حدود الثقة عبر Gateways منفصلة (أو مستخدمي/مضيفي نظام تشغيل منفصلين). كما يصدر security.trust_model.multi_user_heuristic عندما تشير الإعدادات إلى احتمال ورود مستخدمين مشتركين (على سبيل المثال سياسة رسائل خاصة/مجموعات مفتوحة، أو أهداف مجموعات مكوّنة، أو قواعد مرسلين ذات أحرف بدل)، ويذكّرك بأن OpenClaw يستخدم نموذج ثقة مساعد شخصي افتراضيًا. بالنسبة إلى إعدادات المستخدمين المشتركين المقصودة، توصي إرشادات التدقيق بعزل كل الجلسات في sandbox، وإبقاء الوصول إلى نظام الملفات محدودًا بنطاق مساحة العمل، وإبعاد الهويات أو بيانات الاعتماد الشخصية/الخاصة عن وقت التشغيل هذا. كما يحذّر عندما تُستخدم النماذج الصغيرة (<=300B) من دون عزل sandbox ومع تمكين أدوات الويب/المتصفح. بالنسبة إلى ورود Webhook، تسجل عملية بدء التشغيل تحذيرًا أمنيًا غير قاتل، ويعلّم التدقيق إعادة استخدام hooks.token لقيم مصادقة السرّ المشترك النشطة في Gateway، بما في ذلك gateway.auth.token / OPENCLAW_GATEWAY_TOKEN و gateway.auth.password / OPENCLAW_GATEWAY_PASSWORD. كما يحذّر عندما:

• يكون hooks.token قصيرًا
• يكون hooks.path="/"
• لا يكون hooks.defaultSessionKey معيّنًا
• يكون hooks.allowedAgentIds غير مقيّد
• تكون تجاوزات sessionKey في الطلبات مفعّلة
• تكون التجاوزات مفعّلة من دون hooks.allowedSessionKeyPrefixes

إذا كانت مصادقة كلمة مرور Gateway مقدمة عند بدء التشغيل فقط، فمرّر القيمة نفسها إلى openclaw security audit --auth password --password <password> حتى يتمكن التدقيق من فحصها مقابل hooks.token. شغّل openclaw doctor --fix لتدوير hooks.token مستمر مُعاد استخدامه، ثم حدّث مرسلي الخطافات الخارجيين لاستخدام رمز الخطاف الجديد.

كما يحذّر عندما تكون إعدادات Docker الخاصة بالـ sandbox مكوّنة بينما يكون وضع sandbox متوقفًا، وعندما يستخدم gateway.nodes.denyCommands إدخالات غير فعالة تشبه الأنماط/مجهولة (مطابقة اسم أمر العقدة بدقة فقط، وليس ترشيح نص الصدفة)، وعندما يفعّل gateway.nodes.allowCommands أوامر عقدة خطرة صراحةً، وعندما تتجاوز ملفات تعريف أدوات الوكيل tools.profile="minimal" العالمية، وعندما تكون أدوات الكتابة/التحرير معطلة لكن exec لا يزال متاحًا من دون حد عزل مقيّد لنظام ملفات sandbox، وعندما تكشف الرسائل الخاصة أو المجموعات المفتوحة أدوات وقت التشغيل/نظام الملفات من دون حراس sandbox/مساحة العمل، وعندما قد تكون أدوات Plugin المثبتة قابلة للوصول ضمن سياسة أدوات متساهلة. كما يعلّم gateway.allowRealIpFallback=true (خطر انتحال الرؤوس إذا أسيء تكوين الوسطاء) و discovery.mdns.mode="full" (تسرب بيانات وصفية عبر سجلات mDNS TXT). كما يحذّر عندما يستخدم متصفح sandbox شبكة Docker bridge من دون sandbox.browser.cdpSourceRange. كما يعلّم أوضاع شبكة Docker خطرة في sandbox (بما في ذلك host وضمّ مساحات أسماء container:*). كما يحذّر عندما تكون حاويات Docker الحالية لمتصفح sandbox ذات تسميات تجزئة مفقودة/قديمة (على سبيل المثال حاويات ما قبل الترحيل التي تفتقد openclaw.browserConfigEpoch) ويوصي بـ openclaw sandbox recreate --browser --all. كما يحذّر عندما تكون سجلات تثبيت Plugin/خطاف المستندة إلى npm غير مثبّتة بإصدار، أو تفتقد بيانات سلامة، أو تنحرف عن إصدارات الحزم المثبتة حاليًا. يحذّر عندما تعتمد قوائم السماح للقنوات على أسماء/بريد إلكتروني/وسوم قابلة للتغيير بدلًا من المعرّفات المستقرة (Discord وSlack وGoogle Chat وMicrosoft Teams وMattermost ونطاقات IRC حيثما ينطبق ذلك). يحذّر عندما يترك gateway.auth.mode="none" واجهات HTTP API الخاصة بـ Gateway قابلة للوصول من دون سر مشترك (/tools/invoke بالإضافة إلى أي نقطة نهاية /v1/* مفعّلة). الإعدادات المسبوقة بـ dangerous/dangerously هي تجاوزات مشغّل صريحة لكسر الزجاج؛ وتمكين أحدها ليس، بحد ذاته، تقرير ثغرة أمنية. للحصول على قائمة معلمات الخطر الكاملة، راجع قسم "ملخص الأعلام غير الآمنة أو الخطرة" في الأمان.

يمكن قبول النتائج الدائمة المقصودة باستخدام security.audit.suppressions. يطابق كل كبت checkId دقيقًا ويمكن تضييقه باستخدام السلاسل الفرعية غير الحساسة لحالة الأحرف titleIncludes و/أو detailIncludes:

{  "security": {    "audit": {      "suppressions": [        {          "checkId": "plugins.tools_reachable_permissive_policy",          "detailIncludes": "Enabled extension plugins: gbrain",          "reason": "trusted local operator plugin"        }      ]    }  }}

تُزال النتائج المكبوتة من summary النشط وقائمة findings. يبقي خرج JSON هذه النتائج ضمن suppressedFindings لقابلية التدقيق. عند تكوين الكبت، يبقي الخرج النشط أيضًا نتيجة معلومات غير قابلة للكبت security.audit.suppressions.active حتى يستطيع القراء معرفة أن التدقيق تمت تصفيته. تُصدر أعلام الإعدادات الخطرة علمًا واحدًا لكل نتيجة، لذلك لا يؤدي قبول علم خطر واحد إلى إخفاء الأعلام المفعّلة الأخرى التي تشارك checkId نفسه config.insecure_or_dangerous_flags. لأن الكبت يمكن أن يخفي خطرًا قائمًا، فإن إضافة الكبت أو إزالته عبر أوامر صدفة يشغّلها الوكيل تتطلب موافقة exec ما لم يكن exec يعمل بالفعل بـ security="full" و ask="off" للأتمتة المحلية الموثوقة.

سلوك SecretRef:

• يحل security audit مراجع SecretRef المدعومة في وضع القراءة فقط للمسارات المستهدفة.
• إذا كان SecretRef غير متاح في مسار الأمر الحالي، يواصل التدقيق ويبلغ عن secretDiagnostics (بدلًا من التعطل).
• لا تتجاوز --token و --password إلا مصادقة المجسّ العميق لاستدعاء الأمر ذلك؛ ولا تعيدان كتابة الإعدادات أو تعيينات SecretRef.

خرج JSON

استخدم --json لفحوصات CI/السياسة:

openclaw security audit --json | jq '.summary'openclaw security audit --deep --json | jq '.findings[] | select(.severity=="critical") | .checkId'

إذا جُمِع --fix و --json، يتضمن الخرج إجراءات الإصلاح والتقرير النهائي معًا:

openclaw security audit --fix --json | jq '{fix: .fix.ok, summary: .report.summary}'

ما الذي يغيّره --fix

يطبّق --fix إصلاحات آمنة وحتمية:

• يبدّل groupPolicy="open" الشائع إلى groupPolicy="allowlist" (بما في ذلك متغيرات الحساب في القنوات المدعومة)
• عندما تتحول سياسة مجموعات WhatsApp إلى allowlist، يملأ groupAllowFrom من ملف allowFrom المخزّن عندما تكون تلك القائمة موجودة ولا تكون الإعدادات قد عرّفت allowFrom بالفعل
• يعيّن logging.redactSensitive من "off" إلى "tools"
• يشدّد الأذونات لملفات الحالة/الإعدادات والملفات الحساسة الشائعة (credentials/*.json و auth-profiles.json و sessions.json وجلسات *.jsonl)
• يشدّد أيضًا ملفات تضمين الإعدادات المشار إليها من openclaw.json
• يستخدم chmod على مضيفي POSIX وإعادات ضبط icacls على Windows

لا يقوم --fix بـ:

• تدوير الرموز/كلمات المرور/مفاتيح API
• تعطيل الأدوات (gateway و cron و exec وما إلى ذلك)
• تغيير اختيارات ربط/مصادقة/تعريض الشبكة الخاصة بالـ Gateway
• إزالة أو إعادة كتابة Plugins/Skills

ذات صلة

• مرجع CLI
• تدقيق الأمان