---
read_when:
    - आप कॉन्फ़िगरेशन/स्थिति पर त्वरित सुरक्षा ऑडिट चलाना चाहते हैं
    - आप सुरक्षित "सुधार" सुझाव लागू करना चाहते हैं (अनुमतियाँ, डिफ़ॉल्ट को अधिक सख्त बनाना)
summary: '`openclaw security` के लिए CLI संदर्भ (सामान्य सुरक्षा संबंधी गलतियों का ऑडिट और सुधार)'
title: सुरक्षा
x-i18n:
    generated_at: "2026-07-27T17:41:52Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 6b5f9ea5cb746bfd29ff4d096062e81595abe99a883fc3b1113b45a3527d42d9
    source_path: cli/security.md
    workflow: 16
---

# `openclaw security`

सुरक्षा उपकरण: ऑडिट और वैकल्पिक सुरक्षित सुधार। संबंधित: [सुरक्षा](/hi/gateway/security)।

```bash
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
```

## ऑडिट मोड

सामान्य `security audit` कोल्ड कॉन्फ़िगरेशन/फ़ाइल सिस्टम/केवल-पठन पथ पर रहता है: यह Plugin रनटाइम सुरक्षा संग्राहकों की खोज नहीं करता, इसलिए नियमित ऑडिट प्रत्येक इंस्टॉल किए गए Plugin रनटाइम को लोड नहीं करते। `--deep` यथासंभव लाइव Gateway जाँच और Plugin-स्वामित्व वाले सुरक्षा ऑडिट संग्राहक जोड़ता है (स्पष्ट आंतरिक कॉलर भी इन संग्राहकों का विकल्प चुन सकते हैं, जब उनके पास पहले से उपयुक्त रनटाइम स्कोप हो)।

यदि Gateway पासवर्ड प्रमाणीकरण केवल स्टार्टअप पर दिया गया है, तो वही मान `--auth password --password <password>` के साथ दें, ताकि ऑडिट उसे `hooks.token` के विरुद्ध जाँच सके।

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

**DM/विश्वास मॉडल**

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

**Webhook/हुक**

स्टार्टअप एक गैर-घातक सुरक्षा चेतावनी लॉग करता है और ऑडिट सक्रिय Gateway साझा-गुप्त प्रमाणीकरण मानों (`gateway.auth.token` / `OPENCLAW_GATEWAY_TOKEN`, `gateway.auth.password` / `OPENCLAW_GATEWAY_PASSWORD`) के `hooks.token` पुनः उपयोग को चिह्नित करता है। साथ ही इन स्थितियों में चेतावनी देता है:

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

संग्रहीत पुनः उपयोग किए गए `hooks.token` को बदलने के लिए `openclaw doctor --fix` चलाएँ, फिर बाहरी हुक प्रेषकों को नया टोकन उपयोग करने के लिए अपडेट करें।

**सैंडबॉक्स/उपकरण**

- जब सैंडबॉक्स मोड बंद होने के बावजूद सैंडबॉक्स 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/*` एंडपॉइंट), तो चेतावनी देता है।

**Plugins/चैनल**

- जब npm-आधारित Plugin/हुक इंस्टॉल रिकॉर्ड पिन न किए गए हों, उनमें इंटीग्रिटी मेटाडेटा न हो या वे वर्तमान में इंस्टॉल पैकेज संस्करणों से अलग हों, तो चेतावनी देता है।
- जब चैनल अनुमतिसूचियाँ स्थिर ID के बजाय परिवर्तनीय नामों/ईमेल/टैग पर निर्भर हों (जहाँ लागू हो वहाँ Discord, Slack, Google Chat, Microsoft Teams, Mattermost और IRC स्कोप), तो चेतावनी देता है।

`dangerous`/`dangerously` उपसर्ग वाली सेटिंग स्पष्ट आपातकालीन ऑपरेटर ओवरराइड हैं; इनमें से किसी एक को सक्षम करना अपने आप में सुरक्षा भेद्यता रिपोर्ट नहीं है। खतरनाक पैरामीटर की पूरी सूची के लिए [सुरक्षा](/hi/gateway/security) में "असुरक्षित या खतरनाक फ़्लैग सारांश" देखें।

## SecretRef व्यवहार

`security audit` अपने लक्षित पथों के लिए समर्थित SecretRefs को केवल-पठन मोड में हल करता है। यदि वर्तमान कमांड पथ में कोई SecretRef उपलब्ध नहीं है, तो ऑडिट क्रैश होने के बजाय जारी रहता है और `secretDiagnostics` रिपोर्ट करता है। `--token` और `--password` केवल उस कमांड आह्वान के लिए गहन-जाँच प्रमाणीकरण को ओवरराइड करते हैं; वे कॉन्फ़िगरेशन या SecretRef मैपिंग को पुनः नहीं लिखते।

## दमन

जानबूझकर बने रहने वाले निष्कर्षों को `security.audit.suppressions` से स्वीकार करें। प्रत्येक दमन एक सटीक `checkId` से मेल खाता है और केस-असंवेदी `titleIncludes` तथा/अथवा `detailIncludes` उपस्ट्रिंग के साथ सीमित किया जा सकता है:

```json
{
  "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` सूचना निष्कर्ष भी रखता है, ताकि पाठक जान सकें कि ऑडिट फ़िल्टर किया गया था। खतरनाक कॉन्फ़िगरेशन फ़्लैग प्रति निष्कर्ष एक फ़्लैग के रूप में उत्सर्जित होते हैं, इसलिए एक खतरनाक फ़्लैग स्वीकार करने से समान `config.insecure_or_dangerous_flags` checkId साझा करने वाले अन्य सक्षम फ़्लैग छिपते नहीं हैं।

क्योंकि दमन बने रहने वाले जोखिम को छिपा सकते हैं, एजेंट द्वारा चलाए गए शेल कमांड के माध्यम से उन्हें जोड़ने या हटाने के लिए exec अनुमोदन आवश्यक है, जब तक कि विश्वसनीय स्थानीय स्वचालन के लिए exec पहले से `security="full"` और `ask="off"` के साथ न चल रहा हो।

## JSON आउटपुट

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

`--fix --json` के साथ आउटपुट में सुधार क्रियाएँ और अंतिम रिपोर्ट, दोनों शामिल होते हैं:

```bash
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` रीसेट का उपयोग करता है

`--fix` यह **नहीं** करता:

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

## संबंधित

- [CLI संदर्भ](/hi/cli)
- [सुरक्षा ऑडिट](/hi/gateway/security)
