कॉन्फ़िगरेशन संदर्भ

• openclaw config schema सत्यापन और Control UI के लिए उपयोग की जाने वाली लाइव JSON Schema प्रिंट करता है, जिसमें बंडल किए गए/Plugin/चैनल मेटाडेटा मर्ज होते हैं।
• कॉन्फ़िगरेशन संपादित करने से पहले एजेंटों को किसी एक सटीक पथ-स्कोप्ड स्कीमा नोड के लिए gateway टूल ऐक्शन config.schema.lookup को कॉल करना चाहिए।
• pnpm config:docs:check / pnpm config:docs:gen वर्तमान स्कीमा सतह के विरुद्ध इस दस्तावेज़ के बेसलाइन हैश को सत्यापित करते हैं।

• memory.search.*, memory.qmd.*, memory.citations और plugins.entries.memory-core.config.dreaming के अंतर्गत Dreaming कॉन्फ़िगरेशन के लिए मेमोरी कॉन्फ़िगरेशन संदर्भ।
• वर्तमान अंतर्निहित + बंडल किए गए कमांड कैटलॉग के लिए स्लैश कमांड।
• चैनल-विशिष्ट कमांड सतहों के लिए स्वामी चैनल/Plugin पृष्ठ।

​

चैनल

​

एजेंट डिफ़ॉल्ट, बहु-एजेंट, सत्र और संदेश

• agents.defaults.* (वर्कस्पेस, मॉडल, चिंतन, Heartbeat, मेमोरी, मीडिया, Skills, सैंडबॉक्स)
• multiAgent.* (बहु-एजेंट रूटिंग और बाइंडिंग)
• session.* (सत्र जीवनचक्र, Compaction, प्रूनिंग)
• messages.* (संदेश डिलीवरी, TTS, Markdown रेंडरिंग)
• talk.* (Talk मोड)
  • talk.consultThinkingLevel: Control UI Talk के रीयलटाइम परामर्श के पीछे चलने वाले पूर्ण OpenClaw एजेंट रन के लिए चिंतन स्तर ओवरराइड
  • talk.consultFastMode: Control UI Talk रीयलटाइम परामर्शों के लिए एक-बार का फ़ास्ट-मोड ओवरराइड
  • talk.speechLocale: Android, iOS और macOS पर Talk वाक् पहचान के लिए वैकल्पिक BCP 47 लोकेल आईडी
  • talk.silenceTimeoutMs: सेट न होने पर, Talk ट्रांसक्रिप्ट भेजने से पहले प्लेटफ़ॉर्म की डिफ़ॉल्ट विराम अवधि बनाए रखता है (700 ms on macOS and Android, 900 ms on iOS)
  • talk.realtime.consultRouting: openclaw_agent_consult को छोड़ने वाले अंतिम रूप दिए गए रीयलटाइम Talk ट्रांसक्रिप्ट के लिए Gateway रिले फ़ॉलबैक

​

टूल और कस्टम प्रदाता

​

मॉडल

{
  models: {
    // वैकल्पिक। डिफ़ॉल्ट: true। बदलने पर Gateway पुनः आरंभ करना आवश्यक है।
    pricing: { enabled: false },
  },
}

• models.mode: प्रदाता कैटलॉग व्यवहार (merge या replace)।
• models.providers: प्रदाता आईडी द्वारा कुंजीबद्ध कस्टम प्रदाता मैप।
• models.providers.*.localService: स्थानीय मॉडल सर्वरों के लिए वैकल्पिक ऑन-डिमांड प्रक्रिया प्रबंधक। OpenClaw कॉन्फ़िगर किए गए स्वास्थ्य एंडपॉइंट की जाँच करता है, आवश्यकता होने पर निरपेक्ष command शुरू करता है, तत्परता की प्रतीक्षा करता है और फिर मॉडल अनुरोध भेजता है। स्थानीय मॉडल सेवाएँ देखें।
• models.pricing.enabled: साइडकार और चैनलों के Gateway तैयार पथ तक पहुँचने के बाद शुरू होने वाले पृष्ठभूमि मूल्य निर्धारण बूटस्ट्रैप को नियंत्रित करता है। जब false हो, तो Gateway OpenRouter और LiteLLM मूल्य निर्धारण-कैटलॉग फ़ेच छोड़ देता है; कॉन्फ़िगर किए गए models.providers.*.models[].cost मान स्थानीय लागत अनुमानों के लिए फिर भी काम करते हैं।

​

MCP

{
  mcp: {
    servers: {
      docs: {
        command: "npx",
        args: ["-y", "@modelcontextprotocol/server-fetch"],
      },
      remote: {
        url: "https://example.com/mcp",
        transport: "streamable-http", // streamable-http | sse
        requestTimeoutMs: 20000,
        connectionTimeoutMs: 5000,
        supportsParallelToolCalls: true,
        headers: {
          Authorization: "Bearer ${MCP_REMOTE_TOKEN}",
        },
        auth: "oauth",
        oauth: {
          scope: "docs.read",
        },
        sslVerify: true,
        clientCert: "/path/to/client.crt",
        clientKey: "/path/to/client.key",
        toolFilter: {
          include: ["search_*"],
          exclude: ["admin_*"],
        },
        // वैकल्पिक Codex app-server प्रोजेक्शन नियंत्रण।
        codex: {
          agents: ["main"],
          defaultToolsApprovalMode: "approve", // auto | prompt | approve
        },
      },
    },
  },
}

• mcp.servers: कॉन्फ़िगर किए गए MCP टूल उपलब्ध कराने वाले रनटाइम के लिए नामित stdio या रिमोट MCP सर्वर परिभाषाएँ। रिमोट प्रविष्टियाँ transport: "streamable-http" या transport: "sse" का उपयोग करती हैं; type: "http" एक CLI-मूल उपनाम है जिसे openclaw mcp set और openclaw doctor --fix कैनोनिकल transport फ़ील्ड में सामान्यीकृत करते हैं।
• mcp.servers.<name>.enabled: सहेजी गई सर्वर परिभाषा को बनाए रखते हुए उसे एम्बेडेड OpenClaw MCP खोज और टूल प्रोजेक्शन से बाहर रखने के लिए false सेट करें।
• mcp.servers.<name>.requestTimeoutMs: प्रति-सर्वर MCP अनुरोध टाइमआउट, मिलीसेकंड में।
• mcp.servers.<name>.connectionTimeoutMs: प्रति-सर्वर कनेक्शन टाइमआउट, मिलीसेकंड में।
• mcp.servers.<name>.supportsParallelToolCalls: उन अडैप्टरों के लिए वैकल्पिक समवर्तीता संकेत जो यह चुन सकते हैं कि समानांतर MCP टूल कॉल जारी किए जाएँ या नहीं।
• mcp.servers.<name>.auth: OAuth की आवश्यकता वाले HTTP MCP सर्वरों के लिए "oauth" सेट करें। OpenClaw स्थिति के अंतर्गत टोकन संग्रहीत करने के लिए openclaw mcp login <name> चलाएँ।
• mcp.servers.<name>.oauth: वैकल्पिक OAuth स्कोप, रीडायरेक्ट URL और क्लाइंट मेटाडेटा URL ओवरराइड।
• mcp.servers.<name>.sslVerify, clientCert, clientKey: निजी एंडपॉइंट और पारस्परिक TLS के लिए HTTP TLS नियंत्रण।
• mcp.servers.<name>.toolFilter: वैकल्पिक प्रति-सर्वर टूल चयन। include खोजे गए MCP टूल को मेल खाने वाले नामों तक सीमित करता है; exclude मेल खाने वाले नामों को छिपाता है। प्रविष्टियाँ सटीक MCP टूल नाम या सरल * ग्लॉब होती हैं। संसाधन या प्रॉम्प्ट वाले सर्वर उपयोगिता टूल नाम भी उत्पन्न करते हैं (resources_list, resources_read, prompts_list, prompts_get) और उन नामों पर भी यही फ़िल्टर लागू होता है।
• mcp.servers.<name>.codex: वैकल्पिक Codex app-server प्रोजेक्शन नियंत्रण। यह ब्लॉक केवल Codex app-server थ्रेड के लिए OpenClaw मेटाडेटा है; यह ACP सत्रों, सामान्य Codex हार्नेस कॉन्फ़िगरेशन या अन्य रनटाइम अडैप्टर को प्रभावित नहीं करता। गैर-रिक्त codex.agents सर्वर को सूचीबद्ध OpenClaw एजेंट आईडी तक सीमित करता है। खाली, रिक्त या अमान्य स्कोप्ड एजेंट सूचियाँ कॉन्फ़िगरेशन सत्यापन द्वारा अस्वीकार की जाती हैं और वैश्विक बनने के बजाय रनटाइम प्रोजेक्शन पथ से छोड़ दी जाती हैं। codex.defaultToolsApprovalMode उस सर्वर के लिए Codex का मूल default_tools_approval_mode उत्सर्जित करता है। मूल mcp_servers कॉन्फ़िगरेशन Codex को भेजने से पहले OpenClaw codex ब्लॉक हटा देता है। Codex के डिफ़ॉल्ट MCP अनुमोदन व्यवहार के साथ प्रत्येक Codex app-server एजेंट के लिए सर्वर को प्रोजेक्टेड रखने हेतु ब्लॉक छोड़ दें।
• सत्र-स्कोप्ड बंडल किए गए MCP रनटाइम अंतर्निहित 10-मिनट निष्क्रिय TTL का उपयोग करते हैं। एक-बार के एम्बेडेड रन, रन समाप्ति पर क्लीनअप का अनुरोध करते हैं; TTL दीर्घजीवी सत्रों और भविष्य के कॉलरों के लिए सुरक्षा उपाय है।
• mcp.* के अंतर्गत बदलाव कैश किए गए सत्र MCP रनटाइम को निस्तारित करके तुरंत लागू होते हैं। अगली टूल खोज/उपयोग उन्हें नए कॉन्फ़िगरेशन से पुनः बनाती है, इसलिए हटाई गई mcp.servers प्रविष्टियाँ निष्क्रिय TTL की प्रतीक्षा करने के बजाय तुरंत साफ़ हो जाती हैं।
• रनटाइम खोज उस सत्र के कैश किए गए कैटलॉग को हटाकर MCP टूल-सूची परिवर्तन सूचनाओं का भी सम्मान करती है। संसाधन या प्रॉम्प्ट घोषित करने वाले सर्वरों को संसाधनों को सूचीबद्ध/पढ़ने और प्रॉम्प्ट को सूचीबद्ध/प्राप्त करने के लिए उपयोगिता टूल मिलते हैं। बार-बार टूल-कॉल विफलताएँ एक और कॉल का प्रयास करने से पहले प्रभावित सर्वर को कुछ समय के लिए रोक देती हैं।

​

Skills

