सैंडबॉक्स बनाम टूल नीति बनाम उन्नत विशेषाधिकार

1. सैंडबॉक्स (agents.defaults.sandbox.* / agents.entries.*.sandbox.*) तय करता है कि टूल कहाँ चलते हैं (सैंडबॉक्स बैकएंड बनाम होस्ट)।
2. टूल नीति (tools.*, tools.sandbox.tools.*, agents.entries.*.tools.*) तय करती है कि कौन-से टूल उपलब्ध/अनुमत हैं।
3. उन्नत (tools.elevated.*, agents.entries.*.tools.elevated.*) सैंडबॉक्स में होने पर उसके बाहर चलाने के लिए केवल exec का निकास मार्ग है (डिफ़ॉल्ट रूप से gateway, या जब exec लक्ष्य को node पर कॉन्फ़िगर किया गया हो तब node)।

​

त्वरित डीबगिंग

openclaw sandbox explain
openclaw sandbox explain --session agent:main:main
openclaw sandbox explain --agent work
openclaw sandbox explain --json

• प्रभावी सैंडबॉक्स मोड/दायरा/वर्कस्पेस पहुँच
• क्या सत्र वर्तमान में सैंडबॉक्स में है (मुख्य बनाम गैर-मुख्य)
• प्रभावी सैंडबॉक्स टूल अनुमति/अस्वीकृति (और यह एजेंट/वैश्विक/डिफ़ॉल्ट में से कहाँ से आई)
• उन्नत गेट और सुधार हेतु कुंजी पथ

​

सैंडबॉक्स: टूल कहाँ चलते हैं

• "off": सब कुछ होस्ट पर चलता है।
• "non-main": केवल गैर-मुख्य सत्र सैंडबॉक्स में होते हैं (समूहों/चैनलों के लिए आम “आश्चर्य”)।
• "all": सब कुछ सैंडबॉक्स में होता है।

​

बाइंड माउंट (त्वरित सुरक्षा जाँच)

• docker.binds सैंडबॉक्स फ़ाइल सिस्टम को भेद देता है: आप जो भी माउंट करते हैं, वह आपके निर्धारित मोड (:ro या :rw) के साथ कंटेनर के भीतर दिखाई देता है।
• यदि आप मोड छोड़ देते हैं, तो डिफ़ॉल्ट पढ़ना-लिखना है; स्रोत/सीक्रेट के लिए :ro को प्राथमिकता दें।
• scope: "shared" प्रति-एजेंट बाइंड को अनदेखा करता है (केवल वैश्विक बाइंड लागू होते हैं)।
• OpenClaw बाइंड स्रोतों को दो बार सत्यापित करता है: पहले सामान्यीकृत स्रोत पथ पर, फिर सबसे गहरे मौजूदा पूर्वज के माध्यम से समाधान के बाद। सिमलिंक-पैरेंट निकास अवरुद्ध-पथ या अनुमत-रूट जाँच को बायपास नहीं करते।
• अस्तित्वहीन अंतिम पथों की भी सुरक्षित रूप से जाँच की जाती है। यदि /workspace/alias-out/new-file किसी सिमलिंक वाले पैरेंट के माध्यम से किसी अवरुद्ध पथ या कॉन्फ़िगर किए गए अनुमत रूट से बाहर समाधान होता है, तो बाइंड अस्वीकार कर दिया जाता है।
• /var/run/docker.sock को बाइंड करना प्रभावी रूप से होस्ट का नियंत्रण सैंडबॉक्स को सौंप देता है; ऐसा केवल जानबूझकर करें।
• वर्कस्पेस पहुँच (workspaceAccess) बाइंड मोड से स्वतंत्र है।

​

टूल नीति: कौन-से टूल मौजूद हैं/कॉल किए जा सकते हैं

• टूल प्रोफ़ाइल: tools.profile और agents.entries.*.tools.profile (आधार अनुमति-सूची)
• प्रदाता टूल प्रोफ़ाइल: tools.byProvider[provider].profile और agents.entries.*.tools.byProvider[provider].profile
• वैश्विक/प्रति-एजेंट टूल नीति: tools.allow/tools.deny और agents.entries.*.tools.allow/agents.entries.*.tools.deny
• प्रदाता टूल नीति: tools.byProvider[provider].allow/deny और agents.entries.*.tools.byProvider[provider].allow/deny
• सैंडबॉक्स टूल नीति (केवल सैंडबॉक्स में होने पर लागू): tools.sandbox.tools.allow/tools.sandbox.tools.deny और agents.entries.*.tools.sandbox.tools.*

