​

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

​

ऑडिट मोड

​

यह क्या जाँचता है

• जब एकाधिक DM प्रेषक मुख्य सत्र साझा करते हैं, तो चेतावनी देता है और साझा इनबॉक्स के लिए सुरक्षित DM मोड की अनुशंसा करता है: session.dmScope="per-channel-peer" (या बहु-खाता चैनलों के लिए per-account-channel-peer)। यह सहयोगी/साझा-इनबॉक्स सुदृढ़ीकरण है, परस्पर अविश्वसनीय ऑपरेटरों के लिए पृथक्करण नहीं; उसके लिए अलग-अलग gateways (या अलग OS उपयोगकर्ताओं/होस्ट) से विश्वास सीमाएँ विभाजित करें।
• जब कॉन्फ़िगरेशन संभावित साझा-उपयोगकर्ता प्रवेश का संकेत देता है (उदाहरण के लिए खुली DM/समूह नीति, कॉन्फ़िगर किए गए समूह लक्ष्य या वाइल्डकार्ड प्रेषक नियम), तो security.trust_model.multi_user_heuristic उत्सर्जित करता है — OpenClaw का डिफ़ॉल्ट विश्वास मॉडल व्यक्तिगत-सहायक (एक ऑपरेटर) है, प्रतिकूल बहु-किरायेदार पृथक्करण नहीं। जानबूझकर बनाए गए साझा-उपयोगकर्ता सेटअप के लिए: सभी सत्रों को सैंडबॉक्स करें, फ़ाइल सिस्टम पहुँच को कार्यस्थान-स्कोप तक सीमित रखें और व्यक्तिगत/निजी पहचान या क्रेडेंशियल उस रनटाइम से दूर रखें।
• जब छोटे मॉडल (<=300B पैरामीटर) सैंडबॉक्सिंग के बिना और वेब/ब्राउज़र उपकरण सक्षम रखकर उपयोग किए जाते हैं, तो चेतावनी देता है।

• hooks.token छोटा है
• hooks.path="/"
• hooks.defaultSessionKey सेट नहीं है
• hooks.allowedAgentIds अप्रतिबंधित है
• अनुरोध sessionKey ओवरराइड सक्षम हैं
• ओवरराइड hooks.allowedSessionKeyPrefixes के बिना सक्षम हैं

• जब सैंडबॉक्स मोड बंद होने के बावजूद सैंडबॉक्स Docker सेटिंग कॉन्फ़िगर हों, तो चेतावनी देता है।
• जब gateway.nodes.commands.deny अप्रभावी पैटर्न-जैसी/अज्ञात प्रविष्टियों का उपयोग करता है, तो चेतावनी देता है (मिलान केवल सटीक Node कमांड-नाम पर होता है, शेल-पाठ फ़िल्टरिंग पर नहीं)।
• जब gateway.nodes.commands.allow खतरनाक Node कमांड स्पष्ट रूप से सक्षम करता है, तो चेतावनी देता है।
• जब वैश्विक tools.profile="minimal" को एजेंट उपकरण प्रोफ़ाइल ओवरराइड करती हैं, तो चेतावनी देता है।
• जब लिखने/संपादित करने के उपकरण अक्षम हों, लेकिन सीमित करने वाली सैंडबॉक्स फ़ाइल सिस्टम सीमा के बिना exec अब भी उपलब्ध हो, तो चेतावनी देता है।
• जब खुले DM या समूह सैंडबॉक्स/कार्यस्थान सुरक्षा उपायों के बिना रनटाइम/फ़ाइल सिस्टम उपकरण उजागर करते हैं, तो चेतावनी देता है।
• जब इंस्टॉल किए गए Plugin उपकरण अनुमतिशील उपकरण नीति के अंतर्गत पहुँच योग्य हो सकते हैं, तो चेतावनी देता है।

• जब सैंडबॉक्स ब्राउज़र sandbox.browser.cdpSourceRange के बिना Docker bridge नेटवर्क उपयोग करता है, तो चेतावनी देता है।
• host और container:* नेमस्पेस जॉइन सहित खतरनाक सैंडबॉक्स Docker नेटवर्क मोड को चिह्नित करता है।
• जब मौजूदा सैंडबॉक्स ब्राउज़र Docker कंटेनरों में हैश लेबल अनुपस्थित/पुराने हों (उदाहरण के लिए, माइग्रेशन-पूर्व कंटेनरों में openclaw.browserConfigEpoch अनुपस्थित हो), तो चेतावनी देता है और openclaw sandbox recreate --browser --all की अनुशंसा करता है।

• gateway.allowRealIpFallback=true को चिह्नित करता है (प्रॉक्सी गलत कॉन्फ़िगर होने पर हेडर-स्पूफ़िंग जोखिम)।
• discovery.mdns.mode="full" को चिह्नित करता है (mDNS TXT रिकॉर्ड के माध्यम से मेटाडेटा रिसाव)।
• जब gateway.auth.mode="none" Gateway HTTP API को किसी साझा गुप्त के बिना पहुँच योग्य छोड़ देता है (/tools/invoke और कोई भी सक्षम /v1/* एंडपॉइंट), तो चेतावनी देता है।

• जब npm-आधारित Plugin/हुक इंस्टॉल रिकॉर्ड पिन न किए गए हों, उनमें इंटीग्रिटी मेटाडेटा न हो या वे वर्तमान में इंस्टॉल पैकेज संस्करणों से अलग हों, तो चेतावनी देता है।
• जब चैनल अनुमतिसूचियाँ स्थिर ID के बजाय परिवर्तनीय नामों/ईमेल/टैग पर निर्भर हों (जहाँ लागू हो वहाँ 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 में बदलती है, तो संग्रहीत allowFrom फ़ाइल से groupAllowFrom भरता है, बशर्ते वह सूची मौजूद हो और कॉन्फ़िगरेशन में allowFrom पहले से परिभाषित न हो
• logging.redactSensitive को "off" से "tools" पर सेट करता है
• स्थिति/कॉन्फ़िगरेशन और सामान्य संवेदनशील फ़ाइलों (credentials/*.json, auth-profiles.json, openclaw-agent.sqlite और पुराने सत्र आर्टिफ़ैक्ट) की अनुमतियाँ अधिक कठोर करता है
• openclaw.json से संदर्भित कॉन्फ़िगरेशन समावेशन फ़ाइलों की अनुमतियाँ भी अधिक कठोर करता है
• POSIX होस्ट पर chmod और Windows पर icacls रीसेट का उपयोग करता है

• टोकन/पासवर्ड/API कुंजियाँ बदलना
• उपकरण (gateway, cron, exec आदि) अक्षम करना
• Gateway बाइंड/प्रमाणीकरण/नेटवर्क एक्सपोज़र विकल्प बदलना
• Plugins/Skills हटाना या पुनः लिखना

​

संबंधित

• CLI संदर्भ
• सुरक्षा ऑडिट