{
  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills"],
      allowSymlinkTargets: ["~/Projects/manager/skills"],
    },
    install: {
      preferBrew: true,
      nodeManager: "npm", // npm | pnpm | yarn | bun
      allowUploadedArchives: false,
    },
    workshop: {
      allowSymlinkTargetWrites: false,
    },
    entries: {
      "image-lab": {
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // या प्लेनटेक्स्ट स्ट्रिंग
        env: { GEMINI_API_KEY: "GEMINI_KEY_HERE" },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

• allowBundled: केवल बंडल किए गए Skills के लिए वैकल्पिक अनुमत-सूची (प्रबंधित/वर्कस्पेस Skills अप्रभावित रहते हैं)।
• load.extraDirs: अतिरिक्त साझा Skill रूट (सबसे कम प्राथमिकता)।
• load.allowSymlinkTargets: विश्वसनीय वास्तविक लक्ष्य रूट जिनमें Skill सिमलिंक रिज़ॉल्व हो सकते हैं, जब लिंक उसके कॉन्फ़िगर किए गए स्रोत रूट से बाहर हो।
• workshop.allowSymlinkTargetWrites: Skill Workshop के लागू करने की प्रक्रिया को पहले से विश्वसनीय सिमलिंक लक्ष्यों के माध्यम से लिखने की अनुमति देता है (डिफ़ॉल्ट: false)।
• install.preferBrew: true होने पर, अन्य इंस्टॉलर प्रकारों पर वापस जाने से पहले brew उपलब्ध होने पर Homebrew इंस्टॉलर को प्राथमिकता दें।
• install.nodeManager: metadata.openclaw.install विनिर्देशों के लिए Node इंस्टॉलर प्राथमिकता (npm | pnpm | yarn | bun)।
• install.allowUploadedArchives: विश्वसनीय operator.admin Gateway क्लाइंट को skills.upload.* के माध्यम से स्टेज किए गए निजी zip अभिलेख स्थापित करने की अनुमति देता है (डिफ़ॉल्ट: false)। यह केवल अपलोड किए गए अभिलेख का पथ सक्षम करता है; सामान्य ClawHub इंस्टॉलेशन के लिए इसकी आवश्यकता नहीं होती।
• entries.<skillKey>.enabled: false किसी Skill को बंडल/इंस्टॉल होने पर भी अक्षम करता है।
• entries.<skillKey>.apiKey: प्राथमिक एनवायरनमेंट वेरिएबल घोषित करने वाले Skills के लिए सुविधा (प्लेनटेक्स्ट स्ट्रिंग या SecretRef ऑब्जेक्ट)।
• limits.maxCandidatesPerRoot, limits.maxSkillsLoadedPerSource, limits.maxSkillsInPrompt, limits.maxSkillsPromptChars, limits.maxSkillFileBytes: Skill खोज और मॉडल-सामना करने वाले Skills प्रॉम्प्ट को सीमित करते हैं।
• Skill Workshop की स्वायत्तता/अनुमोदन सेटिंग्स (workshop.autonomous.enabled, workshop.approvalPolicy, workshop.maxPending, workshop.maxSkillBytes) Skills कॉन्फ़िगरेशन में प्रलेखित हैं।

​

Plugins

{
  plugins: {
    enabled: true,
    allow: ["voice-call"],
    deny: [],
    load: {
      paths: ["~/Projects/oss/voice-call-plugin"],
    },
    entries: {
      "voice-call": {
        enabled: true,
        hooks: {
          allowPromptInjection: false,
        },
        config: { provider: "twilio" },
      },
    },
  },
}

• ~/.openclaw/extensions और <workspace>/.openclaw/extensions के अंतर्गत पैकेज या बंडल निर्देशिकाओं से, साथ ही plugins.load.paths में सूचीबद्ध फ़ाइलों या निर्देशिकाओं से लोड किया जाता है।
• स्वतंत्र Plugin फ़ाइलों को plugins.load.paths में रखें; स्वतः खोजे गए एक्सटेंशन रूट शीर्ष-स्तरीय .js, .mjs, और .ts फ़ाइलों को अनदेखा करते हैं, ताकि उन रूट में मौजूद सहायक स्क्रिप्ट स्टार्टअप को अवरुद्ध न करें।
• खोज मूल OpenClaw plugins के साथ संगत Codex बंडल और Claude बंडल भी स्वीकार करती है, जिनमें मैनिफ़ेस्ट-रहित Claude डिफ़ॉल्ट-लेआउट बंडल शामिल हैं।
• कॉन्फ़िगरेशन परिवर्तनों के लिए Gateway को पुनः आरंभ करना आवश्यक है।
• allow: वैकल्पिक अनुमति-सूची (केवल सूचीबद्ध plugins लोड होते हैं)। deny को प्राथमिकता मिलती है।
• plugins.entries.<id>.apiKey: Plugin-स्तरीय API कुंजी का सुविधाजनक फ़ील्ड (जब Plugin इसका समर्थन करता हो)।
• plugins.entries.<id>.env: Plugin-स्कोप वाला पर्यावरण चर मैप।
• plugins.entries.<id>.hooks.allowPromptInjection: जब false हो, तब कोर before_prompt_build जैसे प्रॉम्प्ट बदलने वाले हुक को अवरुद्ध करता है। यह मूल Plugin हुक और समर्थित बंडल द्वारा प्रदान की गई हुक निर्देशिकाओं पर लागू होता है।
• plugins.entries.<id>.hooks.allowConversationAccess: जब true हो, तब विश्वसनीय गैर-बंडल plugins llm_input, llm_output, before_model_resolve, before_agent_reply, before_agent_run, before_agent_finalize, और agent_end जैसे टाइप किए गए हुक से अपरिष्कृत वार्तालाप सामग्री पढ़ सकते हैं।
• plugins.entries.<id>.subagent.allowModelOverride: पृष्ठभूमि सबएजेंट रन के लिए प्रति-रन provider और model ओवरराइड का अनुरोध करने हेतु इस Plugin पर स्पष्ट रूप से भरोसा करें।
• plugins.entries.<id>.subagent.allowedModels: विश्वसनीय सबएजेंट ओवरराइड के लिए मानक provider/model लक्ष्यों की वैकल्पिक अनुमति-सूची। "*" का उपयोग केवल तभी करें, जब आप जानबूझकर किसी भी मॉडल को अनुमति देना चाहते हों।
• plugins.entries.<id>.llm.allowModelOverride: api.runtime.llm.complete के लिए मॉडल ओवरराइड का अनुरोध करने हेतु इस Plugin पर स्पष्ट रूप से भरोसा करें।
• plugins.entries.<id>.llm.allowedModels: विश्वसनीय Plugin LLM पूर्णता ओवरराइड के लिए मानक provider/model लक्ष्यों की वैकल्पिक अनुमति-सूची। "*" का उपयोग केवल तभी करें, जब आप जानबूझकर किसी भी मॉडल को अनुमति देना चाहते हों।
• plugins.entries.<id>.llm.allowAgentIdOverride: किसी गैर-डिफ़ॉल्ट एजेंट आईडी के लिए api.runtime.llm.complete चलाने हेतु इस Plugin पर स्पष्ट रूप से भरोसा करें।
• plugins.entries.<id>.config: Plugin द्वारा परिभाषित कॉन्फ़िगरेशन ऑब्जेक्ट (उपलब्ध होने पर मूल OpenClaw Plugin स्कीमा द्वारा सत्यापित)।
• चैनल Plugin खाते/रनटाइम की सेटिंग्स channels.<id> के अंतर्गत रहती हैं और उनका वर्णन किसी केंद्रीय OpenClaw विकल्प रजिस्ट्री के बजाय स्वामी Plugin के मैनिफ़ेस्ट की channelConfigs मेटाडेटा द्वारा किया जाना चाहिए।

​

Codex हार्नेस Plugin कॉन्फ़िगरेशन

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          codexPlugins: {
            enabled: true,
            allow_all_plugins: true,
            allow_destructive_actions: "auto",
            plugins: {
              "google-calendar": {
                enabled: true,
                marketplaceName: "openai-curated",
                pluginName: "google-calendar",
                allow_destructive_actions: false,
              },
            },
          },
        },
      },
    },
  },
}

• plugins.entries.codex.config.codexPlugins.enabled: Codex हार्नेस के लिए मूल Codex Plugin/ऐप समर्थन सक्षम करता है। डिफ़ॉल्ट: false।
• plugins.entries.codex.config.codexPlugins.allow_all_plugins: प्रमाणित Codex खाते से जुड़ा प्रत्येक वर्तमान में सुलभ ऐप, हर नए मूल Codex थ्रेड में उपलब्ध कराता है। डिफ़ॉल्ट: false।
• plugins.entries.codex.config.codexPlugins.allow_destructive_actions: कॉन्फ़िगर किए गए Plugin ऐप अनुरोधों के लिए डिफ़ॉल्ट विनाशकारी-कार्रवाई नीति। सुरक्षित Codex अनुमोदन स्कीमा को बिना पूछे स्वीकार करने के लिए true, उन्हें अस्वीकार करने के लिए false, Codex द्वारा आवश्यक अनुमोदनों को OpenClaw Plugin अनुमोदनों के माध्यम से भेजने के लिए "auto", या स्थायी अनुमोदन के बिना प्रत्येक Plugin लेखन/विनाशकारी कार्रवाई के लिए पूछने हेतु "ask" का उपयोग करें। "ask" मोड प्रभावित ऐप के लिए स्थायी Codex प्रति-टूल अनुमोदन ओवरराइड साफ़ करता है और Codex थ्रेड आरंभ होने से पहले उस ऐप के लिए मानव अनुमोदन समीक्षक चुनता है। डिफ़ॉल्ट: true।
• plugins.entries.codex.config.codexPlugins.plugins.<key>.enabled: वैश्विक codexPlugins.enabled भी सत्य होने पर कॉन्फ़िगर की गई Plugin प्रविष्टि सक्षम करता है। स्पष्ट प्रविष्टियों के लिए डिफ़ॉल्ट: true।
• plugins.entries.codex.config.codexPlugins.plugins.<key>.marketplaceName: स्थिर मार्केटप्लेस पहचान, प्रत्येक हल की गई प्रविष्टि के लिए pluginName के साथ आवश्यक। "openai-curated" और "workspace-directory" का समर्थन करता है। जिन प्रविष्टियों में कोई भी पहचान फ़ील्ड अनुपस्थित हो, उन्हें अनदेखा कर दिया जाता है।
• plugins.entries.codex.config.codexPlugins.plugins.<key>.pluginName: स्थिर Codex Plugin पहचान, marketplaceName के साथ आवश्यक। किसी workspace-directory प्रविष्टि को plugin/list द्वारा लौटाया गया ठीक वही मार्केटप्लेस-योग्य summary.id उपयोग करना होगा, उदाहरण के लिए "example-plugin@workspace-directory"।
• plugins.entries.codex.config.codexPlugins.plugins.<key>.allow_destructive_actions: प्रति-Plugin विनाशकारी-कार्रवाई ओवरराइड। इसे छोड़ने पर वैश्विक allow_destructive_actions मान का उपयोग होता है। प्रति-Plugin मान समान true, false, "auto", या "ask" नीतियाँ स्वीकार करता है।

