Gateway एक्सपोज़र रनबुक

​

एक्सपोज़र पैटर्न चुनें

​

प्रारंभिक इन्वेंट्री

• Gateway होस्ट, OS उपयोगकर्ता और स्थिति डायरेक्टरी (डिफ़ॉल्ट ~/.openclaw)।
• Gateway URL और बाइंड मोड (gateway.bind; डिफ़ॉल्ट पोर्ट 18789)।
• प्रमाणीकरण मोड, टोकन/पासवर्ड स्रोत या विश्वसनीय प्रॉक्सी पहचान स्रोत।
• प्रत्येक सक्षम चैनल और क्या वह DM, समूह या Webhook स्वीकार करता है।
• गैर-स्थानीय प्रेषकों की पहुँच में आने वाले एजेंट।
• प्रत्येक पहुँच योग्य एजेंट की टूल प्रोफ़ाइल, सैंडबॉक्स मोड और उन्नत टूल नीति।
• उन एजेंटों के लिए उपलब्ध बाहरी क्रेडेंशियल।
• ~/.openclaw/openclaw.json और क्रेडेंशियल के बैकअप का स्थान।

​

आधारभूत जाँच

openclaw doctor
openclaw security audit
openclaw security audit --deep
openclaw health

openclaw gateway probe --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

​

न्यूनतम सुरक्षित आधाररेखा

{
  gateway: {
    bind: "loopback",
    auth: {
      mode: "token",
      token: "replace-with-a-long-random-token",
    },
  },
  session: {
    dmScope: "per-channel-peer",
  },
  agents: {
    defaults: {
      sandbox: { mode: "non-main" },
    },
  },
  tools: {
    profile: "messaging",
    exec: { security: "deny", ask: "always" },
    elevated: { enabled: false },
  },
}

​

DM और समूह एक्सपोज़र

• dmPolicy: "open" की बजाय dmPolicy: "pairing" या सख्त allowFrom सूची को प्राथमिकता दें।
• "*" अनुमत-सूचियों को व्यापक टूल पहुँच के साथ संयोजित न करें।
• जब तक कक्ष कड़े नियंत्रण में न हो, समूहों में उल्लेख आवश्यक करें।
• जब कई लोग बॉट को DM भेज सकते हों, तो session.dmScope: "per-channel-peer" (या बहु-अकाउंट चैनलों के लिए "per-account-channel-peer") सेट करें, ताकि DM सत्र संदर्भ साझा न करें।
• साझा चैनलों को न्यूनतम टूल और बिना व्यक्तिगत क्रेडेंशियल वाले एजेंटों तक रूट करें।

​

रिवर्स प्रॉक्सी जाँच

• प्रॉक्सी को Gateway पर फ़ॉरवर्ड करने से पहले उपयोगकर्ताओं को प्रमाणित करना आवश्यक है।
• फ़ायरवॉल या नेटवर्क नीति को Gateway पोर्ट तक सीधी पहुँच अवरुद्ध करनी चाहिए।
• gateway.trustedProxies में केवल प्रॉक्सी स्रोत IP सूचीबद्ध होने चाहिए।
• प्रॉक्सी को क्लाइंट द्वारा दिए गए पहचान और फ़ॉरवर्डिंग हेडर हटाने या ओवरराइट करने चाहिए।
• जब प्रॉक्सी एक से अधिक ऑडियंस को सेवा देती हो, तब gateway.auth.trustedProxy.allowUsers सेट करें।
• gateway.auth.trustedProxy.allowLoopback का उपयोग केवल उसी-होस्ट प्रॉक्सी के लिए करें, जहाँ स्थानीय प्रक्रियाएँ विश्वसनीय हों और पहचान हेडर प्रॉक्सी के नियंत्रण में हों।

​

टूल और सैंडबॉक्स समीक्षा