• deny हमेशा प्रभावी होता है।
• यदि allow खाली नहीं है, तो बाकी सब कुछ अवरुद्ध माना जाता है।
• टूल नीति अंतिम रोक है: /exec अस्वीकृत exec टूल को ओवरराइड नहीं कर सकता।
• टूल नीति टूल की उपलब्धता को नाम के अनुसार फ़िल्टर करती है; यह exec के भीतर होने वाले दुष्प्रभावों की जाँच नहीं करती। यदि exec अनुमत है, तो write, edit, या apply_patch को अस्वीकार करने से शेल कमांड केवल-पढ़ने योग्य नहीं हो जाते।
• /exec केवल अधिकृत प्रेषकों के लिए सत्र के डिफ़ॉल्ट बदलता है; यह टूल पहुँच प्रदान नहीं करता।
• प्रदाता टूल कुंजियाँ provider (जैसे google-antigravity) या provider/model (जैसे openai/gpt-5.4) में से किसी एक को स्वीकार करती हैं।
• जब टूल नीति का कोई चरण टूल हटाता है या सैंडबॉक्स टूल नीति किसी कॉल को अवरुद्ध करती है, तब Gateway लॉग में agents/tool-policy ऑडिट प्रविष्टियाँ शामिल होती हैं। नियम लेबल, कॉन्फ़िगरेशन कुंजी और प्रभावित टूल नाम देखने के लिए openclaw logs का उपयोग करें।

​

टूल समूह (संक्षिप्त रूप)

{
  tools: {
    sandbox: {
      tools: {
        allow: ["group:runtime", "group:fs", "group:sessions", "group:memory"],
      },
    },
  },
}

​

उन्नत: केवल exec के लिए “होस्ट पर चलाएँ”

• यदि आप सैंडबॉक्स में हैं, तो /elevated on (या elevated: true के साथ exec) सैंडबॉक्स के बाहर चलता है (स्वीकृतियाँ फिर भी लागू हो सकती हैं)।
• सत्र के लिए exec स्वीकृतियाँ छोड़ने हेतु /elevated full का उपयोग करें।
• यदि आप पहले से सीधे चला रहे हैं, तो उन्नत सुविधा प्रभावी रूप से कुछ नहीं करती (फिर भी गेट द्वारा नियंत्रित रहती है)।
• उन्नत सुविधा Skills-दायरे तक सीमित नहीं है और टूल अनुमति/अस्वीकृति को ओवरराइड नहीं करती।
• उन्नत सुविधा host=auto से मनमाने क्रॉस-होस्ट ओवरराइड प्रदान नहीं करती; यह सामान्य exec लक्ष्य नियमों का पालन करती है और node को केवल तभी बनाए रखती है, जब कॉन्फ़िगर किया गया/सत्र लक्ष्य पहले से node हो।
• /exec उन्नत सुविधा से अलग है। यह केवल अधिकृत प्रेषकों के लिए प्रति-सत्र exec डिफ़ॉल्ट समायोजित करता है।

• सक्षमता: tools.elevated.enabled (और वैकल्पिक रूप से agents.entries.*.tools.elevated.enabled)
• प्रेषक अनुमति-सूचियाँ: tools.elevated.allowFrom.<provider> (और वैकल्पिक रूप से agents.entries.*.tools.elevated.allowFrom.<provider>)

​

सामान्य “सैंडबॉक्स जेल” सुधार

​

”टूल X सैंडबॉक्स टूल नीति द्वारा अवरुद्ध है”

• सैंडबॉक्स अक्षम करें: agents.defaults.sandbox.mode=off (या प्रति-एजेंट agents.entries.*.sandbox.mode=off)
• सैंडबॉक्स के अंदर टूल को अनुमति दें:
  • इसे tools.sandbox.tools.deny से हटाएँ (या प्रति-एजेंट agents.entries.*.tools.sandbox.tools.deny)
  • या इसे tools.sandbox.tools.allow में जोड़ें (या प्रति-एजेंट अनुमति)
• agents/tool-policy प्रविष्टि के लिए openclaw logs जाँचें। यह सैंडबॉक्स मोड और यह दर्ज करता है कि अनुमति या निषेध नियम ने टूल को अवरुद्ध किया था या नहीं।

​

“मुझे लगा कि यह मुख्य सत्र था, फिर यह सैंडबॉक्स में क्यों है?”

​

संबंधित

• सैंडबॉक्सिंग — सैंडबॉक्स का पूर्ण संदर्भ (मोड, दायरे, बैकएंड, इमेज)
• मल्टी-एजेंट सैंडबॉक्स और टूल — प्रति-एजेंट ओवरराइड और प्राथमिकता
• उन्नत मोड