• plugins.entries.firecrawl.config.webFetch: Firecrawl वेब-फ़ेच प्रदाता सेटिंग्स।
  • apiKey: अधिक सीमाओं के लिए वैकल्पिक Firecrawl API कुंजी (SecretRef स्वीकार करती है)। उपलब्ध न होने पर plugins.entries.firecrawl.config.webSearch.apiKey या FIRECRAWL_API_KEY पर्यावरण चर का उपयोग करती है।
  • baseUrl: Firecrawl API आधार URL (डिफ़ॉल्ट: https://api.firecrawl.dev; स्वयं-होस्ट किए गए ओवरराइड को निजी/आंतरिक एंडपॉइंट लक्षित करने होंगे)।
  • onlyMainContent: पृष्ठों से केवल मुख्य सामग्री निकालें (डिफ़ॉल्ट: true)।
  • maxAgeMs: मिलीसेकंड में अधिकतम कैश आयु (डिफ़ॉल्ट: 172800000 / 2 दिन)।
  • timeoutSeconds: सेकंड में स्क्रेप अनुरोध समय-समाप्ति (डिफ़ॉल्ट: 60)।
• plugins.entries.xai.config.xSearch: xAI X Search (Grok वेब खोज) सेटिंग्स।
  • enabled: X Search प्रदाता सक्षम करें।
  • model: खोज के लिए उपयोग किया जाने वाला Grok मॉडल (उदा. "grok-4.3")।
• plugins.entries.memory-core.config.dreaming: मेमोरी Dreaming सेटिंग्स। चरणों और सीमाओं के लिए Dreaming देखें।
  • enabled: मुख्य Dreaming स्विच (डिफ़ॉल्ट false)।
  • frequency: प्रत्येक पूर्ण Dreaming स्वीप के लिए Cron आवृत्ति (डिफ़ॉल्ट रूप से "0 3 * * *")।
  • model: वैकल्पिक Dream Diary सबएजेंट मॉडल ओवरराइड। इसके लिए plugins.entries.memory-core.subagent.allowModelOverride: true आवश्यक है; लक्ष्यों को सीमित करने के लिए इसे allowedModels के साथ जोड़ें। मॉडल-अनुपलब्ध त्रुटियों पर सत्र के डिफ़ॉल्ट मॉडल से एक बार पुनः प्रयास किया जाता है; विश्वास या अनुमति-सूची विफलताओं पर बिना बताए फ़ॉलबैक नहीं होता।
  • चरण नीति और सीमाएँ कार्यान्वयन विवरण हैं (उपयोगकर्ता-सामना करने वाली कॉन्फ़िगरेशन कुंजियाँ नहीं)।
• पूर्ण मेमोरी कॉन्फ़िगरेशन मेमोरी कॉन्फ़िगरेशन संदर्भ में उपलब्ध है:
  • memory.search.*
  • agents.entries.*.memory.search.* प्रति-एजेंट ओवरराइड के लिए
  • memory.backend
  • memory.citations
  • memory.qmd.*
  • plugins.entries.memory-core.config.dreaming
• सक्षम Claude बंडल plugins settings.json से अंतर्निहित OpenClaw डिफ़ॉल्ट भी प्रदान कर सकते हैं; OpenClaw उन्हें अपरिष्कृत OpenClaw कॉन्फ़िगरेशन पैच के रूप में नहीं, बल्कि परिशोधित एजेंट सेटिंग्स के रूप में लागू करता है।
• plugins.slots.memory: सक्रिय मेमोरी Plugin आईडी चुनें, या मेमोरी plugins अक्षम करने के लिए "none" चुनें।
• plugins.slots.contextEngine: सक्रिय संदर्भ इंजन Plugin आईडी चुनें; जब तक आप कोई अन्य इंजन इंस्टॉल और चयन नहीं करते, इसका डिफ़ॉल्ट "legacy" होता है।

​

ब्राउज़र

{
  browser: {
    enabled: true,
    evaluateEnabled: true,
    defaultProfile: "user",
    ssrfPolicy: {
      // dangerouslyAllowPrivateNetwork: true, // opt in only for trusted private-network access
      // allowPrivateNetwork: true, // legacy alias
      // hostnameAllowlist: ["*.example.com", "example.com"],
      // allowedHostnames: ["localhost"],
    },
    tabCleanup: {
      enabled: true,
      idleMinutes: 120,
      maxTabsPerSession: 8,
      sweepMinutes: 5,
    },
    profiles: {
      openclaw: { cdpPort: 18800, color: "#FF4500" },
      work: {
        cdpPort: 18801,
        color: "#0066CC",
        executablePath: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
      },
      user: { driver: "existing-session", attachOnly: true, color: "#00AA00" },
      brave: {
        driver: "existing-session",
        attachOnly: true,
        userDataDir: "~/Library/Application Support/BraveSoftware/Brave-Browser",
        color: "#FB542B",
      },
      remote: { cdpUrl: "http://10.0.0.42:9222", color: "#00AA00" },
    },
    color: "#FF4500",
    // headless: false,
    // noSandbox: false,
    // extraArgs: [],
    // executablePath: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
    // attachOnly: false,
  },
}

• evaluateEnabled: false, act:evaluate और wait --fn को अक्षम करता है।
• tabCleanup, निष्क्रिय समय के बाद या किसी सत्र के अपनी सीमा से अधिक होने पर ट्रैक किए गए प्राथमिक-एजेंट टैब की यथासंभव आवधिक सफ़ाई नियंत्रित करता है। ट्रैकिंग केवल ब्राउज़र टूल action: "open" द्वारा बनाए गए टैब पर लागू होती है; उपयोगकर्ता द्वारा खोले गए या अज्ञात स्वामित्व वाले टैब कभी नहीं अपनाए जाते। tabCleanup को अक्षम करने से स्पष्ट सत्र जीवनचक्र सफ़ाई अक्षम नहीं होती।
• स्थिर नेटिव CDP लक्ष्य और ब्राउज़र पहचान वाले होस्ट-स्थानीय ओपन साझा SQLite स्थिति में संग्रहीत होते हैं और Gateway के पुनः आरंभ होने पर भी /new तथा सत्र जीवनचक्र सफ़ाई के लिए पात्र बने रहते हैं। नेटिव टूल-संबंधी CDP लक्ष्य भी पुनः आरंभ होने के बाद निष्क्रियता और सीमा सफ़ाई के लिए पात्र बने रहते हैं। Chrome MCP प्रक्रिया-स्थानीय लक्ष्य हैंडल का उपयोग करता है, इसलिए पुराने मौजूदा-सत्र रिकॉर्ड पुनः आरंभ के बाद ऐसी गतिविधि पर निष्क्रियता स्वीप का जोखिम उठाने के बजाय जीवनचक्र सफ़ाई की प्रतीक्षा करते हैं जिसका किसी से संबंध निर्धारित नहीं किया जा सकता। OpenClaw बंद करने से पहले प्रोफ़ाइल और ब्राउज़र इंस्टेंस को सत्यापित करता है। Chrome MCP स्वतः-कनेक्ट, अनुपलब्ध /json/version ब्राउज़र पहचान और अनसुलझे नेटिव लक्ष्य पूरी तरह प्रक्रिया-स्थानीय रहते हैं, इसलिए पुनः आरंभ के बाद वे अपने-आप बंद नहीं किए जाते। पुराने गैर-ट्रैक किए गए टैब को मैन्युअल रूप से बंद करना आवश्यक है। अस्थायी विफलताएँ बाद में पुनः प्रयास के लिए लंबित रहती हैं। देखें टैब सफ़ाई का स्वामित्व।
• ssrfPolicy.dangerouslyAllowPrivateNetwork सेट न होने पर अक्षम रहता है, इसलिए ब्राउज़र नेविगेशन डिफ़ॉल्ट रूप से सख़्त रहता है।
• ssrfPolicy.dangerouslyAllowPrivateNetwork: true केवल तभी सेट करें जब आप जानबूझकर निजी-नेटवर्क ब्राउज़र नेविगेशन पर भरोसा करते हों।
• सख़्त मोड में, रिमोट CDP प्रोफ़ाइल एंडपॉइंट (profiles.*.cdpUrl) पहुँच-योग्यता/खोज जाँचों के दौरान उसी निजी-नेटवर्क अवरोधन के अधीन होते हैं।
• ssrfPolicy.allowPrivateNetwork एक लीगेसी उपनाम के रूप में समर्थित रहता है।
• सख़्त मोड में, स्पष्ट अपवादों के लिए ssrfPolicy.hostnameAllowlist और ssrfPolicy.allowedHostnames का उपयोग करें।
• रिमोट प्रोफ़ाइल केवल अटैच करने योग्य हैं (आरंभ/रोकना/रीसेट अक्षम हैं)।
• profiles.*.cdpUrl, http://, https://, ws:// और wss:// स्वीकार करता है। जब आप चाहते हैं कि OpenClaw /json/version खोजे, तब HTTP(S) का उपयोग करें; जब आपका प्रदाता आपको सीधा DevTools WebSocket URL देता है, तब WS(S) का उपयोग करें।
• यदि कोई बाहरी रूप से प्रबंधित CDP सेवा लूपबैक के माध्यम से पहुँच योग्य है, तो उस प्रोफ़ाइल का attachOnly: true सेट करें; अन्यथा OpenClaw लूपबैक पोर्ट को स्थानीय प्रबंधित ब्राउज़र प्रोफ़ाइल मानता है और स्थानीय पोर्ट स्वामित्व त्रुटियाँ रिपोर्ट कर सकता है।
• existing-session प्रोफ़ाइल CDP के बजाय Chrome MCP का उपयोग करती हैं और चयनित होस्ट पर या कनेक्टेड ब्राउज़र Node के माध्यम से अटैच हो सकती हैं।
• existing-session प्रोफ़ाइल Brave या Edge जैसी किसी विशिष्ट Chromium-आधारित ब्राउज़र प्रोफ़ाइल को लक्षित करने के लिए userDataDir सेट कर सकती हैं।
• existing-session प्रोफ़ाइल cdpUrl सेट कर सकती हैं जब Chrome पहले से DevTools HTTP(S) खोज एंडपॉइंट या सीधे WS(S) एंडपॉइंट के पीछे चल रहा हो। उस मोड में OpenClaw स्वतः-कनेक्ट का उपयोग करने के बजाय एंडपॉइंट को Chrome MCP को देता है; Chrome MCP लॉन्च आर्ग्युमेंट के लिए userDataDir को अनदेखा किया जाता है।
• existing-session प्रोफ़ाइल वर्तमान Chrome MCP रूट सीमाएँ बनाए रखती हैं: CSS चयनकर्ता लक्ष्यीकरण के बजाय स्नैपशॉट/रेफ़रेंस-आधारित क्रियाएँ, एक-फ़ाइल अपलोड हुक, कोई डायलॉग टाइमआउट ओवरराइड नहीं, कोई wait --load networkidle नहीं, और कोई responsebody, PDF निर्यात, डाउनलोड इंटरसेप्शन या बैच क्रियाएँ नहीं।
• स्थानीय प्रबंधित openclaw प्रोफ़ाइल स्वतः cdpPort और cdpUrl निर्धारित करती हैं; cdpUrl को स्पष्ट रूप से केवल रिमोट CDP प्रोफ़ाइल या मौजूदा-सत्र एंडपॉइंट अटैच के लिए सेट करें।
• स्थानीय प्रबंधित प्रोफ़ाइल उस प्रोफ़ाइल के लिए वैश्विक browser.executablePath को ओवरराइड करने हेतु executablePath सेट कर सकती हैं। इसका उपयोग एक प्रोफ़ाइल को Chrome में और दूसरी को Brave में चलाने के लिए करें।
• स्वतः-पहचान क्रम: यदि डिफ़ॉल्ट ब्राउज़र Chromium-आधारित हो → Chrome → Brave → Edge → Chromium → Chrome Canary।
• browser.executablePath और browser.profiles.<name>.executablePath दोनों Chromium लॉन्च से पहले आपके OS होम डायरेक्टरी के लिए ~ और ~/... स्वीकार करते हैं। existing-session प्रोफ़ाइल पर प्रति-प्रोफ़ाइल userDataDir में भी टिल्ड का विस्तार किया जाता है।
• नियंत्रण सेवा: केवल लूपबैक (पोर्ट gateway.port से प्राप्त होता है, डिफ़ॉल्ट 18791)।
• extraArgs स्थानीय Chromium स्टार्टअप में अतिरिक्त लॉन्च फ़्लैग जोड़ता है (उदाहरण के लिए --disable-gpu, विंडो आकार निर्धारण या डीबग फ़्लैग)।

​

UI

{
  ui: {
    seamColor: "#FF4500",
    assistant: {
      name: "OpenClaw",
      avatar: "CB", // इमोजी, छोटा टेक्स्ट, इमेज URL या डेटा URI
    },
    prefs: {
      theme: "claw", // claw | knot | dash | custom
      themeMode: "system", // light | dark | system
      locale: "en",
      chatShowThinking: true,
      chatShowToolCalls: true,
      chatPersistCommentary: true, // रन के बाद Control UI में टिप्पणी बनाए रखें; इसे चैनलों पर वितरित नहीं करता
      chatSendShortcut: "enter", // enter | modifier-enter
      chatFollowUpMode: "steer", // steer | queue; सर्वर क्यू मोड का उपयोग करने के लिए इसे छोड़ दें
      showAdvancedSettings: false, // Settings में प्रत्येक Advanced समूह का विस्तार करें
    },
  },
}

• seamColor: नेटिव ऐप UI क्रोम के लिए एक्सेंट रंग (Talk Mode बबल टिंट आदि)।
• assistant: Control UI पहचान ओवरराइड। सक्रिय एजेंट पहचान पर फ़ॉलबैक करता है।
• prefs: क्रॉस-डिवाइस ऑपरेटर प्राथमिकताएँ। यह कैनोनिकल स्थान है, ताकि एजेंट अनुमोदन गेट के माध्यम से इन्हें बदल सकें और प्रत्येक Control UI क्लाइंट समन्वयित रहे; ब्राउज़र तुरंत बूट होने के लिए मानों को स्थानीय स्टोरेज में प्रतिबिंबित करते हैं और जब वे कॉन्फ़िगरेशन नहीं लिख सकते (व्यूअर स्कोप, ऑफ़लाइन), तब डिवाइस-स्थानीय प्रति रखते हैं। chatPersistCommentary का डिफ़ॉल्ट true है। इसे false पर सेट करने से रन के दौरान लाइव टिप्पणी दिखाई देती रहती है, लेकिन पूर्ण होने पर हट जाती है और नई Codex टिप्पणी को स्थायी ट्रांसक्रिप्ट मिरर में प्रवेश करने से रोकती है। मैसेजिंग-चैनल वितरण अलग और अपरिवर्तित रहता है। showAdvancedSettings का डिफ़ॉल्ट false है; Settings खोज इस प्राथमिकता को बदले बिना अस्थायी रूप से एक मेल खाने वाला Advanced समूह खोल सकती है। केवल प्रस्तुति से संबंधित प्राथमिकताएँ, जैसे टेक्स्ट स्केल, चैट की चौड़ाई और लाइव साइडबार गतिविधि, ब्राउज़र-स्थानीय रहती हैं और Settings में कॉन्फ़िगर की जाती हैं। कनेक्टेड क्लाइंट सर्वर-साइड परिवर्तनों को लाइव लागू करते हैं: प्रत्येक स्थायी कॉन्फ़िगरेशन लेखन के बाद Gateway केवल-हैश config.changed इवेंट प्रसारित करता है और क्लाइंट अपना स्नैपशॉट रीफ़्रेश करते हैं (जब किसी स्थानीय Settings ड्राफ़्ट में सहेजे न गए संपादन हों, तब इसे छोड़ दिया जाता है)। पुनः कनेक्ट होने वाले क्लाइंट कनेक्ट होते समय मिलान करते हैं।

​

Gateway

{
  gateway: {
    mode: "local", // local | remote
    port: 18789,
    bind: "loopback",
    auth: {
      mode: "token", // none | token | password | trusted-proxy
      token: "your-token",
      // password: "your-password", // या OPENCLAW_GATEWAY_PASSWORD
      // trustedProxy: { userHeader: "x-forwarded-user" }, // mode=trusted-proxy के लिए; /gateway/trusted-proxy-auth देखें
      allowTailscale: true,
      rateLimit: {
        maxAttempts: 10,
        windowMs: 60000,
        lockoutMs: 300000,
        exemptLoopback: true,
      },
    },
    tailscale: {
      mode: "off", // off | serve | funnel
      resetOnExit: false,
    },
    controlUi: {
      enabled: true,
      basePath: "/openclaw",
      // root: "dist/control-ui",
      // toolTitles: false, // टूल कॉल के लिए वैकल्पिक AI उद्देश्य शीर्षक (उपयोगिता-मॉडल टोकन खर्च करता है)
      // embedSandbox: "scripts", // strict | scripts | trusted
      // allowExternalEmbedUrls: false, // ख़तरनाक: पूर्ण बाहरी http(s) एम्बेड URL की अनुमति दें
      // allowedOrigins: ["https://control.example.com"], // गैर-लूपबैक Control UI के लिए आवश्यक
      // dangerouslyAllowHostHeaderOriginFallback: false, // ख़तरनाक Host-header ओरिजिन फ़ॉलबैक मोड
    },
    terminal: {
      enabled: false,
      // shell: "/bin/zsh",
    },
    remote: {
      url: "ws://127.0.0.1:18789",
      transport: "ssh", // ssh | direct
      token: "your-token",
      // password: "your-password",
    },
    trustedProxies: ["10.0.0.1"],
    // वैकल्पिक। डिफ़ॉल्ट false।
    allowRealIpFallback: false,
    nodes: {
      pairing: {
        // वैकल्पिक। डिफ़ॉल्ट रूप से सेट नहीं/अक्षम।
        autoApproveCidrs: ["192.168.1.0/24", "fd00:1234:5678::/64"],
        // SSH-सत्यापित स्वतः-अनुमोदन। डिफ़ॉल्ट: सक्षम (true)।
        // केवल SSH सत्यापन अक्षम करने के लिए false सेट करें; इससे ऊपर दिए गए
        // autoApproveCidrs पर प्रभाव नहीं पड़ता। केवल मैन्युअल Node पेयरिंग के लिए, false सेट करें और
        // autoApproveCidrs को अनसेट करें। समायोजन के लिए ऑब्जेक्ट दें: { user, identity,
        // timeoutMs, cidrs }।
        sshVerify: true,
      },
      commands: {
        allow: ["canvas.navigate"],
        deny: ["system.run"],
      },
    },
    tools: {
      // अतिरिक्त /tools/invoke HTTP निषेध
      deny: ["browser"],
      // स्वामी/व्यवस्थापक कॉलर के लिए डिफ़ॉल्ट HTTP निषेध सूची से टूल हटाएँ
      allow: ["gateway"],
    },
    push: {
      apns: {
        relay: {
          baseUrl: "https://relay.example.com",
          timeoutMs: 10000,
        },
      },
    },
  },
}

​

OpenAI-संगत एंडपॉइंट

• एडमिन HTTP RPC: admin-http-rpc plugin की तरह डिफ़ॉल्ट रूप से बंद है। POST /api/v1/admin/rpc को पंजीकृत करने के लिए plugin सक्षम करें। एडमिन HTTP RPC देखें।
• चैट कम्प्लीशन्स: डिफ़ॉल्ट रूप से अक्षम। gateway.http.endpoints.chatCompletions.enabled: true से सक्षम करें।
• रिस्पॉन्सेज़ API: gateway.http.endpoints.responses.enabled।
• रिस्पॉन्सेज़ URL-इनपुट सुदृढ़ीकरण:
  • gateway.http.endpoints.responses.maxUrlParts
  • gateway.http.endpoints.responses.files.urlAllowlist
  • gateway.http.endpoints.responses.images.urlAllowlist खाली अनुमत-सूचियों को अनसेट माना जाता है; URL फ़ेचिंग अक्षम करने के लिए gateway.http.endpoints.responses.files.allowUrl=false और/या gateway.http.endpoints.responses.images.allowUrl=false का उपयोग करें।
• वैकल्पिक रिस्पॉन्स सुदृढ़ीकरण हेडर:
  • gateway.http.securityHeaders.strictTransportSecurity (केवल आपके नियंत्रण वाले HTTPS ओरिजिन के लिए सेट करें; विश्वसनीय प्रॉक्सी प्रमाणीकरण देखें)

​

बहु-इंस्टेंस पृथक्करण

OPENCLAW_CONFIG_PATH=~/.openclaw/a.json \
OPENCLAW_STATE_DIR=~/.openclaw-a \
openclaw gateway --port 19001

​

gateway.tls

{
  gateway: {
    tls: {
      enabled: false,
      autoGenerate: false,
      certPath: "/etc/openclaw/tls/server.crt",
      keyPath: "/etc/openclaw/tls/server.key",
      caPath: "/etc/openclaw/tls/ca-bundle.crt",
    },
  },
}

• enabled: Gateway लिसनर पर TLS टर्मिनेशन (HTTPS/WSS) सक्षम करता है (डिफ़ॉल्ट: false)।
• autoGenerate: स्पष्ट फ़ाइलें कॉन्फ़िगर न होने पर स्थानीय स्व-हस्ताक्षरित प्रमाणपत्र/कुंजी युग्म स्वतः जनरेट करता है; केवल स्थानीय/डेवलपमेंट उपयोग के लिए।
• certPath: TLS प्रमाणपत्र फ़ाइल का फ़ाइल-सिस्टम पथ।
• keyPath: TLS निजी कुंजी फ़ाइल का फ़ाइल-सिस्टम पथ; अनुमतियाँ प्रतिबंधित रखें।
• caPath: क्लाइंट सत्यापन या कस्टम ट्रस्ट चेन के लिए वैकल्पिक CA बंडल पथ।

​

gateway.reload

{
  gateway: {
    reload: {
      mode: "hybrid", // off | restart | hot | hybrid
      debounceMs: 500,
      deferralTimeoutMs: 300000,
    },
  },
}

• mode: यह नियंत्रित करता है कि कॉन्फ़िगरेशन संपादन रनटाइम पर कैसे लागू किए जाते हैं।
  • "off": लाइव संपादनों को अनदेखा करें; परिवर्तनों के लिए स्पष्ट रीस्टार्ट आवश्यक है।
  • "restart": कॉन्फ़िगरेशन बदलने पर Gateway प्रक्रिया को हमेशा रीस्टार्ट करें।
  • "hot": रीस्टार्ट किए बिना प्रक्रिया के भीतर परिवर्तन लागू करें।
  • "hybrid" (डिफ़ॉल्ट): पहले हॉट रीलोड का प्रयास करें; आवश्यक होने पर रीस्टार्ट पर फ़ॉलबैक करें।
• debounceMs: कॉन्फ़िगरेशन परिवर्तन लागू होने से पहले मिलीसेकंड में डीबाउंस विंडो (गैर-ऋणात्मक पूर्णांक; डिफ़ॉल्ट: 300)।
• deferralTimeoutMs: रीस्टार्ट या चैनल हॉट रीलोड बाध्य करने से पहले जारी ऑपरेशनों की प्रतीक्षा के लिए मिलीसेकंड में वैकल्पिक अधिकतम समय। डिफ़ॉल्ट सीमित प्रतीक्षा (300000) का उपयोग करने के लिए इसे छोड़ दें; अनिश्चितकाल तक प्रतीक्षा करने और समय-समय पर अभी-भी-लंबित चेतावनियाँ लॉग करने के लिए 0 सेट करें।

​

क्लाउड वर्कर परिवेश

​

Crabbox प्रोफ़ाइल

{
  cloudWorkers: {
    profiles: {
      production: {
        provider: "crabbox",
        install: "bundle", // डिफ़ॉल्ट; केवल जारी किए गए Gateway संस्करण के लिए "npm" का उपयोग करें।
        settings: {
          provider: "aws",
          class: "standard",
          ttl: "24h",
          idleTimeout: "60m",
          // वैकल्पिक निरपेक्ष पथ। डिफ़ॉल्ट: सहोदर ../crabbox/bin/crabbox, फिर PATH।
          binary: "/usr/local/bin/crabbox",
        },
        lifetime: {
          idleTimeoutMinutes: 60,
          maxLifetimeMinutes: 1440,
        },
      },
    },
  },
}

• settings.provider (आवश्यक): --provider के माध्यम से भेजा गया Crabbox बैकएंड। ऐसे बैकएंड का उपयोग करें जिसके निरीक्षण आउटपुट में SSH एंडपॉइंट शामिल हो; aws प्रत्यक्ष AWS बैकएंड चुनता है।
• settings.class (आवश्यक): --class को भेजी गई Crabbox मशीन श्रेणी।
• settings.ttl और settings.idleTimeout (आवश्यक): --ttl और --idle-timeout को भेजी गई धनात्मक Go अवधि स्ट्रिंग। ये प्रदाता-पक्षीय विफलता-सुरक्षा उपाय नीचे दी गई OpenClaw की संग्रहीत lifetime नीति से अलग हैं।
• settings.binary: वैकल्पिक निरपेक्ष Crabbox निष्पादन योग्य पथ। इसके बिना, OpenClaw पहले सहोदर Crabbox चेकआउट, फिर PATH पर निष्पादन योग्य प्रविष्टियाँ जाँचता है, और अंत में crabbox चलाता है, ताकि अनुपस्थित CLI एक दृश्यमान प्रदाता त्रुटि बनी रहे।

​

स्थिर SSH डेवलपमेंट प्रोफ़ाइल

{
  cloudWorkers: {
    profiles: {
      development: {
        provider: "static-ssh",
        settings: {
          host: "worker.example.test",
          port: 22,
          user: "openclaw",
          hostKey: "ssh-ed25519 <base64-public-host-key>",
          keyRef: {
            source: "env",
            provider: "default",
            id: "OPENCLAW_WORKER_SSH_KEY",
          },
        },
        lifetime: {
          idleTimeoutMinutes: 60,
          maxLifetimeMinutes: 1440,
        },
      },
    },
  },
}

• profiles: गैर-रिक्त, व्हाइटस्पेस हटाई गई आईडी वाले नामित वर्कर प्रोफ़ाइल। प्रत्येक प्रोफ़ाइल किसी plugin द्वारा पंजीकृत प्रदाता चुनती है।
• provider: गैर-रिक्त वर्कर प्रदाता आईडी। उदाहरण बंडल किए गए crabbox प्रदाता और QA Lab के static-ssh प्रदाता का उपयोग करते हैं।
• install: वर्कर इंस्टॉलेशन विधि। "bundle" (डिफ़ॉल्ट) Gateway के इंस्टॉल किए गए बिल्ड का सामग्री-हैशयुक्त बंडल ट्रांसफ़र करता है और जारी, डेवलपमेंट तथा अजारी संस्करणों का समर्थन करता है। "npm" किसी अपरिवर्तित पैकेज्ड रिलीज़ के लिए ऑप्ट-इन अनुकूलन है; यह सार्वजनिक npm रजिस्ट्री से openclaw@<exact gateway version> इंस्टॉल करता है और कभी भी latest इंस्टॉल नहीं करता।
• कॉन्फ़िगर होने पर बंडल किए गए प्रदाता plugin स्वचालित रूप से चुने जाते हैं, लेकिन स्पष्ट अक्षमता और plugins.allow फिर भी लागू होते हैं। अनुमत-सूची कॉन्फ़िगर होने पर प्रदाता आईडी (उदाहरण के लिए, crabbox) शामिल करें। बाहरी प्रदाता plugin भी इंस्टॉल और स्पष्ट रूप से सक्षम होने चाहिए।
• settings: प्रदाता-स्वामित्व वाला सीमित JSON। चयनित plugin इसकी कुंजियाँ परिभाषित और सत्यापित करता है; सीक्रेट रखने वाले मानों के लिए SecretRef ऑब्जेक्ट का उपयोग करें। स्थिर SSH प्रदाता को host, user, hostKey, और keyRef की आवश्यकता होती है; port का डिफ़ॉल्ट 22 है। hostKey ज्ञात होस्ट या किसी अन्य विश्वसनीय चैनल से प्राप्त एक OpenSSH सार्वजनिक होस्ट-कुंजी पंक्ति (algorithm base64) होनी चाहिए, जिसमें कोई विकल्प उपसर्ग न हो।
• lifetime.idleTimeoutMinutes: बाद की निष्क्रियता-पुनरुद्धार नीति के लिए संग्रहीत धनात्मक पूर्णांक मिनट।
• lifetime.maxLifetimeMinutes: बाद की जीवनचक्र नीति के लिए संग्रहीत धनात्मक पूर्णांक मिनट।

​

हुक

{
  hooks: {
    enabled: true,
    token: "shared-secret",
    path: "/hooks",
    defaultSessionKey: "hook:ingress",
    allowRequestSessionKey: true,
    allowedSessionKeyPrefixes: ["hook:", "hook:gmail:"],
    allowedAgentIds: ["hooks", "main"],
    presets: ["gmail"],
    transformsDir: "~/.openclaw/hooks/transforms",
    mappings: [
      {
        match: { path: "gmail" },
        action: "agent",
        agentId: "hooks",
        wakeMode: "now",
        name: "Gmail",
        sessionKey: "hook:gmail:{{messages[0].id}}",
        messageTemplate: "प्रेषक: {{messages[0].from}}\nविषय: {{messages[0].subject}}\n{{messages[0].snippet}}",
        deliver: true,
        channel: "last",
        model: "openai/gpt-5.6-sol",
      },
    ],
  },
}

• hooks.enabled=true के लिए गैर-रिक्त hooks.token आवश्यक है।
• hooks.token सक्रिय Gateway साझा-सीक्रेट प्रमाणीकरण (gateway.auth.token / OPENCLAW_GATEWAY_TOKEN या gateway.auth.password / OPENCLAW_GATEWAY_PASSWORD) से अलग होना चाहिए; पुनः उपयोग का पता चलने पर स्टार्टअप लॉग एक गैर-घातक सुरक्षा चेतावनी दर्ज करता है।
• openclaw security audit हुक/Gateway प्रमाणीकरण के पुनः उपयोग को एक गंभीर निष्कर्ष के रूप में चिह्नित करता है, जिसमें केवल ऑडिट के समय प्रदान किया गया Gateway पासवर्ड प्रमाणीकरण (--auth password --password <password>) भी शामिल है। स्थायी रूप से सहेजे गए पुनः प्रयुक्त hooks.token को बदलने के लिए openclaw doctor --fix चलाएँ, फिर बाहरी हुक प्रेषकों को नया हुक टोकन उपयोग करने के लिए अपडेट करें।
• hooks.path, / नहीं हो सकता; /hooks जैसे समर्पित उपपथ का उपयोग करें।
• यदि hooks.allowRequestSessionKey=true, तो hooks.allowedSessionKeyPrefixes को सीमित करें (उदाहरण के लिए ["hook:"])।
• यदि कोई मैपिंग या प्रीसेट टेम्पलेट-आधारित sessionKey का उपयोग करता है, तो hooks.allowedSessionKeyPrefixes और hooks.allowRequestSessionKey=true सेट करें। स्थिर मैपिंग कुंजियों के लिए इस स्पष्ट सहमति की आवश्यकता नहीं होती।

• POST /hooks/wake → { text, mode?: "now"|"next-heartbeat" }
• POST /hooks/agent → { message, name?, agentId?, sessionKey?, wakeMode?, deliver?, channel?, to?, model?, thinking?, timeoutSeconds? }
  • अनुरोध पेलोड से sessionKey केवल तभी स्वीकार किया जाता है जब hooks.allowRequestSessionKey=true (डिफ़ॉल्ट: false)।
• POST /hooks/<name> → hooks.mappings के माध्यम से समाधान किया जाता है
  • टेम्पलेट द्वारा रेंडर किए गए मैपिंग sessionKey मानों को बाहरी रूप से प्रदान किया गया माना जाता है और इनके लिए भी hooks.allowRequestSessionKey=true आवश्यक है।

​

Gmail एकीकरण

• अंतर्निहित Gmail प्रीसेट sessionKey: "hook:gmail:{{messages[0].id}}" का उपयोग करता है।
• यह प्रति-संदेश कुंजी वार्तालाप संदर्भ को अलग करती है, टूल या वर्कस्पेस पहुँच को नहीं। agentId सेट करने वाली कस्टम मैपिंग के बिना, प्रीसेट डिफ़ॉल्ट एजेंट का उपयोग करता है।
• अविश्वसनीय इनबॉक्स के लिए, Gmail को एक समर्पित रीडर एजेंट पर रूट करें और उस एजेंट को प्रति-एजेंट सैंडबॉक्स और टूल नीति से सीमित करें। यदि रीडर को मुख्य एजेंट को सूचित करना आवश्यक है, तो हैंडऑफ़ को tools.agentToAgent से सीमित करें। अनुशंसित खतरा मॉडल और मॉडल स्तर के लिए प्रॉम्प्ट इंजेक्शन देखें।
• यदि आप वह प्रति-संदेश रूटिंग बनाए रखते हैं, तो hooks.allowRequestSessionKey: true सेट करें और Gmail नेमस्पेस से मेल खाने के लिए hooks.allowedSessionKeyPrefixes को सीमित करें, उदाहरण के लिए ["hook:", "hook:gmail:"]।
• यदि आपको hooks.allowRequestSessionKey: false की आवश्यकता है, तो टेम्पलेट-आधारित डिफ़ॉल्ट के बजाय स्थिर sessionKey से प्रीसेट को ओवरराइड करें।

{
  hooks: {
    gmail: {
      account: "openclaw@gmail.com",
      topic: "projects/<project-id>/topics/gog-gmail-watch",
      subscription: "gog-gmail-watch-push",
      pushToken: "shared-push-token",
      hookUrl: "http://127.0.0.1:18789/hooks/gmail",
      includeBody: true,
      maxBytes: 20000,
      renewEveryMinutes: 720,
      serve: { bind: "127.0.0.1", port: 8788, path: "/" },
      tailscale: { mode: "funnel", path: "/gmail-pubsub" },
      model: "openai/gpt-5.6-sol",
      thinking: "high",
    },
  },
}

• कॉन्फ़िगर होने पर Gateway बूट के समय gog gmail watch serve को स्वतः प्रारंभ करता है। अक्षम करने के लिए OPENCLAW_SKIP_GMAIL_WATCHER=1 सेट करें।
• Gateway के साथ अलग gog gmail watch serve न चलाएँ।

​

Canvas Plugin होस्ट

{
  plugins: {
    entries: {
      canvas: {
        config: {
          host: {
            root: "~/.openclaw/workspace/canvas",
            liveReload: true,
            // enabled: false, // या OPENCLAW_SKIP_CANVAS_HOST=1
          },
        },
      },
    },
  },
}

• Gateway पोर्ट के अंतर्गत HTTP पर एजेंट द्वारा संपादन योग्य HTML/CSS/JS और A2UI प्रदान करता है:
  • http://<gateway-host>:<gateway.port>/__openclaw__/canvas/
  • http://<gateway-host>:<gateway.port>/__openclaw__/a2ui/
• केवल स्थानीय: gateway.bind: "loopback" बनाए रखें (डिफ़ॉल्ट)।
• गैर-लूपबैक बाइंड: अन्य Gateway HTTP सतहों की तरह canvas रूटों के लिए Gateway प्रमाणीकरण (टोकन/पासवर्ड/विश्वसनीय-प्रॉक्सी) आवश्यक है।
• Node WebView सामान्यतः प्रमाणीकरण हेडर नहीं भेजते; किसी Node के युग्मित और कनेक्ट होने के बाद, Gateway canvas/A2UI पहुँच के लिए Node-स्कोप वाली क्षमता URL घोषित करता है।
• क्षमता URL सक्रिय Node WS सत्र से बंधे होते हैं और शीघ्र समाप्त हो जाते हैं। IP-आधारित फ़ॉलबैक का उपयोग नहीं होता।
• प्रदान किए गए HTML में लाइव-रीलोड क्लाइंट इंजेक्ट करता है।
• खाली होने पर आरंभिक index.html स्वतः बनाता है।
• /__openclaw__/a2ui/ पर A2UI भी प्रदान करता है।
• परिवर्तनों के लिए Gateway पुनः प्रारंभ करना आवश्यक है।
• बड़ी डायरेक्टरियों या EMFILE त्रुटियों के लिए लाइव रीलोड अक्षम करें।

​

खोज

​

mDNS (Bonjour)

{
  discovery: {
    mdns: {
      mode: "minimal", // minimal | full | off
    },
  },
}

• minimal (डिफ़ॉल्ट): TXT रिकॉर्ड से cliPath + sshPort छोड़ें।
• full: cliPath + sshPort शामिल करें; LAN मल्टीकास्ट विज्ञापन के लिए फिर भी बंडल किए गए bonjour Plugin का सक्षम होना आवश्यक है।
• off: Plugin की सक्षम स्थिति बदले बिना LAN मल्टीकास्ट विज्ञापन रोकें।
• बंडल किया गया bonjour Plugin macOS होस्ट पर स्वतः प्रारंभ होता है और Linux, Windows तथा कंटेनरीकृत Gateway परिनियोजनों में वैकल्पिक रूप से सक्षम किया जाता है।
• वैध DNS लेबल होने पर होस्टनाम का डिफ़ॉल्ट सिस्टम होस्टनाम होता है, अन्यथा openclaw उपयोग होता है। OPENCLAW_MDNS_HOSTNAME से ओवरराइड करें।
• OPENCLAW_DISABLE_BONJOUR=1, discovery.mdns.mode को ओवरराइड करके mDNS विज्ञापन को पूर्णतः अक्षम करता है।

​

विस्तृत क्षेत्र (DNS-SD)

{
  discovery: {
    wideArea: { enabled: true },
  },
}

​

परिवेश

​

env (इनलाइन परिवेश चर)

{
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: {
      GROQ_API_KEY: "gsk-...",
    },
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },
}