• पुष्टि करें कि कौन-से सत्र होस्ट पर और कौन-से सैंडबॉक्स में चलते हैं।
• होस्ट exec को अस्वीकार करें या उसके लिए अनुमोदन आवश्यक करें।
• जब तक किसी विशिष्ट, विश्वसनीय प्रेषक को उनकी आवश्यकता न हो, उन्नत टूल अक्षम रखें।
• खुली या अर्ध-खुली मैसेजिंग सतहों के लिए ब्राउज़र, कैनवास, Node, Cron, Gateway और सत्र-स्पॉन टूल से बचें।
• बाइंड माउंट सीमित रखें; क्रेडेंशियल, होम, Docker सॉकेट और सिस्टम पथों से बचें।
• काफी भिन्न विश्वास सीमाओं के लिए अलग Gateway, OS उपयोगकर्ता या होस्ट उपयोग करें।

​

परिवर्तन के बाद सत्यापन

1. openclaw security audit --deep दोबारा चलाएँ।
2. पुष्टि करें कि अधिकृत कनेक्शन सफलतापूर्वक जुड़ता है।
3. पुष्टि करें कि अनधिकृत प्रेषक या ब्राउज़र सत्र को अस्वीकार किया जाता है।
4. पुष्टि करें कि लॉग सीक्रेट छिपाते हैं।
5. पुष्टि करें कि DM/समूह रूटिंग केवल इच्छित एजेंट तक पहुँचती है।
6. पुष्टि करें कि उच्च-प्रभाव वाले टूल अनुमोदन माँगते हैं या अस्वीकार किए जाते हैं।
7. स्वीकार की गई शेष चेतावनियों का दस्तावेज़ीकरण करें।

​

रोलबैक योजना

{
  gateway: {
    bind: "loopback",
  },
  channels: {
    whatsapp: { dmPolicy: "disabled" },
    telegram: { dmPolicy: "disabled" },
    discord: { dmPolicy: "disabled" },
    slack: { dmPolicy: "disabled" },
  },
  tools: {
    exec: { security: "deny", ask: "always" },
    elevated: { enabled: false },
  },
}

1. सार्वजनिक फ़ॉरवर्डिंग, Tailscale Funnel या रिवर्स प्रॉक्सी रूट रोकें।
2. Gateway टोकन/पासवर्ड और प्रभावित एकीकरण क्रेडेंशियल रोटेट करें।
3. अनुमत-सूचियों से "*" और अनपेक्षित प्रेषकों को हटाएँ।
4. हाल के ऑडिट लॉग, रन इतिहास, टूल कॉल और कॉन्फ़िगरेशन परिवर्तनों की समीक्षा करें।
5. openclaw security audit --deep दोबारा चलाएँ।
6. वर्कफ़्लो को पूरा करने वाले सबसे सीमित पैटर्न के साथ पहुँच दोबारा सक्रिय करें।

​

समीक्षा चेकलिस्ट

• जब तक कोई दस्तावेज़ीकृत कारण न हो, Gateway केवल लूपबैक पर रहता है।
• गैर-लूपबैक पहुँच में प्रमाणीकरण और फ़ायरवॉल सुरक्षा है तथा कोई सीधा सार्वजनिक रूट नहीं है।
• विश्वसनीय-प्रॉक्सी डिप्लॉयमेंट में सख्त प्रॉक्सी IP और हेडर नियंत्रण हैं।
• DM डिफ़ॉल्ट रूप से खुली पहुँच के बजाय पेयरिंग या अनुमत-सूचियों का उपयोग करते हैं।
• समूहों में उल्लेख या स्पष्ट अनुमत-सूचियाँ आवश्यक हैं।
• साझा चैनलों की पहुँच व्यक्तिगत क्रेडेंशियल तक नहीं है।
• गैर-मुख्य सत्र सैंडबॉक्स मोड में चलते हैं।
• होस्ट exec और उन्नत टूल अस्वीकृत हैं या अनुमोदन द्वारा नियंत्रित हैं।
• लॉग सीक्रेट छिपाते हैं।
• गंभीर ऑडिट निष्कर्षों का समाधान किया गया है।
• रोलबैक चरणों का परीक्षण और दस्तावेज़ीकरण किया गया है।