​

openclaw security

openclaw security audit
openclaw security audit --deep
openclaw security audit --deep --password <password>
openclaw security audit --deep --token <token>
openclaw security audit --auth password --password <password>
openclaw security audit --fix
openclaw security audit --json

​

أوضاع التدقيق

​

ما الذي يفحصه

• يحذّر عندما يتشارك عدة مرسلين للرسائل المباشرة الجلسة الرئيسية، ويوصي بوضع الرسائل المباشرة الآمن: session.dmScope="per-channel-peer" (أو per-account-channel-peer للقنوات متعددة الحسابات) لصناديق الوارد المشتركة. هذا تعزيز أمان تعاوني/لصندوق وارد مشترك، وليس عزلاً للمشغّلين الذين لا يثق بعضهم ببعض؛ افصل حدود الثقة باستخدام بوابات منفصلة (أو مستخدمي نظام تشغيل/مضيفين منفصلين) لهذا الغرض.
• يصدر security.trust_model.multi_user_heuristic عندما تشير الإعدادات إلى احتمال وجود دخول من مستخدمين مشتركين (مثل سياسة مفتوحة للرسائل المباشرة/المجموعات، أو أهداف مجموعات مضبوطة، أو قواعد مرسلين بأحرف بدل) — نموذج الثقة الافتراضي في OpenClaw هو المساعد الشخصي (مشغّل واحد)، وليس عزلاً عدائياً متعدد المستأجرين. في الإعدادات المقصودة للمستخدمين المشتركين: اعزل جميع الجلسات، واقصر الوصول إلى نظام الملفات على نطاق مساحة العمل، وأبقِ الهويات أو بيانات الاعتماد الشخصية/الخاصة خارج وقت التشغيل ذاك.
• يحذّر عند استخدام نماذج صغيرة (<=300B من المعلمات) دون عزل مع تمكين أدوات الويب/المتصفح.

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

• يحذّر عند ضبط إعدادات Docker الخاصة بالعزل بينما يكون وضع العزل متوقفاً.
• يحذّر عندما يستخدم gateway.nodes.denyCommands إدخالات غير فعالة تشبه الأنماط/غير معروفة (المطابقة تكون لاسم أمر Node بدقة فقط، وليست تصفية لنص الصدفة).
• يحذّر عندما يمكّن gateway.nodes.allowCommands أوامر Node خطرة صراحةً.
• يحذّر عندما تتجاوز ملفات تعريف أدوات الوكيل قيمة tools.profile="minimal" العامة.
• يحذّر عندما تكون أدوات الكتابة/التحرير معطّلة، لكن exec لا يزال متاحاً دون حدود مقيّدة لنظام ملفات العزل.
• يحذّر عندما تكشف الرسائل المباشرة أو المجموعات المفتوحة أدوات وقت التشغيل/نظام الملفات دون وسائل حماية للعزل/مساحة العمل.
• يحذّر عندما يمكن الوصول إلى أدوات Plugins المثبّتة بموجب سياسة أدوات متساهلة.

• يحذّر عندما يستخدم متصفح العزل شبكة Docker ‏bridge دون sandbox.browser.cdpSourceRange.
• يشير إلى أوضاع شبكة Docker الخطرة للعزل، بما فيها عمليات الانضمام إلى نطاقَي الأسماء host وcontainer:*.
• يحذّر عندما تكون حاويات Docker الحالية لمتصفح العزل بلا تسميات تجزئة أو ذات تسميات قديمة (مثل حاويات ما قبل الترحيل التي تفتقد openclaw.browserConfigEpoch) ويوصي باستخدام openclaw sandbox recreate --browser --all.

• يشير إلى gateway.allowRealIpFallback=true (خطر انتحال الترويسات إذا أسيء ضبط الوكلاء).
• يشير إلى discovery.mdns.mode="full" (تسرّب البيانات الوصفية عبر سجلات mDNS TXT).
• يحذّر عندما يترك gateway.auth.mode="none" واجهات HTTP API الخاصة بـ Gateway قابلة للوصول دون سر مشترك (/tools/invoke بالإضافة إلى أي نقطة نهاية /v1/* مفعّلة).

• يحذّر عندما تكون سجلات تثبيت Plugins/الخطافات المستندة إلى npm غير مثبّتة على إصدار محدد، أو تفتقد بيانات تعريف التكامل، أو تنحرف عن إصدارات الحزم المثبّتة حالياً.
• يحذّر عندما تعتمد قوائم السماح للقنوات على أسماء/عناوين بريد إلكتروني/وسوم قابلة للتغيير بدلاً من معرّفات ثابتة (ضمن نطاقات Discord وSlack وGoogle Chat وMicrosoft Teams وMattermost وIRC حيثما ينطبق).

​

سلوك SecretRef

​

عمليات الكبت

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

​

إخراج JSON

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

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

​

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

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

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

​

ذو صلة

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