• इनलाइन परिवेश चर केवल तभी लागू होते हैं जब प्रक्रिया परिवेश में कुंजी अनुपस्थित हो।
• .env फ़ाइलें: CWD .env + ~/.openclaw/.env (दोनों में से कोई भी मौजूदा चरों को ओवरराइड नहीं करता)।
• shellEnv: आपके लॉगिन शेल प्रोफ़ाइल से अनुपस्थित अपेक्षित कुंजियाँ आयात करता है।
• पूर्ण प्राथमिकता क्रम के लिए परिवेश देखें।

​

परिवेश चर प्रतिस्थापन

{
  gateway: {
    auth: { token: "${OPENCLAW_GATEWAY_TOKEN}" },
  },
}

• केवल अपरकेस नाम मेल खाते हैं: [A-Z_][A-Z0-9_]*।
• अनुपस्थित/रिक्त चर कॉन्फ़िगरेशन लोड करते समय त्रुटि उत्पन्न करते हैं।
• शाब्दिक ${VAR} के लिए $${VAR} से एस्केप करें।
• $include के साथ काम करता है।

​

सीक्रेट

​

SecretRef

{ source: "env" | "file" | "exec", provider: "default", id: "..." }

• provider पैटर्न: ^[a-z][a-z0-9_-]{0,63}$
• source: "env" ID पैटर्न: ^[A-Z][A-Z0-9_]{0,127}$
• source: "file" ID: निरपेक्ष JSON पॉइंटर (उदाहरण के लिए "/providers/openai/apiKey")
• source: "exec" ID पैटर्न: ^[A-Za-z0-9][A-Za-z0-9._:/#-]{0,255}$ (AWS-शैली के secret#json_key चयनकर्ताओं का समर्थन करता है)
• source: "exec" ID में . या .. स्लैश-सीमांकित पथ खंड नहीं होने चाहिए (उदाहरण के लिए a/../b अस्वीकार किया जाता है)

​

समर्थित क्रेडेंशियल सतह

• कैनोनिकल मैट्रिक्स: SecretRef क्रेडेंशियल सतह
• secrets apply समर्थित openclaw.json क्रेडेंशियल पथों को लक्षित करता है।
• auth-profiles.json संदर्भ रनटाइम समाधान और ऑडिट कवरेज में शामिल होते हैं।

​

सीक्रेट प्रदाता कॉन्फ़िगरेशन

{
  secrets: {
    providers: {
      default: { source: "env" }, // वैकल्पिक स्पष्ट env प्रदाता
      filemain: {
        source: "file",
        path: "~/.openclaw/secrets.json",
        mode: "json",
        timeoutMs: 5000,
      },
      vault: {
        source: "exec",
        command: "/usr/local/bin/openclaw-vault-resolver",
        passEnv: ["PATH", "VAULT_ADDR"],
      },
    },
    defaults: {
      env: "default",
      file: "filemain",
      exec: "vault",
    },
  },
}

• file प्रदाता mode: "json" और mode: "singleValue" का समर्थन करता है (singleValue मोड में id, "value" होना चाहिए)।
• Windows ACL सत्यापन अनुपलब्ध होने पर फ़ाइल और exec प्रदाता पथ विफलता पर बंद हो जाते हैं। केवल उन विश्वसनीय पथों के लिए allowInsecurePath: true सेट करें जिन्हें सत्यापित नहीं किया जा सकता।
• exec प्रदाता के लिए निरपेक्ष command पथ आवश्यक है और यह stdin/stdout पर प्रोटोकॉल पेलोड का उपयोग करता है।
• डिफ़ॉल्ट रूप से, सिमलिंक कमांड पथ अस्वीकार किए जाते हैं। समाधान किए गए लक्ष्य पथ को सत्यापित करते हुए सिमलिंक पथों की अनुमति देने के लिए allowSymlinkCommand: true सेट करें।
• यदि trustedDirs कॉन्फ़िगर है, तो विश्वसनीय-डायरेक्टरी जाँच समाधान किए गए लक्ष्य पथ पर लागू होती है।
• exec चाइल्ड परिवेश डिफ़ॉल्ट रूप से न्यूनतम होता है; आवश्यक चर passEnv से स्पष्ट रूप से पास करें।
• सीक्रेट संदर्भ सक्रियण के समय इन-मेमोरी स्नैपशॉट में समाधान किए जाते हैं, फिर अनुरोध पथ केवल स्नैपशॉट को पढ़ते हैं।
• सक्रियण के दौरान सक्रिय-सतह फ़िल्टरिंग लागू होती है: सक्षम सतहों पर अनसुलझे संदर्भ स्टार्टअप/रीलोड को विफल करते हैं, जबकि निष्क्रिय सतहों को निदान के साथ छोड़ दिया जाता है।

​

प्रमाणीकरण संग्रहण

{
  auth: {
    profiles: {
      "anthropic:default": { provider: "anthropic", mode: "api_key" },
      "anthropic:work": { provider: "anthropic", mode: "api_key" },
      "openai:personal": { provider: "openai", mode: "oauth" },
    },
    order: {
      anthropic: ["anthropic:default", "anthropic:work"],
      openai: ["openai:personal"],
    },
  },
}

• प्रति-एजेंट प्रोफ़ाइल <agentDir>/auth-profiles.json पर संग्रहीत होती हैं।
• auth-profiles.json स्थिर क्रेडेंशियल मोड के लिए मान-स्तरीय संदर्भों (api_key के लिए keyRef, token के लिए tokenRef) का समर्थन करता है।
• { "provider": { "apiKey": "..." } } जैसे पुराने समतल auth-profiles.json मैप रनटाइम प्रारूप नहीं हैं; openclaw doctor --fix उन्हें .legacy-flat.*.bak बैकअप के साथ मानक provider:default API-कुंजी प्रोफ़ाइल में पुनर्लिखता है।
• OAuth-मोड प्रोफ़ाइल (auth.profiles.<id>.mode = "oauth") SecretRef-समर्थित प्रमाणीकरण-प्रोफ़ाइल क्रेडेंशियल का समर्थन नहीं करतीं।
• स्थिर रनटाइम क्रेडेंशियल इन-मेमोरी समाधान किए गए स्नैपशॉट से आते हैं; पुराने स्थिर auth.json प्रविष्टियों का पता चलने पर उन्हें हटा दिया जाता है।
• पुराने OAuth आयात ~/.openclaw/credentials/oauth.json से आते हैं।
• OAuth देखें।
• सीक्रेट के रनटाइम व्यवहार और audit/configure/apply टूलिंग के लिए: सीक्रेट प्रबंधन।

​

ऑडिट

{
  audit: {
    enabled: true,
    messages: "off", // off | direct | all
  },
}

• enabled: नई ऑडिट घटनाएँ दर्ज करें (डिफ़ॉल्ट: true)। लेजर डिफ़ॉल्ट रूप से चालू रहता है क्योंकि किसी घटना के बाद ही सक्षम किया गया ऑडिट ट्रेल उस घटना की व्याख्या नहीं कर सकता। false सेट करने से Gateway के पुनः आरंभ होने के बाद नई घटनाओं का सम्मिलन रुक जाता है; मौजूदा रिकॉर्ड समाप्त होने तक पढ़ने योग्य रहते हैं। इसे फिर से चालू करने पर उस बिंदु से रिकॉर्डिंग पुनः शुरू होती है—बीच के अंतराल को बाद में नहीं भरा जाता।
• messages: संदेश मेटाडेटा का दायरा (डिफ़ॉल्ट: "off")। "direct" केवल ज्ञात प्रत्यक्ष वार्तालाप दर्ज करता है। "all" समूह, चैनल और अज्ञात प्रकार के वार्तालाप भी दर्ज करता है। दोनों मोड सामग्री-रहित रहते हैं और जहाँ सहसंबंध उपलब्ध है, वहाँ अपरिष्कृत पहचानकर्ताओं को इंस्टॉलेशन-स्थानीय कुंजीबद्ध छद्मनामों से बदल देते हैं। ये गुमनामीकरण के बजाय सहसंबंध सहायक हैं; स्थिति डेटाबेस व्युत्पत्ति कुंजी संग्रहीत करता है, लेकिन RPC और CLI निर्यात नहीं करते।

​

लॉगिंग

{
  logging: {
    level: "info",
    file: "/tmp/openclaw/openclaw.log",
    consoleLevel: "info",
    consoleStyle: "pretty", // pretty | compact | json
    redactSensitive: "tools", // off | tools
    redactPatterns: ["\\bTOKEN\\b\\s*[=:]\\s*([\"']?)([^\\s\"']+)\\1"],
  },
}

• डिफ़ॉल्ट लॉग फ़ाइल: /tmp/openclaw/openclaw-YYYY-MM-DD.log; नामित प्रोफ़ाइल /tmp/openclaw/openclaw-<profile>-YYYY-MM-DD.log का उपयोग करती हैं।
• स्थिर पथ के लिए logging.file सेट करें।
• --verbose होने पर consoleLevel, debug तक बढ़ जाता है।
• maxFileBytes: रोटेशन से पहले सक्रिय लॉग फ़ाइल का अधिकतम आकार बाइट में (धनात्मक पूर्णांक; डिफ़ॉल्ट: 104857600 = 100 MB)। OpenClaw सक्रिय फ़ाइल के पास अधिकतम पाँच क्रमांकित अभिलेख रखता है।
• redactSensitive / redactPatterns: कंसोल आउटपुट, फ़ाइल लॉग, OTLP लॉग रिकॉर्ड और संग्रहीत सत्र ट्रांसक्रिप्ट पाठ के लिए सर्वोत्तम-प्रयास मास्किंग। redactSensitive: "off" केवल इस सामान्य लॉग/ट्रांसक्रिप्ट नीति को अक्षम करता है; UI/टूल/निदान सुरक्षा सतहें उत्सर्जन से पहले सीक्रेट को अब भी संपादित करती हैं।

​

निदान

{
  diagnostics: {
    enabled: true,
    flags: ["telegram.*"],

    otel: {
      enabled: false,
      endpoint: "https://otel-collector.example.com:4318",
      tracesEndpoint: "https://traces.example.com/v1/traces",
      metricsEndpoint: "https://metrics.example.com/v1/metrics",
      logsEndpoint: "https://logs.example.com/v1/logs",
      protocol: "http/protobuf", // http/protobuf | grpc
      headers: { "x-tenant-id": "my-org" },
      serviceName: "openclaw-gateway",
      traces: true,
      metrics: true,
      logs: false,
      logsExporter: "otlp",
      sampleRate: 1.0,
      flushIntervalMs: 5000,
      captureContent: {
        enabled: false,
        inputMessages: false,
        outputMessages: false,
        toolInputs: false,
        toolOutputs: false,
        systemPrompt: false,
        toolDefinitions: false,
      },
    },

    cacheTrace: {
      enabled: false,
      filePath: "~/.openclaw/logs/cache-trace.jsonl",
      includeMessages: true,
      includePrompt: true,
      includeSystem: true,
    },
  },
}

• enabled: इंस्ट्रूमेंटेशन आउटपुट का मुख्य टॉगल (डिफ़ॉल्ट: true)।
• flags: लक्षित लॉग आउटपुट सक्षम करने वाली फ़्लैग स्ट्रिंग की सरणी ("telegram.*" या "*" जैसे वाइल्डकार्ड का समर्थन करती है)।
• otel.enabled: OpenTelemetry निर्यात पाइपलाइन सक्षम करता है (डिफ़ॉल्ट: false)। पूर्ण कॉन्फ़िगरेशन, सिग्नल कैटलॉग और गोपनीयता मॉडल के लिए OpenTelemetry निर्यात देखें।
• otel.endpoint: OTel निर्यात के लिए कलेक्टर URL।
• otel.tracesEndpoint / otel.metricsEndpoint / otel.logsEndpoint: वैकल्पिक सिग्नल-विशिष्ट OTLP एंडपॉइंट। सेट होने पर ये केवल उस सिग्नल के लिए otel.endpoint को ओवरराइड करते हैं।
• otel.protocol: "http/protobuf" (डिफ़ॉल्ट) या "grpc"।
• otel.headers: OTel निर्यात अनुरोधों के साथ भेजे गए अतिरिक्त HTTP/gRPC मेटाडेटा हेडर।
• otel.serviceName: संसाधन एट्रिब्यूट के लिए सेवा नाम।
• otel.traces / otel.metrics / otel.logs: ट्रेस, मेट्रिक्स या लॉग निर्यात सक्षम करें।
• otel.logsExporter: लॉग निर्यात सिंक: "otlp" (डिफ़ॉल्ट), प्रत्येक stdout पंक्ति में एक JSON ऑब्जेक्ट के लिए "stdout", या "both"।
• otel.sampleRate: ट्रेस सैंपलिंग दर 0-1।
• otel.flushIntervalMs: आवधिक टेलीमेट्री फ्लश अंतराल मिलीसेकंड में।
• otel.captureContent: OTEL स्पैन एट्रिब्यूट के लिए अपरिष्कृत सामग्री कैप्चर का ऑप्ट-इन। डिफ़ॉल्ट रूप से बंद। बूलियन true गैर-सिस्टम संदेश/टूल सामग्री कैप्चर करता है; ऑब्जेक्ट रूप से आप inputMessages, outputMessages, toolInputs, toolOutputs, systemPrompt और toolDefinitions को स्पष्ट रूप से सक्षम कर सकते हैं।
• OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental: नवीनतम प्रायोगिक GenAI इन्फ़रेंस स्पैन आकार के लिए परिवेश टॉगल, जिसमें {gen_ai.operation.name} {gen_ai.request.model} स्पैन नाम, CLIENT स्पैन प्रकार और पुराने gen_ai.system के बजाय gen_ai.provider.name शामिल हैं। डिफ़ॉल्ट रूप से अनुकूलता के लिए स्पैन openclaw.model.call और gen_ai.system बनाए रखते हैं; GenAI मेट्रिक्स सीमित सिमेंटिक एट्रिब्यूट का उपयोग करते हैं।
• OPENCLAW_OTEL_PRELOADED=1: उन होस्ट के लिए परिवेश टॉगल जिन्होंने पहले ही वैश्विक OpenTelemetry SDK पंजीकृत कर लिया है। इसके बाद OpenClaw निदान लिसनर सक्रिय रखते हुए Plugin-स्वामित्व वाले SDK का प्रारंभ/शटडाउन छोड़ देता है।
• OTEL_EXPORTER_OTLP_TRACES_ENDPOINT, OTEL_EXPORTER_OTLP_METRICS_ENDPOINT और OTEL_EXPORTER_OTLP_LOGS_ENDPOINT: संबंधित कॉन्फ़िगरेशन कुंजी अनसेट होने पर उपयोग किए जाने वाले सिग्नल-विशिष्ट एंडपॉइंट परिवेश चर।
• cacheTrace.enabled: एम्बेडेड रन के लिए कैश ट्रेस स्नैपशॉट लॉग करें (डिफ़ॉल्ट: false)।
• cacheTrace.filePath: कैश ट्रेस JSONL का आउटपुट पथ (डिफ़ॉल्ट: $OPENCLAW_STATE_DIR/logs/cache-trace.jsonl)।
• cacheTrace.includeMessages / includePrompt / includeSystem: कैश ट्रेस आउटपुट में शामिल सामग्री नियंत्रित करें (सभी का डिफ़ॉल्ट: true)।

​

अपडेट

{
  update: {
    channel: "stable", // stable | extended-stable | beta | dev
    checkOnStart: true,

    auto: {
      enabled: false,
    },
  },
}

• channel: रिलीज़ चैनल—"stable", "extended-stable", "beta" या "dev"। Extended-stable केवल पैकेज के लिए है: फ़ोरग्राउंड कमांड इंस्टॉलेशन नियंत्रित करते हैं, जबकि Gateway केवल-पठन अपडेट संकेत उत्सर्जित कर सकता है।
• checkOnStart: Gateway प्रारंभ होने पर npm अपडेट की जाँच करें (डिफ़ॉल्ट: true)। संग्रहीत extended-stable चयन उसी केवल-पठन संकेत और 24-घंटे की संकेत अनुसूची का उपयोग करते हैं।
• auto.enabled: stable और beta पैकेज इंस्टॉलेशन के लिए पृष्ठभूमि स्वतः-अपडेट सक्षम करें (डिफ़ॉल्ट: false)। Extended-stable कभी स्वतः लागू नहीं होता।

​

ACP

{
  acp: {
    enabled: true,
    dispatch: { enabled: true },
    backend: "acpx",
    fallbacks: ["acpx-secondary"],
    defaultAgent: "main",
    allowedAgents: ["main", "ops"],
    stream: {
      repeatSuppression: true,
      deliveryMode: "live", // live | final_only
    },
  },
}

• enabled: वैश्विक ACP सुविधा गेट (डिफ़ॉल्ट: true; ACP डिस्पैच और स्पॉन सुविधाएँ छिपाने के लिए false सेट करें)।
• dispatch.enabled: ACP सत्र टर्न डिस्पैच के लिए स्वतंत्र गेट (डिफ़ॉल्ट: true)। निष्पादन अवरुद्ध रखते हुए ACP कमांड उपलब्ध रखने के लिए false सेट करें।
• backend: डिफ़ॉल्ट ACP रनटाइम बैकएंड आईडी (पंजीकृत ACP रनटाइम Plugin से मेल खाना आवश्यक है)। पहले बैकएंड Plugin इंस्टॉल करें और यदि plugins.allow सेट है, तो बैकएंड Plugin आईडी (उदाहरण के लिए acpx) शामिल करें, अन्यथा ACP बैकएंड लोड नहीं होगा।
• fallbacks: प्राथमिक बैकएंड द्वारा कोई आउटपुट उत्पन्न करने से पहले अस्थायी प्रतीत होने वाली त्रुटि (अनुपलब्ध, दर-सीमित, कोटा समाप्त या अतिभारित) के साथ जल्दी विफल होने पर आज़माए जाने वाले फ़ॉलबैक ACP बैकएंड आईडी की क्रमबद्ध सूची। प्रत्येक प्रविष्टि को पंजीकृत ACP रनटाइम Plugin बैकएंड से मेल खाना आवश्यक है।
• defaultAgent: जब स्पॉन स्पष्ट लक्ष्य निर्दिष्ट न करें, तब फ़ॉलबैक ACP लक्ष्य एजेंट आईडी।
• allowedAgents: ACP रनटाइम सत्रों के लिए अनुमत एजेंट आईडी की अनुमति-सूची; खाली होने का अर्थ कोई अतिरिक्त प्रतिबंध नहीं है।
• stream.repeatSuppression: प्रत्येक टर्न में दोहराई गई स्थिति/टूल पंक्तियाँ दबाएँ (डिफ़ॉल्ट: true)।
• stream.deliveryMode: "live" क्रमिक रूप से स्ट्रीम करता है; "final_only" टर्न की अंतिम घटनाओं तक बफ़र करता है।
• stream.tagVisibility: स्ट्रीम की गई घटनाओं के लिए टैग नामों से बूलियन दृश्यता ओवरराइड तक का रिकॉर्ड।
• runtime.installCommand: ACP रनटाइम परिवेश बूटस्ट्रैप करते समय चलाने के लिए वैकल्पिक इंस्टॉल कमांड।

​

विज़ार्ड

{
  wizard: {
    accessMode: "full",
    appRecommendations: true,
    lastRunAt: "2026-01-01T00:00:00.000Z",
    lastRunVersion: "2026.1.4",
    lastRunCommit: "abc1234",
    lastRunCommand: "configure",
    lastRunMode: "local",
    securityAcknowledgedAt: "2026-01-01T00:00:00.000Z",
  },
}

• wizard.accessMode: निर्देशित ऑनबोर्डिंग की शुरुआत में चुनी गई खोज सहमति। "full" (अनुशंसित) सेटअप को AI ऐप्स, कुंजियों और स्थानीय रनटाइम को स्वचालित रूप से खोजने देता है; "guarded" सेटअप को खोज शुरू करने से पहले एक बार पूछने के लिए बाध्य करता है और इसके बजाय मैन्युअल कॉन्फ़िगरेशन प्रस्तुत करता है।
• wizard.appRecommendations का डिफ़ॉल्ट मान true है। निर्देशित या क्लासिक ऑनबोर्डिंग के दौरान इंस्टॉल किए गए एप्लिकेशन की अनुशंसाएँ अक्षम करने और Gateway की device.apps पहुँच अवरुद्ध करने के लिए इसे false पर सेट करें। कमांड का विज्ञापन करने से पहले Node होस्ट को अभी भी अपने अलग, डिफ़ॉल्ट रूप से बंद इंस्टॉल किए गए ऐप साझाकरण फ़्लैग की आवश्यकता होती है।

​

पहचान

​

ब्रिज (विरासती, हटाया गया)

{
  "bridge": {
    "enabled": true,
    "port": 18790,
    "bind": "tailnet",
    "tls": {
      "enabled": true,
      "autoGenerate": true
    }
  }
}

​

Cron

{
  cron: {
    enabled: true,
    webhook: "https://example.invalid/legacy", // संग्रहीत notify:true जॉब के लिए अप्रचलित फ़ॉलबैक
    webhookToken: "replace-with-dedicated-token", // आउटबाउंड webhook प्रमाणीकरण के लिए वैकल्पिक bearer टोकन
    sessionRetention: "24h", // अवधि स्ट्रिंग या false
  },
}

• sessionRetention: SQLite सत्र पंक्तियों को हटाने से पहले पूर्ण हो चुके पृथक Cron रन सत्रों को कितने समय तक रखना है। यह संग्रहित और हटाई गई Cron ट्रांसक्रिप्ट की सफ़ाई को भी नियंत्रित करता है। डिफ़ॉल्ट: 24h; अक्षम करने के लिए false सेट करें।
• रन इतिहास प्रत्येक जॉब के लिए नवीनतम 2000 टर्मिनल पंक्तियाँ स्वचालित रूप से रखता है। खोई हुई पंक्तियों के लिए उनकी 24-घंटे की सफ़ाई अवधि बनी रहती है।
• webhookToken: Cron webhook POST डिलीवरी (delivery.mode = "webhook") के लिए उपयोग किया जाने वाला bearer टोकन; इसे छोड़ने पर कोई प्रमाणीकरण हेडर नहीं भेजा जाता।
• webhook: अप्रचलित विरासती फ़ॉलबैक webhook URL (http/https), जिसका उपयोग openclaw doctor --fix उन संग्रहीत जॉब को माइग्रेट करने के लिए करता है जिनमें अभी भी notify: true है; रनटाइम डिलीवरी प्रति-जॉब delivery.mode="webhook" के साथ delivery.to, या घोषणा डिलीवरी बनाए रखते समय delivery.completionDestination का उपयोग करती है।

​

cron.failureAlert

{
  cron: {
    failureAlert: {
      enabled: false,
      after: 3,
      cooldownMs: 3600000,
      includeSkipped: false,
      mode: "announce",
      accountId: "main",
    },
  },
}

• enabled: Cron जॉब के लिए विफलता अलर्ट सक्षम करें (डिफ़ॉल्ट: false)।
• after: अलर्ट सक्रिय होने से पहले लगातार विफलताओं की संख्या (धनात्मक पूर्णांक, न्यूनतम: 1)।
• cooldownMs: उसी जॉब के लिए दोहराए गए अलर्ट के बीच न्यूनतम मिलीसेकंड (गैर-ऋणात्मक पूर्णांक)।
• includeSkipped: लगातार छोड़े गए रन को अलर्ट सीमा में गिनें (डिफ़ॉल्ट: false)। छोड़े गए रन अलग से ट्रैक किए जाते हैं और निष्पादन-त्रुटि बैकऑफ़ को प्रभावित नहीं करते।
• mode: डिलीवरी मोड - "announce" चैनल संदेश के माध्यम से भेजता है; "webhook" कॉन्फ़िगर किए गए webhook पर पोस्ट करता है।
• accountId: अलर्ट डिलीवरी का दायरा निर्धारित करने के लिए वैकल्पिक खाता या चैनल आईडी।

​

cron.failureDestination

{
  cron: {
    failureDestination: {
      mode: "announce",
      channel: "last",
      to: "channel:C1234567890",
      accountId: "main",
    },
  },
}

• सभी जॉब में Cron विफलता सूचनाओं के लिए डिफ़ॉल्ट गंतव्य।
• mode: "announce" या "webhook"; पर्याप्त लक्ष्य डेटा उपलब्ध होने पर डिफ़ॉल्ट रूप से "announce" होता है।
• channel: घोषणा डिलीवरी के लिए चैनल ओवरराइड। "last" अंतिम ज्ञात डिलीवरी चैनल का पुनः उपयोग करता है।
• to: स्पष्ट घोषणा लक्ष्य या webhook URL। webhook मोड के लिए आवश्यक।
• accountId: डिलीवरी के लिए वैकल्पिक खाता ओवरराइड।
• प्रति-जॉब delivery.failureDestination इस वैश्विक डिफ़ॉल्ट को ओवरराइड करता है।
• जब न तो वैश्विक और न ही प्रति-जॉब विफलता गंतव्य सेट हो, तो वे जॉब जो पहले से announce के माध्यम से डिलीवरी करते हैं, विफलता पर उसी प्राथमिक घोषणा लक्ष्य का फ़ॉलबैक के रूप में उपयोग करते हैं।
• delivery.failureDestination केवल sessionTarget="isolated" जॉब के लिए समर्थित है, जब तक कि जॉब का प्राथमिक delivery.mode, "webhook" न हो।

​

मीडिया मॉडल टेम्पलेट चर

​

कॉन्फ़िगरेशन समावेशन ($include)

// ~/.openclaw/openclaw.json
{
  gateway: { port: 18789 },
  agents: { $include: "./agents.json5" },
  broadcast: {
    $include: ["./clients/mueller.json5", "./clients/schmidt.json5"],
  },
}

• एकल फ़ाइल: समाहित करने वाले ऑब्जेक्ट को प्रतिस्थापित करती है।
• फ़ाइलों की सरणी: क्रम से डीप-मर्ज की जाती है (बाद वाली पहले वाली को ओवरराइड करती है)।
• सहोदर कुंजियाँ: समावेशन के बाद मर्ज की जाती हैं (समावेशित मानों को ओवरराइड करती हैं)।
• नेस्टेड समावेशन: अधिकतम 10 स्तर गहरे।
• पथ: समावेश करने वाली फ़ाइल के सापेक्ष निर्धारित किए जाते हैं, लेकिन शीर्ष-स्तरीय कॉन्फ़िगरेशन डायरेक्टरी (openclaw.json का dirname) के भीतर ही रहने चाहिए। निरपेक्ष/../ रूपों की अनुमति केवल तभी है जब वे इस सीमा के भीतर निर्धारित होते हों। कॉन्फ़िगरेशन डायरेक्टरी के बाहर अतिरिक्त रूट की अनुमति देने के लिए OPENCLAW_INCLUDE_ROOTS (निरपेक्ष पथ) सेट करें।
• सीमाएँ: पथों में null बाइट नहीं होनी चाहिए और निर्धारण से पहले तथा बाद में उनकी लंबाई अनिवार्य रूप से 4096 वर्णों से कम होनी चाहिए; प्रत्येक समावेशित फ़ाइल की सीमा 2 MB है।
• OpenClaw के स्वामित्व वाले ऐसे लेखन, जो एकल-फ़ाइल समावेशन द्वारा समर्थित केवल एक शीर्ष-स्तरीय अनुभाग को बदलते हैं, सीधे उस समावेशित फ़ाइल में लिखते हैं। उदाहरण के लिए, plugins install, plugins.json5 में plugins: { $include: "./plugins.json5" } को अपडेट करता है और openclaw.json को यथावत रखता है।
• रूट समावेशन, समावेशन सरणियाँ और सहोदर ओवरराइड वाले समावेशन, OpenClaw के स्वामित्व वाले लेखन के लिए केवल-पढ़ने योग्य हैं; ऐसे लेखन कॉन्फ़िगरेशन को समतल करने के बजाय सुरक्षित रूप से विफल होते हैं।
• त्रुटियाँ: अनुपलब्ध फ़ाइलों, पार्स त्रुटियों, चक्रीय समावेशन, अमान्य पथ प्रारूप और अत्यधिक लंबाई के लिए स्पष्ट संदेश।

​

संबंधित

• कॉन्फ़िगरेशन
• कॉन्फ़िगरेशन उदाहरण
• Doctor