Gateway

कॉन्फ़िगरेशन — एजेंट्स

agents.*, multiAgent.*, session.*, messages.*, और talk.* के अंतर्गत एजेंट-स्कोप वाले कॉन्फ़िगरेशन कुंजी। चैनलों, टूल, Gateway रनटाइम और अन्य शीर्ष-स्तरीय कुंजियों के लिए, कॉन्फ़िगरेशन संदर्भ देखें।

एजेंट डिफ़ॉल्ट

`agents.defaults.workspace`

डिफ़ॉल्ट: सेट होने पर OPENCLAW_WORKSPACE_DIR, अन्यथा ~/.openclaw/workspace (या जब OPENCLAW_PROFILE को किसी गैर-डिफ़ॉल्ट प्रोफ़ाइल पर सेट किया गया हो, तब ~/.openclaw/workspace-<profile>)।

json5

{  agents: { defaults: { workspace: "~/.openclaw/workspace" } },}

स्पष्ट agents.defaults.workspace मान को OPENCLAW_WORKSPACE_DIR पर प्राथमिकता मिलती है। जब आप उस पथ को कॉन्फ़िगरेशन में नहीं लिखना चाहते हों, तब डिफ़ॉल्ट एजेंटों को माउंट किए गए वर्कस्पेस की ओर निर्देशित करने के लिए पर्यावरण चर का उपयोग करें।

`agents.defaults.repoRoot`

सिस्टम प्रॉम्प्ट की Runtime पंक्ति में दिखाया जाने वाला वैकल्पिक रिपॉज़िटरी रूट। यदि सेट न हो, तो OpenClaw वर्कस्पेस से ऊपर की ओर खोजकर इसका स्वतः पता लगाता है।

json5

{  agents: { defaults: { repoRoot: "~/Projects/openclaw" } },}

`agents.defaults.skills`

उन एजेंटों के लिए वैकल्पिक डिफ़ॉल्ट स्किल अनुमति-सूची, जो agents.entries.*.skills सेट नहीं करते।

json5

{  agents: {    defaults: { skills: ["github", "weather"] },    list: [      { id: "writer" }, // github, weather इनहेरिट करता है      { id: "docs", skills: ["docs-search"] }, // डिफ़ॉल्ट को बदल देता है      { id: "locked-down", skills: [] }, // कोई स्किल नहीं    ],  },}

डिफ़ॉल्ट रूप से अप्रतिबंधित स्किल के लिए agents.defaults.skills को छोड़ दें।
डिफ़ॉल्ट इनहेरिट करने के लिए agents.entries.*.skills को छोड़ दें।
कोई स्किल न रखने के लिए agents.entries.*.skills: [] सेट करें।
गैर-रिक्त agents.entries.*.skills सूची उस एजेंट के लिए अंतिम सेट होती है; इसे डिफ़ॉल्ट के साथ मर्ज नहीं किया जाता।

`agents.defaults.skipBootstrap`

वर्कस्पेस बूटस्ट्रैप फ़ाइलों (AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, BOOTSTRAP.md) का स्वचालित निर्माण अक्षम करता है।

json5

{  agents: { defaults: { skipBootstrap: true } },}

`agents.defaults.skipOptionalBootstrapFiles`

आवश्यक बूटस्ट्रैप फ़ाइलें (AGENTS.md, TOOLS.md, BOOTSTRAP.md) लिखना जारी रखते हुए चुनी गई वैकल्पिक वर्कस्पेस फ़ाइलों का निर्माण छोड़ देता है। मान्य मान: SOUL.md, USER.md, और IDENTITY.md (HEARTBEAT.md स्वीकार किया जाता है, लेकिन इसका कोई प्रभाव नहीं पड़ता क्योंकि Heartbeat संदर्भ को Cron मॉनिटर स्क्रैच में स्थानांतरित कर दिया गया है)।

json5

{  agents: {    defaults: {      skipOptionalBootstrapFiles: ["SOUL.md", "USER.md"],    },  },}

`agents.defaults.contextInjection`

यह नियंत्रित करता है कि कार्यक्षेत्र बूटस्ट्रैप फ़ाइलों को सिस्टम प्रॉम्प्ट में कब इंजेक्ट किया जाता है। डिफ़ॉल्ट: "always"।

"continuation-skip": सुरक्षित निरंतरता टर्न (सहायक का उत्तर पूरा होने के बाद) कार्यक्षेत्र बूटस्ट्रैप को दोबारा इंजेक्ट करना छोड़ देते हैं, जिससे प्रॉम्प्ट का आकार कम होता है। Heartbeat रन और Compaction के बाद के पुनः प्रयास फिर भी संदर्भ को दोबारा बनाते हैं।
"never": प्रत्येक टर्न पर कार्यक्षेत्र बूटस्ट्रैप और संदर्भ-फ़ाइल इंजेक्शन अक्षम करें। इसका उपयोग केवल उन एजेंटों के लिए करें जो अपने प्रॉम्प्ट जीवनचक्र पर पूर्ण नियंत्रण रखते हैं (कस्टम संदर्भ इंजन, अपना संदर्भ स्वयं बनाने वाले मूल रनटाइम, या बूटस्ट्रैप-रहित विशिष्ट कार्यप्रवाह)। Heartbeat और Compaction-पुनर्प्राप्ति टर्न भी इंजेक्शन छोड़ देते हैं।

json5

{  agents: { defaults: { contextInjection: "continuation-skip" } },}

प्रति-एजेंट ओवरराइड: agents.entries.*.contextInjection। छोड़े गए मान agents.defaults.contextInjection से इनहेरिट होते हैं।

`agents.defaults.bootstrapMaxChars`

काटे जाने से पहले प्रत्येक कार्यक्षेत्र बूटस्ट्रैप फ़ाइल के लिए वर्णों की अधिकतम संख्या। डिफ़ॉल्ट: 20000।

json5

{  agents: { defaults: { bootstrapMaxChars: 20000 } },}

प्रति-एजेंट ओवरराइड: agents.entries.*.bootstrapMaxChars। छोड़े गए मान agents.defaults.bootstrapMaxChars से इनहेरिट होते हैं।

`agents.defaults.bootstrapTotalMaxChars`

सभी कार्यक्षेत्र बूटस्ट्रैप फ़ाइलों में इंजेक्ट किए जाने वाले वर्णों की अधिकतम कुल संख्या। डिफ़ॉल्ट: 60000।

json5

{  agents: { defaults: { bootstrapTotalMaxChars: 60000 } },}

प्रति-एजेंट ओवरराइड: agents.entries.*.bootstrapTotalMaxChars। छोड़े गए मान agents.defaults.bootstrapTotalMaxChars से इनहेरिट होते हैं।

प्रति-एजेंट बूटस्ट्रैप प्रोफ़ाइल ओवरराइड

जब किसी एजेंट को साझा डिफ़ॉल्ट से अलग प्रॉम्प्ट इंजेक्शन व्यवहार की आवश्यकता हो, तो प्रति-एजेंट बूटस्ट्रैप प्रोफ़ाइल ओवरराइड का उपयोग करें। छोड़े गए फ़ील्ड agents.defaults से इनहेरिट होते हैं।

json5

{  agents: {    defaults: {      contextInjection: "continuation-skip",      bootstrapMaxChars: 20000,      bootstrapTotalMaxChars: 60000,    },    list: [      {        id: "strict-worker",        contextInjection: "always",        bootstrapMaxChars: 50000,        bootstrapTotalMaxChars: 300000,      },    ],  },}

`agents.defaults.bootstrapPromptTruncationWarning`

बूटस्ट्रैप संदर्भ काटे जाने पर एजेंट को दिखाई देने वाली सिस्टम-प्रॉम्प्ट सूचना को नियंत्रित करता है। डिफ़ॉल्ट: "always"।

"off": सिस्टम प्रॉम्प्ट में काटे जाने की सूचना का टेक्स्ट कभी इंजेक्ट न करें।
"once": प्रत्येक अद्वितीय काटे जाने के सिग्नेचर के लिए एक बार संक्षिप्त सूचना इंजेक्ट करें।
"always": काटा गया संदर्भ मौजूद होने पर प्रत्येक रन में संक्षिप्त सूचना इंजेक्ट करें (अनुशंसित)।

विस्तृत रॉ/इंजेक्टेड गणनाएँ और कॉन्फ़िगरेशन ट्यूनिंग फ़ील्ड संदर्भ/स्थिति रिपोर्ट और लॉग जैसे निदान में बने रहते हैं; नियमित WebChat उपयोगकर्ता/रनटाइम संदर्भ को केवल संक्षिप्त पुनर्प्राप्ति सूचना मिलती है।

json5

{  agents: { defaults: { bootstrapPromptTruncationWarning: "always" } }, // off | once | always}

संदर्भ बजट स्वामित्व मानचित्र

OpenClaw में कई उच्च-मात्रा वाले प्रॉम्प्ट/संदर्भ बजट हैं, और उन्हें जानबूझकर एक सामान्य नियंत्रण से संचालित करने के बजाय उप-प्रणाली के अनुसार विभाजित किया गया है।

बजट	इसमें शामिल है
`agents.defaults.bootstrapMaxChars` / `bootstrapTotalMaxChars`	सामान्य वर्कस्पेस बूटस्ट्रैप अंतःक्षेपण
`agents.defaults.startupContext.*`	एकबारगी रीसेट/स्टार्टअप मॉडल-रन प्रस्तावना, जिसमें हाल की दैनिक `memory/*.md` फ़ाइलें शामिल हैं। सामान्य चैट `/new` और `/reset` को मॉडल चलाए बिना स्वीकार किया जाता है
`skills.limits.*`	सिस्टम प्रॉम्प्ट में अंतःक्षेपित की जाने वाली संक्षिप्त Skills सूची
`agents.defaults.contextLimits.*`	सीमाबद्ध रनटाइम अंश और अंतःक्षेपित रनटाइम-स्वामित्व वाले ब्लॉक
`memory.qmd.limits.*`	अनुक्रमित मेमोरी-खोज स्निपेट और अंतःक्षेपण आकार निर्धारण

संगत प्रति-एजेंट ओवरराइड:

agents.entries.*.skillsLimits.maxSkillsPromptChars
agents.entries.*.contextInjection
agents.entries.*.bootstrapMaxChars
agents.entries.*.bootstrapTotalMaxChars
agents.entries.*.contextLimits.*

`agents.defaults.startupContext`

रीसेट/स्टार्टअप मॉडल रन पर अंतःक्षेपित होने वाली पहले टर्न की स्टार्टअप प्रस्तावना को नियंत्रित करता है। सामान्य चैट /new और /reset कमांड मॉडल चलाए बिना रीसेट को स्वीकार करते हैं, इसलिए वे इस प्रस्तावना को लोड नहीं करते।

json5

{  agents: {    defaults: {      startupContext: {        enabled: true,        applyOn: ["new", "reset"],        dailyMemoryDays: 2,        maxFileBytes: 16384,        maxFileChars: 1200,        maxTotalChars: 2800,      },    },  },}

`agents.defaults.contextLimits`

सीमाबद्ध रनटाइम संदर्भ सतहों के लिए साझा डिफ़ॉल्ट।

json5

{  agents: {    defaults: {      contextLimits: {        memoryGetMaxChars: 12000,        postCompactionMaxChars: 1800,      },    },  },}

memoryGetMaxChars: काट-छाँट मेटाडेटा और निरंतरता सूचना जोड़े जाने से पहले डिफ़ॉल्ट memory_get अंश सीमा।
जब memory_get में lines नहीं होता, तब OpenClaw अंतर्निहित 120-पंक्ति विंडो का उपयोग करता है और फिर memoryGetMaxChars लागू करता है।
लाइव टूल परिणाम मॉडल-संदर्भ की स्वचालित सीमा का उपयोग करते हैं: 100K टोकन से कम पर 16000 वर्ण, 100K+ टोकन पर 32000 वर्ण और 200K+ टोकन पर 64000 वर्ण।
postCompactionMaxChars: Compaction के बाद के रीफ़्रेश अंतःक्षेपण में उपयोग की जाने वाली AGENTS.md अंश सीमा।

`agents.entries.*.contextLimits`

साझा contextLimits नियंत्रणों के लिए प्रति-एजेंट ओवरराइड। छोड़े गए फ़ील्ड agents.defaults.contextLimits से इनहेरिट होते हैं।

json5

{  agents: {    defaults: {      contextLimits: { memoryGetMaxChars: 12000 },    },    list: [      {        id: "tiny-local",        contextLimits: {          memoryGetMaxChars: 6000,        },      },    ],  },}

`skills.limits.maxSkillsPromptChars`

सिस्टम प्रॉम्प्ट में अंतःक्षेपित की जाने वाली संक्षिप्त Skills सूची की वैश्विक सीमा। यह आवश्यकतानुसार SKILL.md फ़ाइलें पढ़ने को प्रभावित नहीं करता।

json5

{  skills: { limits: { maxSkillsPromptChars: 18000 } },}

`agents.entries.*.skillsLimits.maxSkillsPromptChars`

Skills प्रॉम्प्ट बजट के लिए प्रति-एजेंट ओवरराइड।

json5

{  agents: {    list: [{ id: "tiny-local", skillsLimits: { maxSkillsPromptChars: 6000 } }],  },}

`agents.defaults.imageMaxDimensionPx`

प्रदाता कॉल से पहले ट्रांस्क्रिप्ट/टूल इमेज ब्लॉक में इमेज की सबसे लंबी भुजा का अधिकतम पिक्सेल आकार। डिफ़ॉल्ट: 1200।

कम मान आम तौर पर स्क्रीनशॉट-बहुल रन के लिए विज़न-टोकन उपयोग और अनुरोध पेलोड आकार घटाते हैं। अधिक मान ज़्यादा दृश्य विवरण बनाए रखते हैं।

json5

{  agents: { defaults: { imageMaxDimensionPx: 1200 } },}

`agents.defaults.imageQuality`

फ़ाइल पथों, URL और मीडिया संदर्भों से लोड की गई इमेज के लिए इमेज-टूल संपीड़न/विवरण प्राथमिकता। डिफ़ॉल्ट: auto।

OpenClaw आकार बदलने की श्रेणी को चुने गए इमेज मॉडल के अनुसार अनुकूलित करता है। उदाहरण के लिए, Claude Opus 4.8, OpenAI GPT-5.6 Sol, Qwen VL और होस्ट किए गए Llama 4 विज़न मॉडल पुराने/डिफ़ॉल्ट उच्च-विवरण विज़न पथों की तुलना में बड़ी इमेज का उपयोग कर सकते हैं, जबकि टोकन और विलंबता लागत नियंत्रित करने के लिए auto मोड में एकाधिक-इमेज टर्न को अधिक आक्रामक ढंग से संपीड़ित किया जाता है।

मान:

auto: मॉडल सीमाओं और इमेज संख्या के अनुसार अनुकूलित करें।
efficient: कम टोकन और बाइट उपयोग के लिए छोटी इमेज को प्राथमिकता दें।
balanced: मानक मध्यवर्ती श्रेणी का उपयोग करें।
high: स्क्रीनशॉट, आरेख और दस्तावेज़ इमेज के लिए अधिक विवरण सुरक्षित रखें।

json5

{  agents: { defaults: { imageQuality: "auto" } },}

`agents.defaults.userTimezone`

सिस्टम प्रॉम्प्ट संदर्भ के लिए समय क्षेत्र (संदेश टाइमस्टैम्प के लिए नहीं)। उपलब्ध न होने पर होस्ट के समय क्षेत्र का उपयोग करता है।

json5

{  agents: { defaults: { userTimezone: "America/Chicago" } },}

`agents.defaults.timeFormat`

सिस्टम प्रॉम्प्ट में समय प्रारूप। डिफ़ॉल्ट: auto (OS प्राथमिकता)।

json5

{  agents: { defaults: { timeFormat: "auto" } }, // auto | 12 | 24}

`agents.defaults.model`

json5

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": { alias: "opus" },        "minimax/MiniMax-M2.7": { alias: "minimax" },      },      model: {        primary: "anthropic/claude-opus-4-6",        fallbacks: ["minimax/MiniMax-M2.7"],      },      utilityModel: "openai/gpt-5.4-mini",      imageModel: {        primary: "openrouter/qwen/qwen-2.5-vl-72b-instruct:free",        fallbacks: ["openrouter/google/gemini-2.0-flash-vision:free"],      },      mediaModels: {        image: {          primary: "openai/gpt-image-2",          fallbacks: ["google/gemini-3.1-flash-image"],        },        video: {          primary: "qwen/wan2.6-t2v",          fallbacks: ["qwen/wan2.6-i2v"],        },      },      pdfModel: {        primary: "anthropic/claude-opus-4-6",        fallbacks: ["openai/gpt-5.4-mini"],      },      params: { cacheRetention: "long" }, // वैश्विक डिफ़ॉल्ट प्रदाता पैरामीटर      pdfMaxMb: 10,      pdfMaxPages: 20,      thinkingDefault: "low",      verboseDefault: "off",      toolProgressDetail: "explain",      reasoningDefault: "off",      elevatedDefault: "on",      timeoutSeconds: 600,      mediaMaxMb: 5,      contextTokens: 200000,      maxConcurrent: 4,    },  },}

model: या तो एक स्ट्रिंग ("provider/model") या एक ऑब्जेक्ट ({ primary, fallbacks }) स्वीकार करता है।
- स्ट्रिंग रूप केवल प्राथमिक मॉडल सेट करता है।
- ऑब्जेक्ट रूप प्राथमिक मॉडल के साथ क्रमबद्ध फ़ेलओवर मॉडल सेट करता है।
utilityModel: छोटे आंतरिक कार्यों के लिए वैकल्पिक provider/model संदर्भ या उपनाम। वर्तमान में इसका उपयोग जनरेट किए गए Control UI सत्र शीर्षकों, Telegram DM विषय शीर्षकों, Discord स्वचालित-थ्रेड शीर्षकों और प्रगति-ड्राफ़्ट विवरण के लिए किया जाता है। इसे सेट न करने पर, जहाँ उपलब्ध हो वहाँ OpenClaw प्राथमिक प्रदाता के घोषित छोटे-मॉडल डिफ़ॉल्ट को प्राप्त करता है (OpenAI → gpt-5.6-luna, Anthropic → claude-haiku-4-5); अन्यथा शीर्षक कार्य एजेंट के प्राथमिक मॉडल का उपयोग करते हैं और विवरण बंद रहता है। यदि कोई अलग उपयोगिता मॉडल जनरेट किया गया शीर्षक तैयार या पूरा नहीं कर पाता, तो OpenClaw प्राथमिक मॉडल के साथ उस शीर्षक का एक बार पुनः प्रयास करता है। डैशबोर्ड शीर्षकों के लिए, स्वचालित उपयोगिता निर्धारण और नियमित फ़ॉलबैक प्रभावी सत्र प्रदाता और प्रमाणीकरण प्रोफ़ाइल का उपयोग करते हैं; स्पष्ट रूप से निर्दिष्ट उपयोगिता मॉडल अपने कॉन्फ़िगर किए गए प्रदाता/प्रमाणीकरण को बनाए रखता है। वैकल्पिक उपयोगिता मार्ग छोड़ने के लिए utilityModel: "" सेट करें; डैशबोर्ड शीर्षक जनरेशन फिर भी सीधे नियमित सत्र मॉडल पर आगे बढ़ता है। agents.entries.*.utilityModel डिफ़ॉल्ट को ओवरराइड करता है और किसी संचालन-विशिष्ट मॉडल का ओवरराइड दोनों पर प्राथमिकता रखता है। उपयोगिता कार्य अलग मॉडल कॉल करते हैं और कार्य-विशिष्ट सामग्री चयनित मॉडल प्रदाता को भेजते हैं। डैशबोर्ड शीर्षक जनरेशन पहले गैर-कमांड संदेश के अधिकतम शुरुआती 1,000 वर्ण भेजता है; विवरण आने वाला अनुरोध और संक्षिप्त, संशोधित टूल सारांश भेजता है। ऐसा प्रदाता चुनें जो आपकी लागत और डेटा-प्रबंधन आवश्यकताओं के अनुरूप हो।
imageModel: या तो एक स्ट्रिंग ("provider/model") या एक ऑब्जेक्ट ({ primary, fallbacks }) स्वीकार करता है।
- जब सक्रिय मॉडल छवियाँ स्वीकार नहीं कर सकता, तब image टूल पथ इसे अपने विज़न-मॉडल कॉन्फ़िगरेशन के रूप में उपयोग करता है। इसके बजाय नेटिव-विज़न मॉडल लोड किए गए छवि बाइट सीधे प्राप्त करते हैं।
- चयनित/डिफ़ॉल्ट मॉडल के छवि इनपुट स्वीकार न कर पाने पर इसका उपयोग फ़ॉलबैक रूटिंग के लिए भी किया जाता है।
- स्पष्ट provider/model संदर्भों को प्राथमिकता दें। संगतता के लिए बिना उपसर्ग वाली ID स्वीकार की जाती हैं; यदि कोई बिना उपसर्ग वाली ID models.providers.*.models में कॉन्फ़िगर की गई किसी छवि-सक्षम प्रविष्टि से अद्वितीय रूप से मेल खाती है, तो OpenClaw उसमें उस प्रदाता को जोड़ देता है। कॉन्फ़िगर किए गए अस्पष्ट मिलानों के लिए स्पष्ट प्रदाता उपसर्ग आवश्यक है।
mediaModels.image: या तो एक स्ट्रिंग ("provider/model") या एक ऑब्जेक्ट ({ primary, fallbacks }) स्वीकार करता है।
- साझा छवि-जनरेशन क्षमता और छवियाँ जनरेट करने वाले किसी भी भावी टूल/Plugin सतह द्वारा उपयोग किया जाता है।
- सामान्य मान: नेटिव Gemini छवि जनरेशन के लिए google/gemini-3.1-flash-image, fal के लिए fal/fal-ai/flux/dev, OpenAI Images के लिए openai/gpt-image-2, या पारदर्शी-पृष्ठभूमि वाले OpenAI PNG/WebP आउटपुट के लिए openai/gpt-image-1.5।
- यदि आप सीधे कोई प्रदाता/मॉडल चुनते हैं, तो मेल खाने वाला प्रदाता प्रमाणीकरण भी कॉन्फ़िगर करें (उदाहरण के लिए google/* हेतु GEMINI_API_KEY या GOOGLE_API_KEY, openai/gpt-image-2 / openai/gpt-image-1.5 हेतु OPENAI_API_KEY या OpenAI Codex OAuth, और fal/* हेतु FAL_KEY)।
- इसे छोड़ने पर भी image_generate प्रमाणीकरण-समर्थित प्रदाता डिफ़ॉल्ट का अनुमान लगा सकता है। यह पहले वर्तमान डिफ़ॉल्ट प्रदाता को, फिर प्रदाता-ID क्रम में शेष पंजीकृत छवि-जनरेशन प्रदाताओं को आज़माता है।
mediaModels.music: या तो एक स्ट्रिंग ("provider/model") या एक ऑब्जेक्ट ({ primary, fallbacks }) स्वीकार करता है।
- साझा संगीत-जनरेशन क्षमता और अंतर्निहित music_generate टूल द्वारा उपयोग किया जाता है।
- सामान्य मान: google/lyria-3-clip-preview, google/lyria-3-pro-preview, या minimax/music-2.6।
- इसे छोड़ने पर भी music_generate प्रमाणीकरण-समर्थित प्रदाता डिफ़ॉल्ट का अनुमान लगा सकता है। यह पहले वर्तमान डिफ़ॉल्ट प्रदाता को, फिर प्रदाता-ID क्रम में शेष पंजीकृत संगीत-जनरेशन प्रदाताओं को आज़माता है।
- यदि आप सीधे कोई प्रदाता/मॉडल चुनते हैं, तो मेल खाने वाला प्रदाता प्रमाणीकरण/API कुंजी भी कॉन्फ़िगर करें।
mediaModels.video: या तो एक स्ट्रिंग ("provider/model") या एक ऑब्जेक्ट ({ primary, fallbacks }) स्वीकार करता है।
- साझा वीडियो-जनरेशन क्षमता और अंतर्निहित video_generate टूल द्वारा उपयोग किया जाता है।
- सामान्य मान: qwen/wan2.6-t2v, qwen/wan2.6-i2v, qwen/wan2.6-r2v, qwen/wan2.6-r2v-flash, या qwen/wan2.7-r2v।
- इसे छोड़ने पर भी video_generate प्रमाणीकरण-समर्थित प्रदाता डिफ़ॉल्ट का अनुमान लगा सकता है। यह पहले वर्तमान डिफ़ॉल्ट प्रदाता को, फिर प्रदाता-ID क्रम में शेष पंजीकृत वीडियो-जनरेशन प्रदाताओं को आज़माता है।
- यदि आप सीधे कोई प्रदाता/मॉडल चुनते हैं, तो मेल खाने वाला प्रदाता प्रमाणीकरण/API कुंजी भी कॉन्फ़िगर करें।
- आधिकारिक Qwen वीडियो-जनरेशन Plugin अधिकतम 1 आउटपुट वीडियो, 1 इनपुट छवि, 4 इनपुट वीडियो, 10 सेकंड की अवधि और प्रदाता-स्तरीय size, aspectRatio, resolution, audio, तथा watermark विकल्पों का समर्थन करता है।
pdfModel: या तो एक स्ट्रिंग ("provider/model") या एक ऑब्जेक्ट ({ primary, fallbacks }) स्वीकार करता है।
- मॉडल रूटिंग के लिए pdf टूल द्वारा उपयोग किया जाता है।
- इसे छोड़ने पर, PDF टूल पहले imageModel, फिर समाधान किए गए सत्र/डिफ़ॉल्ट मॉडल का फ़ॉलबैक के रूप में उपयोग करता है।
pdfMaxMb: कॉल के समय maxBytesMb न दिए जाने पर pdf टूल के लिए डिफ़ॉल्ट PDF आकार सीमा।
pdfMaxPages: pdf टूल में निष्कर्षण फ़ॉलबैक मोड द्वारा विचार किए जाने वाले पृष्ठों की डिफ़ॉल्ट अधिकतम संख्या।
verboseDefault: एजेंटों के लिए डिफ़ॉल्ट वर्बोज़ स्तर। मान: "off", "on", "full"। डिफ़ॉल्ट: "off"।
toolProgressDetail: /verbose टूल सारांशों और प्रगति-ड्राफ़्ट टूल पंक्तियों के लिए विवरण मोड। मान: "explain" (डिफ़ॉल्ट, संक्षिप्त मानव-पठनीय लेबल) या "raw" (उपलब्ध होने पर अपरिष्कृत कमांड/विवरण जोड़ें)। प्रति-एजेंट agents.entries.*.toolProgressDetail इस डिफ़ॉल्ट को ओवरराइड करता है।
reasoningDefault: एजेंटों के लिए तर्क दृश्यता का डिफ़ॉल्ट। मान: "off", "on", "stream"। प्रति-एजेंट agents.entries.*.reasoningDefault इस डिफ़ॉल्ट को ओवरराइड करता है। कॉन्फ़िगर किए गए तर्क डिफ़ॉल्ट केवल स्वामियों, अधिकृत प्रेषकों या ऑपरेटर-व्यवस्थापक Gateway संदर्भों के लिए लागू होते हैं, जब कोई प्रति-संदेश या सत्र तर्क ओवरराइड सेट न हो।
elevatedDefault: एजेंटों के लिए उन्नत-आउटपुट का डिफ़ॉल्ट स्तर। मान: "off", "on", "ask", "full"। डिफ़ॉल्ट: "on"।
model.primary: प्रारूप provider/model (जैसे Codex OAuth एक्सेस के लिए openai/gpt-5.6-sol)। यदि आप प्रदाता छोड़ देते हैं, तो OpenClaw पहले उपनाम, फिर उसी सटीक मॉडल ID के लिए कॉन्फ़िगर किए गए प्रदाताओं में अद्वितीय मिलान आज़माता है, और उसके बाद ही कॉन्फ़िगर किए गए डिफ़ॉल्ट प्रदाता का फ़ॉलबैक के रूप में उपयोग करता है (बहिष्कृत संगतता व्यवहार, इसलिए स्पष्ट provider/model को प्राथमिकता दें)। यदि वह प्रदाता अब कॉन्फ़िगर किया गया डिफ़ॉल्ट मॉडल उपलब्ध नहीं कराता, तो OpenClaw पुराने, हटाए गए प्रदाता के डिफ़ॉल्ट को प्रदर्शित करने के बजाय पहले कॉन्फ़िगर किए गए प्रदाता/मॉडल का फ़ॉलबैक के रूप में उपयोग करता है।
contextTokens: वैकल्पिक एजेंट-व्यापी सीमा। यह किसी बड़े मॉडल के प्रभावी बजट को कम कर सकती है, लेकिन किसी मॉडल को उसके कॉन्फ़िगर या खोजे गए contextTokens से ऊपर नहीं बढ़ा सकती। किसी एक प्रत्यक्ष OpenAI मॉडल के लिए उसकी बड़ी नेटिव विंडो चुनने हेतु, उस मॉडल के लिए models.providers.openai.models[].contextWindow और contextTokens सेट करें; OpenAI संदर्भ विंडो डिफ़ॉल्ट देखें।
models: कॉन्फ़िगर किए गए उपनाम और प्रति-मॉडल सेटिंग। प्रत्येक प्रविष्टि में alias (शॉर्टकट) और params (प्रदाता-विशिष्ट, उदाहरण के लिए temperature, maxTokens, cacheRetention, context1m, responsesServerCompaction, responsesCompactThreshold, OpenRouter provider रूटिंग, chat_template_kwargs, extra_body/extraBody) शामिल हो सकते हैं। प्रविष्टियाँ जोड़ने से मॉडल ओवरराइड प्रतिबंधित नहीं होते।
- हर मॉडल ID को मैन्युअल रूप से सूचीबद्ध किए बिना चयनित प्रदाताओं के सभी खोजे गए मॉडल दिखाने के लिए "openai/*": {} या "vllm/*": {} जैसी provider/* प्रविष्टियों का उपयोग करें।
- जब किसी प्रदाता के प्रत्येक गतिशील रूप से खोजे गए मॉडल को समान रनटाइम का उपयोग करना हो, तो provider/* प्रविष्टि में agentRuntime जोड़ें। सटीक provider/model रनटाइम नीति फिर भी वाइल्डकार्ड पर प्राथमिकता रखती है।
- सुरक्षित मेटाडेटा संपादन: प्रविष्टियाँ जोड़ने के लिए openclaw config set agents.defaults.models '<json>' --strict-json --merge का उपयोग करें। जब तक आप --replace पास न करें, config set ऐसे प्रतिस्थापन अस्वीकार करता है जो मौजूदा प्रविष्टियाँ हटा देंगे।
modelPolicy.allow: स्पष्ट ओवरराइड अनुमति-सूची। उपनाम, सटीक provider/model संदर्भ और openai/* या clawrouter/anthropic/* जैसे अंतिम उपसर्ग वाइल्डकार्ड स्वीकार करता है। किसी भी मॉडल को अनुमति देने के लिए इसे छोड़ दें या [] का उपयोग करें। agents.entries.*.modelPolicy.allow उस एजेंट के लिए डिफ़ॉल्ट नीति को प्रतिस्थापित करता है; स्पष्ट खाली सूची उस एजेंट के लिए सभी को अनुमति देना चुनती है।
- प्रदाता-सीमित कॉन्फ़िगरेशन/ऑनबोर्डिंग प्रवाह चयनित प्रदाता मॉडल को इस मैप में मर्ज करते हैं और पहले से कॉन्फ़िगर किए गए असंबंधित प्रदाताओं को सुरक्षित रखते हैं।
- प्रत्यक्ष OpenAI Responses मॉडल के लिए, सर्वर-साइड Compaction स्वचालित रूप से सक्षम होता है। context_management इंजेक्ट करना बंद करने के लिए params.responsesServerCompaction: false, या सीमा ओवरराइड करने के लिए params.responsesCompactThreshold का उपयोग करें। OpenAI सर्वर-साइड Compaction देखें।
params: सभी मॉडलों पर लागू वैश्विक डिफ़ॉल्ट प्रदाता पैरामीटर। agents.defaults.params पर सेट करें (जैसे { cacheRetention: "long" })।
params मर्ज प्राथमिकता (कॉन्फ़िगरेशन): agents.defaults.params (वैश्विक आधार) को agents.defaults.models["provider/model"].params (प्रति-मॉडल) ओवरराइड करता है, फिर agents.entries.*.params (मेल खाती एजेंट ID) कुंजी के अनुसार ओवरराइड करता है। विवरण के लिए प्रॉम्प्ट कैशिंग देखें।
models.providers.openrouter.params.provider: OpenRouter-व्यापी डिफ़ॉल्ट प्रदाता-रूटिंग नीति। OpenClaw इसे OpenRouter के अनुरोध provider ऑब्जेक्ट में अग्रेषित करता है; प्रति-मॉडल agents.defaults.models["openrouter/<model>"].params.provider और एजेंट पैरामीटर कुंजी के अनुसार ओवरराइड करते हैं। OpenRouter प्रदाता रूटिंग देखें।
params.extra_body/params.extraBody: OpenAI-संगत प्रॉक्सी के api: "openai-completions" अनुरोध निकायों में मर्ज किया गया उन्नत पास-थ्रू JSON। यदि यह जनरेट की गई अनुरोध कुंजियों से टकराता है, तो अतिरिक्त निकाय को प्राथमिकता मिलती है; गैर-नेटिव completions मार्ग इसके बाद भी केवल-OpenAI store को हटा देते हैं।
params.chat_template_kwargs: शीर्ष-स्तरीय api: "openai-completions" अनुरोध निकायों में मर्ज किए गए vLLM/OpenAI-संगत चैट-टेम्पलेट तर्क। तर्क बंद होने पर vllm/nemotron-3-* के लिए, बंडल किया गया vLLM Plugin स्वचालित रूप से enable_thinking: false और force_nonempty_content: true भेजता है; स्पष्ट chat_template_kwargs जनरेट किए गए डिफ़ॉल्ट को ओवरराइड करते हैं और extra_body.chat_template_kwargs की प्राथमिकता फिर भी अंतिम रहती है। कॉन्फ़िगर किए गए vLLM Qwen और Nemotron तर्क मॉडल बहु-स्तरीय प्रयास क्रम के बजाय द्विआधारी /think विकल्प (off, on) उपलब्ध कराते हैं।
compat.thinkingFormat: OpenAI-संगत तर्क पेलोड शैली। Together-शैली reasoning.enabled के लिए "together", Qwen-शैली शीर्ष-स्तरीय enable_thinking के लिए "qwen", या अनुरोध-स्तरीय चैट-टेम्पलेट kwargs का समर्थन करने वाले Qwen-परिवार बैकएंड, जैसे vLLM, पर chat_template_kwargs.enable_thinking के लिए "qwen-chat-template" का उपयोग करें। OpenClaw अक्षम तर्क को false और सक्षम तर्क को true पर मैप करता है, और कॉन्फ़िगर किए गए vLLM Qwen मॉडल इन प्रारूपों के लिए द्विआधारी /think विकल्प उपलब्ध कराते हैं।
compat.supportedReasoningEfforts: प्रति-मॉडल OpenAI-संगत रीजनिंग प्रयास सूची। उन कस्टम एंडपॉइंट के लिए "xhigh" शामिल करें जो वास्तव में इसे स्वीकार करते हैं; इसके बाद OpenClaw उस कॉन्फ़िगर किए गए प्रदाता/मॉडल के लिए कमांड मेनू, Gateway सत्र पंक्तियों, सत्र पैच सत्यापन, एजेंट CLI सत्यापन और llm-task सत्यापन में /think xhigh उपलब्ध कराता है। जब बैकएंड को किसी मानक स्तर के लिए प्रदाता-विशिष्ट मान चाहिए, तो compat.reasoningEffortMap का उपयोग करें।
params.preserveThinking: संरक्षित चिंतन के लिए केवल Z.AI का ऑप्ट-इन। इसके सक्षम होने और चिंतन चालू होने पर, OpenClaw thinking.clear_thinking: false भेजता है और पिछले reasoning_content को फिर से चलाता है; Z.AI चिंतन और संरक्षित चिंतन देखें।
localService: स्थानीय/स्वयं-होस्ट किए गए मॉडल सर्वरों के लिए वैकल्पिक प्रदाता-स्तरीय प्रक्रिया प्रबंधक। जब चयनित मॉडल उस प्रदाता से संबंधित होता है, तो OpenClaw healthUrl (या baseUrl + "/models") की जाँच करता है, एंडपॉइंट बंद होने पर args के साथ command शुरू करता है, readyTimeoutMs तक प्रतीक्षा करता है और फिर मॉडल अनुरोध भेजता है। command एक निरपेक्ष पथ होना चाहिए। idleStopMs: 0 प्रक्रिया को OpenClaw के बंद होने तक सक्रिय रखता है; धनात्मक मान OpenClaw द्वारा शुरू की गई प्रक्रिया को उतने मिलीसेकंड तक निष्क्रिय रहने के बाद रोक देता है। स्थानीय मॉडल सेवाएँ देखें।
रनटाइम नीति प्रदाताओं या मॉडलों पर होती है, agents.defaults पर नहीं। प्रदाता-व्यापी नियमों के लिए models.providers.<provider>.agentRuntime या मॉडल-विशिष्ट नियमों के लिए agents.defaults.models["provider/model"].agentRuntime / agents.entries.*.models["provider/model"].agentRuntime का उपयोग करें। केवल प्रदाता/मॉडल उपसर्ग कभी भी किसी हार्नेस का चयन नहीं करता। रनटाइम सेट न होने या auto होने पर, OpenAI केवल बिना किसी लिखित अनुरोध ओवरराइड वाले सटीक आधिकारिक HTTPS Platform Responses या ChatGPT Responses रूट के लिए Codex को अप्रत्यक्ष रूप से चुन सकता है। OpenAI का अप्रत्यक्ष एजेंट रनटाइम देखें।
इन फ़ील्ड को बदलने वाले कॉन्फ़िगरेशन राइटर (उदाहरण के लिए /models set, /models set-image और फ़ॉलबैक जोड़ने/हटाने वाले कमांड) मानक ऑब्जेक्ट स्वरूप सहेजते हैं और जहाँ संभव हो, मौजूदा फ़ॉलबैक सूचियाँ बनाए रखते हैं।
maxConcurrent: सत्रों में समानांतर एजेंट रन की अधिकतम संख्या (प्रत्येक सत्र फिर भी क्रमिक रहता है)। डिफ़ॉल्ट: 4।

रनटाइम नीति

json5

{  models: {    providers: {      openai: {        agentRuntime: { id: "codex" },      },    },  },  agents: {    defaults: {      model: "openai/gpt-5.6-sol",      models: {        "anthropic/claude-opus-5": {          agentRuntime: { id: "claude-cli" },        },        "vllm/*": {          agentRuntime: { id: "openclaw" },        },      },    },  },}

id: "auto", "openclaw", एक पंजीकृत Plugin हार्नेस आईडी, या समर्थित CLI बैकएंड उपनाम। बंडल किया गया Codex Plugin codex पंजीकृत करता है; बंडल किया गया Anthropic Plugin claude-cli CLI बैकएंड प्रदान करता है।
id: "auto" पंजीकृत Plugin हार्नेस को उन प्रभावी रूटों का दावा करने देता है जो उनके समर्थन अनुबंध की घोषणा करते हैं या अन्यथा उसे पूरा करते हैं, और किसी हार्नेस के मेल न खाने पर OpenClaw का उपयोग करता है। id: "codex" जैसा स्पष्ट Plugin रनटाइम उस हार्नेस और एक संगत प्रभावी रूट की आवश्यकता रखता है; इनमें से कोई भी अनुपलब्ध होने या निष्पादन विफल होने पर यह बंद स्थिति में विफल होता है।
id: "pi" को v2026.5.22 और उससे पहले के संस्करणों से जारी किए गए कॉन्फ़िग सुरक्षित रखने के लिए केवल openclaw के बहिष्कृत उपनाम के रूप में स्वीकार किया जाता है। नए कॉन्फ़िग में openclaw का उपयोग किया जाना चाहिए।
रनटाइम की वरीयता में पहले सटीक मॉडल नीति (agents.entries.*.models["provider/model"], agents.defaults.models["provider/model"], या models.providers.<provider>.models[]), फिर agents.entries.* / agents.defaults.models["provider/*"], और उसके बाद models.providers.<provider>.agentRuntime पर प्रदाता-व्यापी नीति आती है।
संपूर्ण एजेंट के रनटाइम कुंजियाँ विरासती हैं। रनटाइम चयन द्वारा agents.defaults.agentRuntime, agents.entries.*.agentRuntime, सत्र रनटाइम पिन और OPENCLAW_AGENT_RUNTIME को अनदेखा किया जाता है। पुराने मान हटाने के लिए openclaw doctor --fix चलाएँ।
लेखक द्वारा दिए गए अनुरोध ओवरराइड से रहित पात्र, सटीक, आधिकारिक HTTPS OpenAI Responses/ChatGPT रूट Codex हार्नेस का अंतर्निहित रूप से उपयोग कर सकते हैं। प्रदाता/मॉडल agentRuntime.id: "codex" Codex को बंद स्थिति में विफल होने वाली आवश्यकता बनाता है, लेकिन किसी असंगत रूट को संगत नहीं बनाता।
Claude CLI परिनियोजनों के लिए, model: "anthropic/claude-opus-5" के साथ मॉडल-स्कोप वाला agentRuntime.id: "claude-cli" प्राथमिकता से उपयोग करें। विरासती claude-cli/<model> संदर्भ संगतता के लिए अब भी काम करते हैं, लेकिन नए कॉन्फ़िग में प्रदाता/मॉडल चयन को कैनोनिकल रखा जाना चाहिए और निष्पादन बैकएंड को प्रदाता/मॉडल रनटाइम नीति में रखा जाना चाहिए।
यह केवल टेक्स्ट एजेंट-टर्न निष्पादन नियंत्रित करता है। मीडिया जनरेशन, विज़न, PDF, संगीत, वीडियो और TTS अब भी अपनी प्रदाता/मॉडल सेटिंग का उपयोग करते हैं।

अंतर्निर्मित उपनाम संक्षिप्त रूप (केवल तब लागू होते हैं जब मॉडल agents.defaults.models में हो):

उपनाम	मॉडल
`opus`	`anthropic/claude-opus-5`
`sonnet`	`anthropic/claude-sonnet-5`
`gpt`	`openai/gpt-5.4`
`gpt-mini`	`openai/gpt-5.4-mini`
`gpt-nano`	`openai/gpt-5.4-nano`
`gemini`	`google/gemini-3.1-pro-preview`
`gemini-flash`	`google/gemini-3-flash-preview`
`gemini-flash-lite`	`google/gemini-3.1-flash-lite`

आपके कॉन्फ़िगर किए गए उपनामों को हमेशा डिफ़ॉल्ट पर वरीयता मिलती है।

Z.AI GLM-4.x मॉडल स्वचालित रूप से चिंतन मोड सक्षम करते हैं, जब तक कि आप --thinking off सेट न करें या स्वयं agents.defaults.models["zai/<model>"].params.thinking परिभाषित न करें। Z.AI मॉडल टूल कॉल स्ट्रीमिंग के लिए डिफ़ॉल्ट रूप से tool_stream सक्षम करते हैं। इसे अक्षम करने के लिए agents.defaults.models["zai/<model>"].params.tool_stream को false पर सेट करें। OpenClaw में Anthropic Claude Opus 4.8 डिफ़ॉल्ट रूप से चिंतन बंद रखता है; अनुकूली चिंतन स्पष्ट रूप से सक्षम होने पर, Anthropic का प्रदाता-स्वामित्व वाला प्रयास डिफ़ॉल्ट high होता है। कोई स्पष्ट चिंतन स्तर सेट न होने पर Claude 4.6 मॉडल डिफ़ॉल्ट रूप से adaptive का उपयोग करते हैं।

CLI बैकएंड चयन

CLI अडैप्टर की कार्यप्रणाली Plugins द्वारा पंजीकृत की जाती है, एजेंट डिफ़ॉल्ट के अंतर्गत कॉन्फ़िगर नहीं की जाती। ऊपर दिखाए अनुसार मॉडल-स्कोप वाले agentRuntime.id से पंजीकृत CLI बैकएंड चुनें। संचालन के लिए CLI बैकएंड और कमांड, सत्र, छवि तथा पार्सर पंजीकरण के लिए CLI बैकएंड Plugins बनाना देखें।

`agents.defaults.promptOverlays`

OpenClaw द्वारा संयोजित प्रॉम्प्ट सतहों पर मॉडल परिवार के अनुसार लागू किए गए प्रदाता-स्वतंत्र प्रॉम्प्ट ओवरले। GPT-5-परिवार मॉडल आईडी को OpenClaw/प्रदाता रूटों में साझा व्यवहार अनुबंध मिलता है; personality केवल मैत्रीपूर्ण अंतःक्रिया-शैली परत नियंत्रित करता है। नेटिव Codex ऐप-सर्वर रूट इस OpenClaw GPT-5 ओवरले के बजाय Codex-स्वामित्व वाले आधार/मॉडल निर्देश बनाए रखते हैं, और OpenClaw नेटिव थ्रेड के लिए Codex का अंतर्निर्मित व्यक्तित्व अक्षम करता है।

json5

{  agents: {    defaults: {      promptOverlays: {        gpt5: {          personality: "friendly", // friendly | on | off        },      },    },  },}

"friendly" (डिफ़ॉल्ट) और "on" मैत्रीपूर्ण अंतःक्रिया-शैली परत सक्षम करते हैं।
"off" केवल मैत्रीपूर्ण परत अक्षम करता है; टैग किया गया GPT-5 व्यवहार अनुबंध सक्षम रहता है।
यह साझा सेटिंग सेट न होने पर विरासती plugins.entries.openai.config.personality अब भी पढ़ा जाता है।

`agents.defaults.heartbeat`

आवधिक Heartbeat रन।

json5

{  agents: {    defaults: {      heartbeat: {        every: "30m", // 0m अक्षम करता है        model: "openai/gpt-5.4-mini",        includeReasoning: false,        includeSystemPromptSection: true, // डिफ़ॉल्ट: true; false सिस्टम प्रॉम्प्ट से Heartbeat अनुभाग हटा देता है        lightContext: false, // डिफ़ॉल्ट: false; true Heartbeat रन के लिए वर्कस्पेस बूटस्ट्रैप फ़ाइलें छोड़ देता है        isolatedSession: false, // डिफ़ॉल्ट: false; true प्रत्येक Heartbeat को नए सत्र में चलाता है (कोई वार्तालाप इतिहास नहीं)        skipWhenBusy: false, // डिफ़ॉल्ट: false; true इस एजेंट की सबएजेंट/नेस्टेड लेन की भी प्रतीक्षा करता है        session: "main",        to: "+15555550123",        directPolicy: "allow", // allow (डिफ़ॉल्ट) | block        target: "none", // डिफ़ॉल्ट: none | विकल्प: last | whatsapp | telegram | discord | ...        prompt: "Heartbeat मॉनिटर के अस्थायी संदर्भ का अनुसरण करें...",        ackMaxChars: 300,        suppressToolErrorWarnings: false,        timeoutSeconds: 45,      },    },  },}

every: अवधि स्ट्रिंग (ms/s/m/h)। डिफ़ॉल्ट: 30m (API-कुंजी प्रमाणीकरण) या 1h (OAuth प्रमाणीकरण)। अक्षम करने के लिए 0m पर सेट करें।
आवृत्ति सिस्टम-स्वामित्व वाली Cron मॉनिटर पंक्ति में लिखी जाती है। अनुपलब्ध या पुरानी पंक्ति को साकार करने के लिए openclaw doctor --fix चलाएँ। Cron अक्षम होने पर निर्धारित Heartbeat नहीं चलते और Gateway स्टार्टअप चेतावनी लॉग करता है।
includeSystemPromptSection: false होने पर सिस्टम प्रॉम्प्ट से Heartbeat अनुभाग हटा देता है। डिफ़ॉल्ट: true।
suppressToolErrorWarnings: true होने पर Heartbeat रन के दौरान टूल त्रुटि चेतावनी पेलोड दबा देता है।
timeoutSeconds: Heartbeat एजेंट टर्न को निरस्त किए जाने से पहले उसके लिए अनुमत अधिकतम समय, सेकंड में। सेट न करके छोड़ने पर, यदि agents.defaults.timeoutSeconds सेट है तो उसका उपयोग होता है, अन्यथा अधिकतम 600 सेकंड तक सीमित Heartbeat आवृत्ति का।
directPolicy: प्रत्यक्ष/DM डिलीवरी नीति। allow (डिफ़ॉल्ट) प्रत्यक्ष-लक्ष्य डिलीवरी की अनुमति देता है। block प्रत्यक्ष-लक्ष्य डिलीवरी दबाता है और reason=dm-blocked उत्सर्जित करता है।
lightContext: true होने पर Heartbeat रन हल्के बूटस्ट्रैप संदर्भ का उपयोग करते हैं और वर्कस्पेस बूटस्ट्रैप फ़ाइलें छोड़ देते हैं। दोनों स्थितियों में मॉनिटर का अस्थायी संदर्भ Heartbeat रनर द्वारा अंतःक्षेपित किया जाता है।
isolatedSession: true होने पर प्रत्येक Heartbeat बिना किसी पूर्व वार्तालाप इतिहास के नए सत्र में चलता है। Cron sessionTarget: "isolated" के समान पृथक्करण पैटर्न। प्रति-Heartbeat टोकन लागत को ~100K से घटाकर ~2-5K टोकन करता है।
skipWhenBusy: true होने पर Heartbeat रन उस एजेंट की अतिरिक्त व्यस्त लेन के कारण स्थगित होते हैं: उसका अपना सत्र-कुंजी वाला सबएजेंट या नेस्टेड कमांड कार्य। इस फ़्लैग के बिना भी Cron लेन हमेशा Heartbeat को स्थगित करती हैं।
प्रति एजेंट: agents.entries.*.heartbeat सेट करें। जब कोई भी एजेंट heartbeat परिभाषित करता है, तो केवल वे एजेंट Heartbeat चलाते हैं।
Heartbeat पूर्ण एजेंट टर्न चलाते हैं — छोटे अंतराल अधिक टोकन खर्च करते हैं।

`agents.defaults.compaction`

json5

{  agents: {    defaults: {      compaction: {        mode: "safeguard", // default | safeguard        provider: "my-provider", // पंजीकृत Compaction प्रदाता Plugin की आईडी (वैकल्पिक)        thinkingLevel: "low", // वैकल्पिक, केवल Compaction के लिए चिंतन ओवरराइड        timeoutSeconds: 180,        keepRecentTokens: 50000,        recentTurnsPreserve: 3,        identifierPolicy: "strict", // strict | off        qualityGuard: { enabled: true, maxRetries: 1 },        midTurnPrecheck: { enabled: false }, // वैकल्पिक टूल-लूप दबाव जाँच        postIndexSync: "async", // off | async | await        postCompactionSections: ["सत्र आरंभ", "लाल रेखाएँ"],        model: "openrouter/anthropic/claude-sonnet-4-6", // वैकल्पिक, केवल Compaction के लिए मॉडल ओवरराइड        truncateAfterCompaction: true, // Compaction के बाद छोटे उत्तराधिकारी JSONL पर घुमाएँ        maxActiveTranscriptBytes: "20mb", // वैकल्पिक प्रीफ़्लाइट स्थानीय Compaction ट्रिगर        notifyUser: true, // Compaction शुरू/पूर्ण होने और मेमोरी-फ्लश अवनति पर सूचनाएँ (डिफ़ॉल्ट: false)        memoryFlush: {          enabled: true,          model: "ollama/qwen3:8b", // वैकल्पिक, केवल मेमोरी-फ्लश के लिए मॉडल ओवरराइड          softThresholdTokens: 6000,          forceFlushTranscriptBytes: "2mb",        },      },    },  },}

mode: default या safeguard (लंबे इतिहास के लिए खंडित सारांश)। Compaction देखें।
provider: पंजीकृत Compaction प्रदाता Plugin की आईडी। इसे सेट करने पर अंतर्निहित LLM सारांश के बजाय प्रदाता का summarize() कॉल किया जाता है। विफल होने पर अंतर्निहित विकल्प पर वापस जाता है। प्रदाता सेट करने से mode: "safeguard" बाध्य हो जाता है। Compaction देखें।
thinkingLevel: वैकल्पिक चिंतन स्तर, जिसका उपयोग केवल एम्बेडेड OpenClaw Compaction सारांशों (off, minimal, low, medium, high, xhigh, adaptive, max, या ultra) के लिए किया जाता है। यह सत्र के वर्तमान चिंतन स्तर को ओवरराइड करता है और चयनित Compaction मॉडल/रनटाइम की सीमा में सीमित किया जाता है। सत्र स्तर इनहेरिट करने के लिए इसे सेट न करें। नेटिव Codex app-server Compaction इस सेटिंग की उपेक्षा करता है, क्योंकि नेटिव compact अनुरोध में प्रत्येक ऑपरेशन के लिए चिंतन ओवरराइड नहीं होता; इसे कॉन्फ़िगर किए जाने पर OpenClaw चेतावनी लॉग करता है।
timeoutSeconds: OpenClaw द्वारा किसी एक Compaction ऑपरेशन को निरस्त करने से पहले उसके लिए अनुमत अधिकतम सेकंड। डिफ़ॉल्ट: 180।
keepRecentTokens: सबसे हाल की ट्रांसक्रिप्ट टेल को अक्षरशः बनाए रखने के लिए एजेंट कट-पॉइंट बजट। स्पष्ट रूप से सेट होने पर मैन्युअल /compact इसका पालन करता है; अन्यथा मैन्युअल Compaction एक कठोर चेकपॉइंट होता है।
recentTurnsPreserve: सुरक्षा-सारांश के बाहर अक्षरशः रखे जाने वाले सबसे हाल के उपयोगकर्ता/सहायक टर्न की संख्या। डिफ़ॉल्ट: 3।
identifierPolicy: strict (डिफ़ॉल्ट) या off। strict Compaction सारांश के दौरान अंतर्निहित अपारदर्शी पहचानकर्ता प्रतिधारण मार्गदर्शन को पहले जोड़ता है।
qualityGuard: सुरक्षा-सारांशों के लिए विकृत आउटपुट पर पुनः प्रयास की जाँच। सुरक्षा मोड में डिफ़ॉल्ट रूप से सक्षम; ऑडिट छोड़ने के लिए enabled: false सेट करें।
midTurnPrecheck: वैकल्पिक टूल-लूप दबाव जाँच। जब enabled: true हो, तो OpenClaw टूल परिणाम जोड़े जाने के बाद और अगले मॉडल कॉल से पहले संदर्भ दबाव की जाँच करता है। यदि संदर्भ अब समाहित नहीं हो सकता, तो यह प्रॉम्प्ट सबमिट करने से पहले वर्तमान प्रयास निरस्त करता है और टूल परिणामों को छोटा करने या Compaction करके पुनः प्रयास करने के लिए मौजूदा पूर्व-जाँच पुनर्प्राप्ति पथ का पुनः उपयोग करता है। default और safeguard दोनों Compaction मोड के साथ काम करता है। डिफ़ॉल्ट: अक्षम।
postIndexSync: Compaction के बाद सत्र-मेमोरी पुनः अनुक्रमण मोड। डिफ़ॉल्ट: "async"। सर्वाधिक ताज़गी के लिए "await", कम Compaction विलंबता के लिए "async", या केवल तब "off" उपयोग करें जब सत्र-मेमोरी सिंक कहीं और संभाला जाता हो।
postCompactionSections: Compaction के बाद पुनः इंजेक्ट करने के लिए वैकल्पिक AGENTS.md H2/H3 अनुभाग नाम। अक्षम करने के लिए इसे सेट न करें या [] उपयोग करें।
model: केवल Compaction सारांश के लिए वैकल्पिक provider/model-id या agents.defaults.models से साधारण उपनाम। साधारण उपनाम डिस्पैच से पहले रिज़ॉल्व होते हैं; टकराव होने पर कॉन्फ़िगर किए गए शाब्दिक मॉडल आईडी की प्राथमिकता बनी रहती है। इसका उपयोग तब करें जब मुख्य सत्र में एक मॉडल बना रहना चाहिए, लेकिन Compaction सारांश किसी अन्य मॉडल पर चलने चाहिए; सेट न होने पर Compaction सत्र के प्राथमिक मॉडल का उपयोग करता है।
truncateAfterCompaction: Compaction के बाद सक्रिय सत्र ट्रांसक्रिप्ट को घुमाता है, ताकि भविष्य के टर्न केवल सारांश और असारांशित टेल लोड करें, जबकि पिछली पूरी ट्रांसक्रिप्ट संग्रहित रहे। लंबे समय तक चलने वाले सत्रों में सक्रिय ट्रांसक्रिप्ट की असीमित वृद्धि रोकता है। डिफ़ॉल्ट: false।
maxActiveTranscriptBytes: वैकल्पिक बाइट सीमा (number या "20mb" जैसी स्ट्रिंग), जो ट्रांसक्रिप्ट इतिहास के सीमा से आगे बढ़ने पर रन से पहले सामान्य स्थानीय Compaction ट्रिगर करती है। truncateAfterCompaction आवश्यक है, ताकि सफल Compaction छोटे उत्तरवर्ती ट्रांसक्रिप्ट पर घुमा सके। सेट न होने या 0 होने पर अक्षम।
notifyUser: जब true हो, तो उपयोगकर्ता को संक्षिप्त संदर्भ-रखरखाव सूचनाएँ भेजता है: Compaction आरंभ और पूरा होने पर (उदाहरण के लिए, "संदर्भ का Compaction किया जा रहा है..." और "Compaction पूर्ण"), तथा जब Compaction-पूर्व मेमोरी फ्लश समाप्त हो जाए और उत्तर अवक्रमित अवस्था में जारी रहे (उदाहरण के लिए, "मेमोरी रखरखाव अस्थायी रूप से विफल हुआ; आपका उत्तर जारी रखा जा रहा है।")। इन सूचनाओं को मौन रखने के लिए डिफ़ॉल्ट रूप से अक्षम।
memoryFlush: टिकाऊ स्मृतियाँ संग्रहीत करने के लिए स्वचालित Compaction से पहले मौन एजेंटिक टर्न। जब इस रखरखाव टर्न को स्थानीय मॉडल पर बनाए रखना हो, तो model को ollama/qwen3:8b जैसे सटीक प्रदाता/मॉडल पर सेट करें; ओवरराइड सक्रिय सत्र की फ़ॉलबैक शृंखला इनहेरिट नहीं करता। ट्रांसक्रिप्ट आकार सीमा तक पहुँचने पर forceFlushTranscriptBytes फ्लश को बाध्य करता है, भले ही टोकन काउंटर पुराने हों। कार्यस्थान केवल-पठन होने पर इसे छोड़ दिया जाता है।

कस्टम Compaction निर्देश कोड के स्वामित्व में होते हैं। कस्टम सारांश निर्माण के लिए summarize() वाला Compaction प्रदाता Plugin लागू करें, और जब Compaction के बाद के संदर्भ को बाद के मॉडल प्रॉम्प्ट में इंजेक्ट करना आवश्यक हो, तो before_prompt_build उपयोग करें। Doctor सेवानिवृत्त निर्देश फ़ील्ड हटाता है और इन सीमों की ओर संकेत करता है।

`agents.defaults.contextPruning`

LLM को भेजने से पहले इन-मेमोरी संदर्भ से पुराने टूल परिणामों को हटाता है। डिस्क पर सत्र इतिहास को संशोधित नहीं करता। डिफ़ॉल्ट रूप से अक्षम; सक्षम करने के लिए mode: "cache-ttl" सेट करें।

json5

{  agents: {    defaults: {      contextPruning: {        mode: "cache-ttl", // बंद (डिफ़ॉल्ट) | cache-ttl      },    },  },}

cache-ttl मोड का व्यवहार

mode: "cache-ttl" छँटाई पास सक्षम करता है।
छँटाई पहले अत्यधिक बड़े टूल परिणामों को सॉफ़्ट-ट्रिम करती है, फिर आवश्यकता होने पर पुराने टूल परिणामों को पूरी तरह साफ़ करती है।

सॉफ़्ट-ट्रिम आरंभ + अंत को बनाए रखता है और बीच में ... डालता है।

हार्ड-क्लियर पूरे टूल परिणाम को प्लेसहोल्डर से बदल देता है।

टिप्पणियाँ:

छवि ब्लॉक कभी ट्रिम/साफ़ नहीं किए जाते।
अनुपात वर्ण-आधारित (अनुमानित) होते हैं, सटीक टोकन गणना नहीं।
सबसे हाल के सहायक संदेश सुरक्षित रखे जाते हैं।

व्यवहार के विवरण के लिए सत्र छँटाई देखें।

ब्लॉक स्ट्रीमिंग

json5

{  agents: {    defaults: {      blockStreamingDefault: "off", // चालू | बंद      blockStreamingBreak: "text_end", // text_end | message_end      blockStreamingChunk: { minChars: 800, maxChars: 1200, breakPreference: "paragraph" },      blockStreamingCoalesce: { idleMs: 1000 },      humanDelay: { mode: "natural" }, // बंद (डिफ़ॉल्ट) | प्राकृतिक | कस्टम (minMs/maxMs उपयोग करें)    },  },}

Telegram के अलावा अन्य चैनलों में ब्लॉक उत्तर सक्षम करने के लिए स्पष्ट *.streaming.block.enabled: true आवश्यक है। QQ Bot अपवाद है: उसमें streaming.block कुंजियाँ नहीं हैं और जब तक channels.qqbot.streaming.mode, "off" न हो, वह ब्लॉक उत्तर स्ट्रीम करता है।
चैनल ओवरराइड: channels.<channel>.streaming.block.coalesce (और प्रति-अकाउंट प्रकार)। Discord, Google Chat, Mattermost, MS Teams, Signal, और Slack में डिफ़ॉल्ट minChars: 1500 / idleMs: 1000 होता है।
blockStreamingChunk.breakPreference: पसंदीदा खंड सीमा ("paragraph" | "newline" | "sentence")।
humanDelay: ब्लॉक उत्तरों के बीच यादृच्छिक विराम। डिफ़ॉल्ट: off। natural = 800-2500ms। custom, minMs/maxMs का उपयोग करता है (किसी भी सेट न की गई सीमा के लिए प्राकृतिक रेंज पर वापस जाता है)। प्रति-एजेंट ओवरराइड: agents.entries.*.humanDelay।

व्यवहार + खंडीकरण के विवरण के लिए स्ट्रीमिंग देखें।

टाइपिंग संकेतक

json5

{  agents: {    defaults: {      typingMode: "instant", // कभी नहीं | तत्काल | चिंतन | संदेश      typingIntervalSeconds: 6,    },  },}

डिफ़ॉल्ट: प्रत्यक्ष चैट/उल्लेखों के लिए instant, बिना उल्लेख वाली समूह चैट के लिए message।
typingIntervalSeconds डिफ़ॉल्ट: 6।
प्रति-एजेंट ओवरराइड: agents.entries.*.typingMode।

टाइपिंग संकेतक देखें।

`agents.defaults.sandbox`

एम्बेडेड एजेंट के लिए वैकल्पिक सैंडबॉक्सिंग। पूरी मार्गदर्शिका के लिए सैंडबॉक्सिंग देखें।

json5

{  agents: {    defaults: {      sandbox: {        mode: "non-main", // बंद (डिफ़ॉल्ट) | non-main | सभी        backend: "docker", // docker (डिफ़ॉल्ट) | ssh | openshell        scope: "agent", // सत्र | एजेंट (डिफ़ॉल्ट) | साझा        workspaceAccess: "none", // कोई नहीं (डिफ़ॉल्ट) | ro | rw        workspaceRoot: "~/.openclaw/sandboxes",        docker: {          image: "openclaw-sandbox:bookworm-slim",          containerPrefix: "openclaw-sbx-",          workdir: "/workspace",          readOnlyRoot: true,          tmpfs: ["/tmp", "/var/tmp", "/run"],          network: "none",          user: "1000:1000",          capDrop: ["ALL"],          env: { LANG: "C.UTF-8" },          setupCommand: "apt-get update && apt-get install -y git curl jq",          pidsLimit: 256,          memory: "1g",          memorySwap: "2g",          cpus: 1,          gpus: "all",          ulimits: {            nofile: { soft: 1024, hard: 2048 },            nproc: 256,          },          seccompProfile: "/path/to/seccomp.json",          apparmorProfile: "openclaw-sandbox",          dns: ["1.1.1.1", "8.8.8.8"],          extraHosts: ["internal.service:10.0.0.5"],          binds: ["/home/user/source:/source:rw"],        },        ssh: {          target: "user@gateway-host:22",          command: "ssh",          workspaceRoot: "/tmp/openclaw-sandboxes",          strictHostKeyChecking: true,          updateHostKeys: true,          identityFile: "~/.ssh/id_ed25519",          certificateFile: "~/.ssh/id_ed25519-cert.pub",          knownHostsFile: "~/.ssh/known_hosts",          // SecretRefs / इनलाइन सामग्री भी समर्थित:          // identityData: { source: "env", provider: "default", id: "SSH_IDENTITY" },          // certificateData: { source: "env", provider: "default", id: "SSH_CERTIFICATE" },          // knownHostsData: { source: "env", provider: "default", id: "SSH_KNOWN_HOSTS" },        },        browser: {          enabled: false,          image: "openclaw-sandbox-browser:bookworm-slim",          network: "openclaw-sandbox-browser",          cdpPort: 9222,          cdpSourceRange: "172.21.0.1/32",          vncPort: 5900,          noVncPort: 6080,          headless: false,          enableNoVnc: true,          allowHostControl: false,          autoStart: true,          autoStartTimeoutMs: 12000,        },        prune: {          idleHours: 24,          maxAgeDays: 7,        },      },    },  },  tools: {    sandbox: {      tools: {        allow: [          "exec",          "process",          "read",          "write",          "edit",          "apply_patch",          "sessions_list",          "sessions_history",          "sessions_send",          "sessions_spawn",          "session_status",        ],        deny: ["browser", "canvas", "nodes", "cron", "discord", "gateway"],      },    },  },}

ऊपर दिखाए गए डिफ़ॉल्ट (off/docker/agent/none/bookworm-slim छवि/none नेटवर्क/आदि) वास्तविक OpenClaw डिफ़ॉल्ट हैं, केवल उदाहरणात्मक मान नहीं।

सैंडबॉक्स का विवरण

बैकएंड:

docker: स्थानीय Docker रनटाइम (डिफ़ॉल्ट)
ssh: सामान्य SSH-समर्थित रिमोट रनटाइम
openshell: OpenShell रनटाइम

जब backend: "openshell" चुना जाता है, तो रनटाइम-विशिष्ट सेटिंग्स plugins.entries.openshell.config में चली जाती हैं।

SSH बैकएंड कॉन्फ़िगरेशन:

target: user@host[:port] प्रारूप में SSH लक्ष्य
command: SSH क्लाइंट कमांड (डिफ़ॉल्ट: ssh)
workspaceRoot: प्रति-स्कोप कार्यस्थानों के लिए उपयोग किया जाने वाला निरपेक्ष रिमोट रूट (डिफ़ॉल्ट: /tmp/openclaw-sandboxes)
identityFile / certificateFile / knownHostsFile: OpenSSH को दी जाने वाली मौजूदा स्थानीय फ़ाइलें
identityData / certificateData / knownHostsData: इनलाइन सामग्री या SecretRefs, जिन्हें OpenClaw रनटाइम पर अस्थायी फ़ाइलों में साकार करता है
strictHostKeyChecking / updateHostKeys: OpenSSH होस्ट-कुंजी नीति नियंत्रण (दोनों का डिफ़ॉल्ट true)

SSH प्रमाणीकरण की प्राथमिकता:

identityData को identityFile पर प्राथमिकता मिलती है
certificateData को certificateFile पर प्राथमिकता मिलती है
knownHostsData को knownHostsFile पर प्राथमिकता मिलती है
SecretRef-समर्थित *Data मानों को सैंडबॉक्स सत्र शुरू होने से पहले सक्रिय सीक्रेट रनटाइम स्नैपशॉट से हल किया जाता है

SSH बैकएंड का व्यवहार:

बनाने या दोबारा बनाने के बाद रिमोट कार्यस्थान को एक बार प्रारंभिक डेटा से भरता है
फिर रिमोट SSH कार्यस्थान को कैनोनिकल बनाए रखता है
exec, फ़ाइल टूल और मीडिया पथों को SSH के माध्यम से रूट करता है
रिमोट परिवर्तनों को स्वचालित रूप से होस्ट पर वापस सिंक नहीं करता
सैंडबॉक्स ब्राउज़र कंटेनरों का समर्थन नहीं करता

कार्यस्थान की पहुँच:

none: ~/.openclaw/sandboxes के अंतर्गत प्रति-स्कोप सैंडबॉक्स कार्यस्थान (डिफ़ॉल्ट)
ro: /workspace पर सैंडबॉक्स कार्यस्थान, /agent पर केवल-पढ़ने के लिए माउंट किया गया एजेंट कार्यस्थान
rw: /workspace पर पढ़ने/लिखने के लिए माउंट किया गया एजेंट कार्यस्थान

स्कोप:

session: प्रति-सत्र कंटेनर + कार्यस्थान
agent: प्रत्येक एजेंट के लिए एक कंटेनर + कार्यस्थान (डिफ़ॉल्ट)
shared: साझा कंटेनर और कार्यस्थान (सत्रों के बीच कोई पृथक्करण नहीं)

OpenShell Plugin कॉन्फ़िगरेशन:

json5

{plugins: {  entries: {    openshell: {      enabled: true,      config: {        mode: "mirror", // mirror (default) | remote        command: "openshell",        from: "openclaw",        remoteWorkspaceDir: "/sandbox",        remoteAgentWorkspaceDir: "/agent",        gateway: "lab", // optional        gatewayEndpoint: "https://lab.example", // optional        policy: "strict", // optional OpenShell policy id        providers: ["openai"], // optional        autoProviders: true,        timeoutSeconds: 120,      },    },  },},}

OpenShell मोड:

mirror: निष्पादन से पहले स्थानीय से रिमोट को प्रारंभिक डेटा दें, निष्पादन के बाद वापस सिंक करें; स्थानीय कार्यस्थान कैनोनिकल रहता है
remote: सैंडबॉक्स बनने पर रिमोट को एक बार प्रारंभिक डेटा दें, फिर रिमोट कार्यस्थान को कैनोनिकल बनाए रखें

remote मोड में, प्रारंभिक डेटा देने के चरण के बाद OpenClaw के बाहर किए गए होस्ट-स्थानीय संपादन स्वचालित रूप से सैंडबॉक्स में सिंक नहीं होते। ट्रांसपोर्ट OpenShell सैंडबॉक्स में SSH के माध्यम से होता है, लेकिन Plugin सैंडबॉक्स जीवनचक्र और वैकल्पिक मिरर सिंक का स्वामी होता है।

setupCommand कंटेनर बनने के बाद एक बार चलता है (sh -lc के माध्यम से)। नेटवर्क इग्रेस, लिखने योग्य रूट और रूट उपयोगकर्ता आवश्यक हैं।

कंटेनरों का डिफ़ॉल्ट network: "none" है — यदि एजेंट को आउटबाउंड पहुँच चाहिए, तो इसे "bridge" (या किसी कस्टम ब्रिज नेटवर्क) पर सेट करें। "host" अवरुद्ध है। जब तक आप स्पष्ट रूप से sandbox.docker.dangerouslyAllowContainerNamespaceJoin: true (आपातकालीन अपवाद) सेट नहीं करते, "container:<id>" डिफ़ॉल्ट रूप से अवरुद्ध रहता है। सक्रिय OpenClaw सैंडबॉक्स में Codex ऐप-सर्वर टर्न अपने नेटिव कोड-मोड नेटवर्क एक्सेस के लिए इसी इग्रेस सेटिंग का उपयोग करते हैं।

इनबाउंड अटैचमेंट सक्रिय कार्यस्थान में media/inbound/* पर स्टेज किए जाते हैं।

docker.binds अतिरिक्त होस्ट डायरेक्टरियाँ माउंट करता है; वैश्विक और प्रति-एजेंट बाइंड को मर्ज किया जाता है।

सैंडबॉक्स किया गया ब्राउज़र (sandbox.browser.enabled, डिफ़ॉल्ट false): कंटेनर में Chromium + CDP। noVNC URL को सिस्टम प्रॉम्प्ट में इंजेक्ट किया जाता है। openclaw.json में browser.enabled की आवश्यकता नहीं होती। noVNC पर्यवेक्षक पहुँच डिफ़ॉल्ट रूप से VNC प्रमाणीकरण का उपयोग करती है और OpenClaw साझा URL में पासवर्ड उजागर करने के बजाय अल्पकालिक टोकन URL जारी करता है।

allowHostControl: false (डिफ़ॉल्ट) सैंडबॉक्स किए गए सत्रों को होस्ट ब्राउज़र को लक्ष्य बनाने से रोकता है।
network का डिफ़ॉल्ट openclaw-sandbox-browser (समर्पित ब्रिज नेटवर्क) है। इसे केवल तभी bridge पर सेट करें, जब आप स्पष्ट रूप से वैश्विक ब्रिज कनेक्टिविटी चाहते हों। यहाँ भी "host" अवरुद्ध है।
cdpSourceRange वैकल्पिक रूप से कंटेनर किनारे पर CDP इनग्रेस को किसी CIDR सीमा तक सीमित करता है (उदाहरण के लिए 172.21.0.1/32)।
sandbox.browser.binds अतिरिक्त होस्ट डायरेक्टरियों को केवल सैंडबॉक्स ब्राउज़र कंटेनर में माउंट करता है। सेट होने पर ([] सहित), यह ब्राउज़र कंटेनर के लिए docker.binds को प्रतिस्थापित करता है।
सैंडबॉक्स ब्राउज़र कंटेनर का Chromium हमेशा --no-sandbox --disable-setuid-sandbox के साथ लॉन्च होता है (कंटेनरों में वे कर्नेल प्रिमिटिव नहीं होते जिनकी Chrome के अपने सैंडबॉक्स को आवश्यकता होती है); इसके लिए कोई कॉन्फ़िगरेशन टॉगल नहीं है।
लॉन्च डिफ़ॉल्ट scripts/sandbox-browser-entrypoint.sh में परिभाषित हैं और कंटेनर होस्ट के लिए अनुकूलित हैं:
--remote-debugging-address=127.0.0.1
--remote-debugging-port=<derived from OPENCLAW_BROWSER_CDP_PORT>
--user-data-dir=${HOME}/.chrome
--no-first-run
--no-default-browser-check
--disable-dev-shm-usage
--disable-background-networking
--disable-breakpad
--disable-crash-reporter
--no-zygote
--metrics-recording-only
--password-store=basic
--use-mock-keychain
--disable-3d-apis, --disable-gpu, और --disable-software-rasterizer डिफ़ॉल्ट रूप से सक्षम हैं और यदि WebGL/3D उपयोग के लिए आवश्यक हो, तो OPENCLAW_BROWSER_DISABLE_GRAPHICS_FLAGS=0 से अक्षम किए जा सकते हैं।
--disable-extensions (डिफ़ॉल्ट रूप से सक्षम); यदि आपका कार्यप्रवाह एक्सटेंशन पर निर्भर करता है, तो OPENCLAW_BROWSER_DISABLE_EXTENSIONS=0 उन्हें फिर से सक्षम करता है।
डिफ़ॉल्ट रूप से --renderer-process-limit=2; इसे OPENCLAW_BROWSER_RENDERER_PROCESS_LIMIT=<N> से बदलें, Chromium की डिफ़ॉल्ट प्रक्रिया सीमा का उपयोग करने के लिए 0 सेट करें।
केवल तब --headless=new, जब headless सक्षम हो।
डिफ़ॉल्ट कंटेनर इमेज की आधाररेखा हैं; कंटेनर डिफ़ॉल्ट बदलने के लिए कस्टम एंट्रीपॉइंट वाली कस्टम ब्राउज़र इमेज का उपयोग करें।

ब्राउज़र सैंडबॉक्सिंग और sandbox.docker.binds केवल Docker के लिए हैं।

इमेज बनाएँ (सोर्स चेकआउट से):

bash

scripts/sandbox-setup.sh           # main sandbox imagescripts/sandbox-browser-setup.sh   # optional browser image

सोर्स चेकआउट के बिना npm इंस्टॉल के लिए, इनलाइन docker build कमांड हेतु सैंडबॉक्सिंग § इमेज और सेटअप देखें।

`agents.entries` (प्रति-एजेंट ओवरराइड)

किसी एजेंट को अपना TTS प्रदाता, आवाज़, मॉडल, शैली या स्वचालित-TTS मोड देने के लिए agents.entries.*.tts का उपयोग करें। एजेंट ब्लॉक वैश्विक tts पर डीप-मर्ज होता है, इसलिए साझा क्रेडेंशियल एक ही स्थान पर रह सकते हैं, जबकि अलग-अलग एजेंट केवल अपनी आवश्यक आवाज़ या प्रदाता फ़ील्ड ओवरराइड कर सकते हैं। सक्रिय एजेंट का ओवरराइड स्वचालित बोलकर दिए जाने वाले उत्तरों, /tts audio, /tts status, और tts एजेंट टूल पर लागू होता है। प्रदाता के उदाहरण और प्राथमिकता के लिए टेक्स्ट-टू-स्पीच देखें।

json5

{  agents: {    list: [      {        id: "main",        default: true,        name: "Main Agent",        workspace: "~/.openclaw/workspace",        agentDir: "~/.openclaw/agents/main/agent",        model: "anthropic/claude-opus-4-6", // or { primary, fallbacks }        utilityModel: "openai/gpt-5.4-mini",        thinkingDefault: "high", // per-agent thinking level override        reasoningDefault: "on", // per-agent reasoning visibility override        fastModeDefault: false, // per-agent fast mode override        params: { cacheRetention: "none" }, // overrides matching defaults.models params by key        tts: {          providers: {            elevenlabs: { speakerVoiceId: "EXAVITQu4vr4xnSDxMaL" },          },        },        skills: ["docs-search"], // replaces agents.defaults.skills when set        identity: {          name: "Samantha",          theme: "helpful sloth",          emoji: "🦥",          avatar: "avatars/samantha.png",        },        groupChat: { mentionPatterns: ["@openclaw"] },        sandbox: { mode: "off" },        runtime: {          type: "acp",          acp: {            agent: "codex",            backend: "acpx",            mode: "persistent", // persistent | oneshot            cwd: "/workspace/openclaw",          },        },        subagents: { allowAgents: ["*"] },        tools: {          profile: "coding",          allow: ["browser"],          deny: ["canvas"],          elevated: { enabled: true },        },      },    ],  },}

id: स्थिर एजेंट आईडी (आवश्यक)।
default: जब एकाधिक सेट हों, तो पहला प्रभावी होता है (चेतावनी लॉग की जाती है)। यदि कोई सेट न हो, तो सूची की पहली प्रविष्टि डिफ़ॉल्ट होती है।
model: स्ट्रिंग रूप बिना किसी मॉडल फ़ॉलबैक के सख्त प्रति-एजेंट प्राथमिक मॉडल सेट करता है; ऑब्जेक्ट रूप { primary } भी सख्त होता है, जब तक कि आप fallbacks न जोड़ें। उस एजेंट के लिए फ़ॉलबैक सक्षम करने हेतु { primary, fallbacks: [...] } का उपयोग करें, या सख्त व्यवहार स्पष्ट करने हेतु { primary, fallbacks: [] } का उपयोग करें। केवल primary को ओवरराइड करने वाले Cron जॉब अब भी डिफ़ॉल्ट फ़ॉलबैक इनहेरिट करते हैं, जब तक कि आप fallbacks: [] सेट न करें।
utilityModel: जनरेट किए गए सत्र और थ्रेड शीर्षकों जैसे छोटे आंतरिक कार्यों के लिए वैकल्पिक प्रति-एजेंट ओवरराइड। यह पहले agents.defaults.utilityModel, फिर प्रभावी सत्र प्रदाता के घोषित छोटे-मॉडल डिफ़ॉल्ट पर फ़ॉलबैक करता है। डैशबोर्ड शीर्षक प्रभावी नियमित सत्र मॉडल के साथ एक बार पुनः प्रयास करते हैं। खाली स्ट्रिंग इस एजेंट के लिए वैकल्पिक उपयोगिता रूट को छोड़ देती है, लेकिन डैशबोर्ड शीर्षक जनरेशन को अक्षम नहीं करती।
params: agents.defaults.models में चयनित मॉडल प्रविष्टि के ऊपर मर्ज किए गए प्रति-एजेंट स्ट्रीम पैरामीटर। पूरे मॉडल कैटलॉग की प्रतिलिपि बनाए बिना cacheRetention, temperature, या maxTokens जैसे एजेंट-विशिष्ट ओवरराइड के लिए इसका उपयोग करें।
tts: वैकल्पिक प्रति-एजेंट टेक्स्ट-टू-स्पीच ओवरराइड। यह ब्लॉक tts के ऊपर डीप-मर्ज होता है, इसलिए साझा प्रदाता क्रेडेंशियल और फ़ॉलबैक नीति को tts में रखें और यहाँ केवल प्रदाता, आवाज़, मॉडल, शैली, या ऑटो मोड जैसे व्यक्तित्व-विशिष्ट मान सेट करें।
skills: वैकल्पिक प्रति-एजेंट स्किल अनुमति-सूची। इसे छोड़ने पर, यदि agents.defaults.skills सेट है तो एजेंट उसे इनहेरिट करता है; स्पष्ट सूची मर्ज करने के बजाय डिफ़ॉल्ट को प्रतिस्थापित करती है, और [] का अर्थ है कोई स्किल नहीं।
thinkingDefault: वैकल्पिक प्रति-एजेंट डिफ़ॉल्ट चिंतन स्तर (off | minimal | low | medium | high | xhigh | adaptive | max)। जब कोई प्रति-संदेश या सत्र ओवरराइड सेट न हो, तो इस एजेंट के लिए agents.defaults.thinkingDefault को ओवरराइड करता है। चयनित प्रदाता/मॉडल प्रोफ़ाइल यह नियंत्रित करती है कि कौन-से मान मान्य हैं; Google Gemini के लिए, adaptive प्रदाता-स्वामित्व वाला डायनेमिक चिंतन बनाए रखता है (Gemini 3/3.1 पर thinkingLevel छोड़ा जाता है, Gemini 2.5 पर thinkingBudget: -1)।
reasoningDefault: वैकल्पिक प्रति-एजेंट डिफ़ॉल्ट रीजनिंग दृश्यता (on | off | stream)। जब कोई प्रति-संदेश या सत्र रीजनिंग ओवरराइड सेट न हो, तो इस एजेंट के लिए agents.defaults.reasoningDefault को ओवरराइड करता है।
fastModeDefault: फ़ास्ट मोड के लिए वैकल्पिक प्रति-एजेंट डिफ़ॉल्ट ("auto" | true | false)। यह तब लागू होता है जब कोई प्रति-संदेश या सत्र फ़ास्ट-मोड ओवरराइड सेट न हो।
models: पूर्ण provider/model आईडी द्वारा कुंजीबद्ध वैकल्पिक प्रति-एजेंट मॉडल कैटलॉग/रनटाइम ओवरराइड। प्रति-एजेंट रनटाइम अपवादों के लिए models["provider/model"].agentRuntime का उपयोग करें।
runtime: वैकल्पिक प्रति-एजेंट रनटाइम वर्णनकर्ता। जब एजेंट को डिफ़ॉल्ट रूप से ACP हार्नेस सत्रों का उपयोग करना चाहिए, तब runtime.acp डिफ़ॉल्ट (agent, backend, mode, cwd) के साथ type: "acp" का उपयोग करें।
identity.avatar: वर्कस्पेस-सापेक्ष पथ, http(s) URL, या data: URI।
स्थानीय वर्कस्पेस-सापेक्ष identity.avatar इमेज फ़ाइलें 2 MB तक सीमित हैं। http(s) URL और data: URI की स्थानीय फ़ाइल-आकार सीमा के विरुद्ध जाँच नहीं की जाती।
identity डिफ़ॉल्ट प्राप्त करता है: emoji से ackReaction, name/emoji से mentionPatterns।
subagents.allowAgents: स्पष्ट sessions_spawn.agentId लक्ष्यों के लिए कॉन्फ़िगर की गई एजेंट आईडी की अनुमति-सूची (["*"] = कोई भी कॉन्फ़िगर किया गया लक्ष्य; डिफ़ॉल्ट: केवल वही एजेंट)। स्व-लक्षित agentId कॉल की अनुमति देने के लिए अनुरोधकर्ता आईडी शामिल करें। जिन पुरानी प्रविष्टियों का एजेंट कॉन्फ़िगरेशन हटा दिया गया है, उन्हें sessions_spawn अस्वीकार करता है और agents_list से छोड़ दिया जाता है; उन्हें साफ़ करने के लिए openclaw doctor --fix चलाएँ, या यदि डिफ़ॉल्ट इनहेरिट करते हुए उस लक्ष्य को स्पॉन करने योग्य बनाए रखना है, तो न्यूनतम agents.entries.* प्रविष्टि जोड़ें।
सैंडबॉक्स इनहेरिटेंस गार्ड: यदि अनुरोधकर्ता सत्र सैंडबॉक्स में है, तो sessions_spawn उन लक्ष्यों को अस्वीकार करता है जो सैंडबॉक्स के बाहर चलेंगे।
subagents.requireAgentId: true होने पर, उन sessions_spawn कॉल को ब्लॉक करें जिनमें agentId नहीं है (स्पष्ट प्रोफ़ाइल चयन अनिवार्य करता है; डिफ़ॉल्ट: false)।
subagents.maxConcurrent: सबएजेंट निष्पादन में समवर्ती चाइल्ड-एजेंट रन की अधिकतम संख्या। डिफ़ॉल्ट: 8।
subagents.maxChildrenPerAgent: एक एजेंट सत्र द्वारा स्पॉन किए जा सकने वाले सक्रिय चाइल्ड की अधिकतम संख्या। डिफ़ॉल्ट: 5।
subagents.maxSpawnDepth: सब-एजेंट स्पॉनिंग के लिए अधिकतम नेस्टिंग गहराई (1-5)। डिफ़ॉल्ट: 1 (कोई नेस्टिंग नहीं)।
subagents.archiveAfterMinutes: पूर्ण हो चुके सबएजेंट की स्थिति को आर्काइव करने से पहले की अवधि। डिफ़ॉल्ट: 60।

मल्टी-एजेंट रूटिंग

एक Gateway के भीतर एकाधिक पृथक एजेंट चलाएँ। मल्टी-एजेंट देखें।

json5

{  agents: {    list: [      { id: "home", default: true, workspace: "~/.openclaw/workspace-home" },      { id: "work", workspace: "~/.openclaw/workspace-work" },    ],  },  bindings: [    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },  ],}

बाइंडिंग मिलान फ़ील्ड

type (वैकल्पिक): सामान्य रूटिंग के लिए route (type अनुपस्थित होने पर डिफ़ॉल्ट route), स्थायी ACP वार्तालाप बाइंडिंग के लिए acp।
match.channel (आवश्यक)
match.accountId (वैकल्पिक; * = कोई भी खाता; छोड़ा गया = डिफ़ॉल्ट खाता)
match.peer (वैकल्पिक; { kind: direct|group|channel, id })
match.guildId / match.teamId (वैकल्पिक; चैनल-विशिष्ट)
acp (वैकल्पिक; केवल type: "acp" के लिए): { mode, label, cwd, backend }

नियतात्मक मिलान क्रम:

match.peer
match.guildId
match.teamId
match.accountId (सटीक, कोई peer/guild/team नहीं)
match.accountId: "*" (पूरे चैनल में)
डिफ़ॉल्ट एजेंट

प्रत्येक स्तर के भीतर, पहली मेल खाने वाली bindings प्रविष्टि प्रभावी होती है।

type: "acp" प्रविष्टियों के लिए, OpenClaw सटीक वार्तालाप पहचान (match.channel + खाता + match.peer.id) के आधार पर समाधान करता है और ऊपर दिए गए रूट बाइंडिंग स्तर क्रम का उपयोग नहीं करता।

प्रति-एजेंट एक्सेस प्रोफ़ाइल

पूर्ण एक्सेस (कोई सैंडबॉक्स नहीं)

json5

{agents: {  list: [    {      id: "personal",      workspace: "~/.openclaw/workspace-personal",      sandbox: { mode: "off" },    },  ],},}

केवल-पढ़ने योग्य टूल + वर्कस्पेस

json5

{agents: {  list: [    {      id: "family",      workspace: "~/.openclaw/workspace-family",      sandbox: { mode: "all", scope: "agent", workspaceAccess: "ro" },      tools: {        allow: [          "read",          "sessions_list",          "sessions_history",          "sessions_send",          "sessions_spawn",          "session_status",        ],        deny: ["write", "edit", "apply_patch", "exec", "process", "browser"],      },    },  ],},}

फ़ाइल सिस्टम एक्सेस नहीं (केवल संदेश सेवा)

json5

{agents: {  list: [    {      id: "public",      workspace: "~/.openclaw/workspace-public",      sandbox: { mode: "all", scope: "agent", workspaceAccess: "none" },      tools: {        allow: [          "sessions_list",          "sessions_history",          "sessions_send",          "sessions_spawn",          "session_status",          "whatsapp",          "telegram",          "slack",          "discord",          "gateway",        ],        deny: [          "read",          "write",          "edit",          "apply_patch",          "exec",          "process",          "browser",          "canvas",          "nodes",          "cron",          "gateway",          "image",        ],      },    },  ],},}

प्राथमिकता विवरण के लिए मल्टी-एजेंट सैंडबॉक्स और टूल देखें।

सत्र

json5

{  session: {    scope: "per-sender",    dmScope: "main", // main | per-peer | per-channel-peer | per-account-channel-peer    identityLinks: {      alice: ["telegram:123456789", "discord:987654321012345678"],    },    reset: {      mode: "daily", // daily | idle      atHour: 4,      idleMinutes: 60,    },    resetByType: {      thread: { mode: "daily", atHour: 4 },      direct: { mode: "idle", idleMinutes: 240 },      group: { mode: "idle", idleMinutes: 120 },    },    resetByChannel: {      discord: { mode: "idle", idleMinutes: 30 },    },    resetTriggers: ["/new", "/reset"],    store: "~/.openclaw/agents/{agentId}/sessions/sessions.json",    maintenance: {      mode: "enforce", // enforce (default) | warn      pruneAfter: "30d",      maxEntries: 500,      resetArchiveRetention: "30d", // duration or false      maxDiskBytes: "500mb", // optional hard budget      highWaterBytes: "400mb", // optional cleanup target    },    threadBindings: {      enabled: true,      idleHours: 24, // default inactivity auto-unfocus in hours (`0` disables)      maxAgeHours: 0, // default hard max age in hours (`0` disables)    },    sharing: {      readOnly: true,      suggest: true,      drafts: true,    },    mainKey: "main", // legacy (runtime always uses "main")    sendPolicy: {      rules: [{ action: "deny", match: { channel: "discord", chatType: "group" } }],      default: "allow",    },  },}

सत्र फ़ील्ड का विवरण

scope: समूह-चैट संदर्भों के लिए आधार सत्र समूहीकरण रणनीति।
per-sender (डिफ़ॉल्ट): प्रत्येक प्रेषक को चैनल संदर्भ के भीतर एक पृथक सत्र मिलता है।
global: चैनल संदर्भ के सभी प्रतिभागी एक ही सत्र साझा करते हैं (केवल तभी उपयोग करें जब साझा संदर्भ अपेक्षित हो)।
dmScope: DMs को समूहीकृत करने का तरीका।
main: सभी DMs मुख्य सत्र साझा करते हैं।
per-peer: सभी चैनलों में प्रेषक id के अनुसार पृथक करें।
per-channel-peer: प्रत्येक चैनल + प्रेषक के अनुसार पृथक करें (बहु-उपयोगकर्ता इनबॉक्स के लिए अनुशंसित)।
per-account-channel-peer: प्रत्येक खाते + चैनल + प्रेषक के अनुसार पृथक करें (बहु-खाता उपयोग के लिए अनुशंसित)।
identityLinks: सभी चैनलों में सत्र साझा करने के लिए कैनोनिकल ids को प्रदाता-उपसर्ग वाले पीयर्स से मैप करें। /dock_discord जैसे डॉक कमांड सक्रिय सत्र के उत्तर मार्ग को किसी अन्य लिंक किए गए चैनल पीयर पर स्विच करने के लिए इसी मैप का उपयोग करते हैं; चैनल डॉकिंग देखें।
reset: प्राथमिक रीसेट नीति। none स्वचालित रीसेट को अक्षम करता है और डिफ़ॉल्ट है; इसके बजाय Compaction सक्रिय संदर्भ को सीमित करता है। daily, स्थानीय समय के atHour पर रीसेट करता है; idle, idleMinutes के बाद रीसेट करता है। दोनों कॉन्फ़िगर होने पर, जिसकी समय-सीमा पहले समाप्त होती है वही प्रभावी होता है। /new और /reset प्रत्येक मोड में उपलब्ध रहते हैं। दैनिक रीसेट की नवीनता सत्र पंक्ति के sessionStartedAt का उपयोग करती है; निष्क्रियता रीसेट की नवीनता lastInteractionAt का उपयोग करती है। Heartbeat, Cron वेकअप, exec सूचनाएँ और Gateway बहीखाता जैसे पृष्ठभूमि/सिस्टम-इवेंट लेखन updatedAt को अपडेट कर सकते हैं, लेकिन वे दैनिक/निष्क्रियता सत्रों को नवीन नहीं बनाए रखते।
resetByType: प्रत्येक प्रकार के ओवरराइड (direct, group, thread)। Doctor पुराने dm प्रविष्टियों को direct में माइग्रेट करता है; स्कीमा dm को अस्वीकार करता है।
resetByChannel: प्रदाता/चैनल id द्वारा कुंजीबद्ध प्रत्येक चैनल के रीसेट ओवरराइड। जब सत्र के चैनल की कोई मेल खाती प्रविष्टि होती है, तो उस सत्र के लिए वह resetByType/reset पर पूरी तरह प्रभावी होती है। इसका उपयोग केवल तभी करें जब किसी एक चैनल को प्रकार-स्तरीय नीति से भिन्न रीसेट व्यवहार चाहिए।
mainKey: पुराना फ़ील्ड। रनटाइम मुख्य प्रत्यक्ष-चैट बकेट के लिए हमेशा "main" का उपयोग करता है।
sendPolicy: channel, chatType (direct|group|channel, पुराने dm उपनाम सहित), keyPrefix, या rawKeyPrefix के अनुसार मिलान करें। पहला निषेध प्रभावी होता है।
maintenance: सत्र-स्टोर सफ़ाई + अवधारण नियंत्रण।
mode: enforce सफ़ाई लागू करता है और डिफ़ॉल्ट है; warn केवल चेतावनियाँ देता है।
pruneAfter: पुरानी प्रविष्टियों के लिए आयु सीमा (डिफ़ॉल्ट 30d)।
maxEntries: SQLite सत्र प्रविष्टियों की अधिकतम संख्या (डिफ़ॉल्ट 500)। रनटाइम लेखन उत्पादन-आकार की सीमाओं के लिए छोटे उच्च-जल-चिह्न बफ़र के साथ बैच सफ़ाई करता है; openclaw sessions cleanup --enforce सीमा को तुरंत लागू करता है।
अल्पकालिक Gateway मॉडल-रन जाँच सत्र निश्चित 24h अवधारण का उपयोग करते हैं, लेकिन सफ़ाई दबाव-नियंत्रित होती है: यह पुरानी सख्त मॉडल-रन जाँच पंक्तियाँ केवल तभी हटाती है जब सत्र-प्रविष्टि रखरखाव/सीमा का दबाव पहुँच जाता है। केवल agent:*:explicit:model-run-<uuid> से मेल खाने वाली सख्त स्पष्ट जाँच कुंजियाँ पात्र हैं; सामान्य प्रत्यक्ष, समूह, थ्रेड, Cron, हुक, Heartbeat, ACP और उप-एजेंट सत्रों पर यह 24h अवधारण लागू नहीं होता। मॉडल-रन सफ़ाई होने पर, वह व्यापक pruneAfter पुरानी-प्रविष्टि सफ़ाई और maxEntries सीमा से पहले होती है।
पुराने rotateBytes को वर्तमान स्कीमा अस्वीकार करता है; openclaw doctor --fix इसे पुराने कॉन्फ़िगरेशन से हटा देता है।
resetArchiveRetention: रीसेट किए गए/हटाए गए ट्रांसक्रिप्ट अभिलेखों के लिए आयु-आधारित अवधारण। डिफ़ॉल्ट रूप से, अभिलेख डिस्क-बजट निष्कासन तक बने रहते हैं; दीवार-घड़ी समय के अनुसार हटाने को चुनने के लिए अवधि सेट करें, या इसे स्पष्ट रूप से अक्षम करने के लिए false सेट करें।
maxDiskBytes: वैकल्पिक सत्र-डायरेक्टरी डिस्क बजट। warn मोड में यह चेतावनियाँ लॉग करता है; enforce मोड में यह सबसे पुरानी कलाकृतियाँ/सत्र पहले हटाता है।
highWaterBytes: बजट सफ़ाई के बाद वैकल्पिक लक्ष्य। डिफ़ॉल्ट रूप से maxDiskBytes का 80%।
threadBindings: थ्रेड-बद्ध सत्र सुविधाओं के लिए वैश्विक डिफ़ॉल्ट।
enabled: समर्थित चैनल थ्रेड बाइंडिंग के लिए मुख्य स्विच
idleHours: घंटों में डिफ़ॉल्ट निष्क्रियता स्वचालित अनफ़ोकस (0 अक्षम करता है; प्रदाता ओवरराइड कर सकते हैं)
maxAgeHours: घंटों में डिफ़ॉल्ट अधिकतम आयु की कठोर सीमा (0 अक्षम करता है; प्रदाता ओवरराइड कर सकते हैं)
spawnSessions: sessions_spawn और ACP थ्रेड स्पॉन से थ्रेड-बद्ध कार्य सत्र बनाने के लिए डिफ़ॉल्ट गेट। थ्रेड बाइंडिंग सक्षम होने पर डिफ़ॉल्ट true होता है; प्रदाता/खाते ओवरराइड कर सकते हैं।
defaultSpawnContext: थ्रेड-बद्ध स्पॉन के लिए डिफ़ॉल्ट मूल उप-एजेंट संदर्भ ("fork" या "isolated")। डिफ़ॉल्ट "fork" है।
sharing: नियंत्रित करता है कि स्वामी और operator.admin कनेक्शन प्रत्येक सत्र के किन सहयोग मोड को चुन सकते हैं। प्रत्येक फ़्लैग का डिफ़ॉल्ट true है; किसी फ़्लैग को false पर सेट करने से वह विकल्प Control UI से हट जाता है और निर्माण-समय दृश्यता या session.visibility.set उसे अस्वीकार कर देता है। नए सत्र shared के रूप में शुरू होते हैं, जब तक Control UI किसी सत्र को ड्राफ़्ट के रूप में शुरू न करे।
readOnly: read-only की अनुमति दें, जिसमें गैर-सदस्य देख सकते हैं, लेकिन सत्र की स्थिति को संदेश भेज, निर्देशित, निरस्त, अनुमोदित या परिवर्तित नहीं कर सकते।
suggest: suggest की अनुमति दें। इस चरण में यह read-only के समान प्रवेश व्यवहार लागू करता है; सुझाव कतार बाद की सुविधा है।
drafts: draft की अनुमति दें, जो सत्र को गैर-व्यवस्थापक, गैर-स्वामी सत्र सूचियों और इवेंट प्रसारणों से छिपाता है।

सदस्यता और दृश्यता में बदलाव सिस्टम नोट्स के रूप में सत्र ट्रांसक्रिप्ट में लिखे जाते हैं। ये नियंत्रण एक एजेंट साझा करने वाले ऑपरेटरों के बीच समन्वय करते हैं; ये टेनेंट्स के बीच सुरक्षा सीमा नहीं हैं। जब कार्य में पृथक्करण आवश्यक हो, तो अलग-अलग Gateways या एजेंटों का उपयोग करें।

संदेश

json5

{  messages: {    responsePrefix: "🦞", // या "auto"    ackReaction: "👀",    ackReactionScope: "group-mentions", // group-mentions | group-all | direct | all | off | none    queue: {      mode: "steer", // steer (डिफ़ॉल्ट) | followup | collect | interrupt      debounceMs: 500,      cap: 20,      drop: "summarize", // old | new | summarize (डिफ़ॉल्ट)      byChannel: {        whatsapp: "followup",        telegram: "followup",      },    },    inbound: {      debounceMs: 2000, // 0 अक्षम करता है      byChannel: {        whatsapp: 5000,        slack: 1500,      },    },  },}

उत्तर उपसर्ग

प्रत्येक चैनल/खाते के ओवरराइड: channels.<channel>.responsePrefix, channels.<channel>.accounts.<id>.responsePrefix।

समाधान क्रम (सबसे विशिष्ट प्रभावी होता है): खाता → चैनल → वैश्विक। "" अक्षम करता है और कैस्केड रोकता है। "auto", [{identity.name}] प्राप्त करता है।

टेम्पलेट चर:

चर	विवरण	उदाहरण
`{model}`	मॉडल का संक्षिप्त नाम	`claude-opus-4-6`
`{modelFull}`	मॉडल का पूर्ण पहचानकर्ता	`anthropic/claude-opus-4-6`
`{provider}`	प्रदाता का नाम	`anthropic`
`{thinkingLevel}`	वर्तमान चिंतन स्तर	`high`, `low`, `off`
`{identity.name}`	एजेंट पहचान का नाम	(`"auto"` के समान)

चरों में अक्षरों के बड़े-छोटे रूप का भेद नहीं होता। {think}, {thinkingLevel} का उपनाम है।

अभिस्वीकृति प्रतिक्रिया

डिफ़ॉल्ट रूप से सक्रिय एजेंट का identity.emoji, अन्यथा "👀"। अक्षम करने के लिए "" सेट करें।
प्रत्येक चैनल के ओवरराइड: channels.<channel>.ackReaction, channels.<channel>.accounts.<id>.ackReaction।
समाधान क्रम: खाता → चैनल → messages.ackReaction → पहचान फ़ॉलबैक।
दायरा: group-mentions (डिफ़ॉल्ट), group-all, direct, all, या off/none (अभिस्वीकृति प्रतिक्रियाओं को पूरी तरह अक्षम करता है)।
messages.statusReactions.enabled: Slack, Discord, Signal, Telegram और WhatsApp पर जीवनचक्र स्थिति प्रतिक्रियाएँ सक्षम करता है। Discord पर, इसे सेट न करने से अभिस्वीकृति प्रतिक्रियाएँ सक्रिय होने पर स्थिति प्रतिक्रियाएँ सक्षम रहती हैं। Slack, Signal, Telegram और WhatsApp पर जीवनचक्र स्थिति प्रतिक्रियाएँ सक्षम करने के लिए इसे स्पष्ट रूप से true पर सेट करें। Slack डिफ़ॉल्ट रूप से प्रगति के लिए अपनी मूल सहायक थ्रेड स्थिति और बारी-बारी से बदलते लोडिंग संदेशों का उपयोग करता है, जबकि कॉन्फ़िगर की गई अभिस्वीकृति प्रतिक्रिया स्थिर रहती है।

कतार

mode: सत्र रन सक्रिय होने के दौरान आने वाले इनबाउंड संदेशों के लिए कतार रणनीति। डिफ़ॉल्ट: "steer"।
- steer: सक्रिय रन में नया प्रॉम्प्ट इंजेक्ट करें।
- followup: सक्रिय रन समाप्त होने के बाद नया प्रॉम्प्ट चलाएँ।
- collect: संगत संदेशों को बैच करें और बाद में उन्हें साथ चलाएँ।
- interrupt: नवीनतम प्रॉम्प्ट शुरू करने से पहले सक्रिय रन निरस्त करें।
debounceMs: कतारबद्ध/निर्देशित संदेश भेजने से पहले विलंब। डिफ़ॉल्ट: 500।
cap: ड्रॉप नीति लागू होने से पहले कतारबद्ध संदेशों की अधिकतम संख्या। डिफ़ॉल्ट: 20।
drop: सीमा पार होने पर रणनीति। "summarize" (डिफ़ॉल्ट) सबसे पुरानी प्रविष्टियाँ हटाता है, लेकिन संक्षिप्त सारांश रखता है; "old" सबसे पुरानी प्रविष्टियाँ बिना सारांश के हटाता है; "new" नवीनतम आइटम को अस्वीकार करता है।
byChannel: प्रदाता id द्वारा कुंजीबद्ध प्रत्येक चैनल के mode ओवरराइड।
debounceMsByChannel: प्रदाता id द्वारा कुंजीबद्ध प्रत्येक चैनल के debounceMs ओवरराइड।

इनबाउंड डीबाउंस

एक ही प्रेषक से तेज़ी से आने वाले केवल-पाठ संदेशों को एक एजेंट टर्न में बैच करता है। मीडिया/अटैचमेंट तुरंत फ़्लश होते हैं। नियंत्रण कमांड डीबाउंसिंग को बायपास करते हैं। डिफ़ॉल्ट debounceMs: 2000।

अन्य संदेश कुंजियाँ

channels.whatsapp.responsePrefix: आउटबाउंड WhatsApp उत्तर उपसर्ग। Doctor अप्रचलित इनबाउंड messagePrefix मान को यहाँ केवल तभी ले जाता है जब यह कैनोनिकल मान सेट न हो।
messages.visibleReplies: प्रत्यक्ष, समूह और चैनल वार्तालापों में दृश्यमान स्रोत उत्तरों को नियंत्रित करता है ("message_tool" को दृश्यमान आउटपुट के लिए message(action=send) आवश्यक है; "automatic" पहले की तरह सामान्य उत्तर पोस्ट करता है)।
messages.usageTemplate / messages.responseUsage: कस्टम /usage फ़ुटर टेम्पलेट और प्रत्येक उत्तर के लिए डिफ़ॉल्ट उपयोग मोड (off | tokens | full, साथ ही tokens के लिए पुराना on उपनाम)।
messages.groupChat.mentionPatterns / historyLimit: समूह-संदेश उल्लेख ट्रिगर और इतिहास विंडो का आकार निर्धारण।
messages.suppressToolErrors: true होने पर, उपयोगकर्ता को दिखाई जाने वाली ⚠️ टूल-त्रुटि चेतावनियों को दबाता है (एजेंट को संदर्भ में त्रुटियाँ फिर भी दिखाई देती हैं और वह पुनः प्रयास कर सकता है)। डिफ़ॉल्ट: false।

TTS (टेक्स्ट-टू-स्पीच)

json5

{  tts: {    auto: "off", // off (डिफ़ॉल्ट) | always | inbound | tagged    mode: "final", // final | all    provider: "elevenlabs",    summaryModel: "openai/gpt-5.4-mini",    modelOverrides: { enabled: true },    maxTextLength: 4000,    timeoutMs: 30000,    providers: {      elevenlabs: {        apiKey: "example-elevenlabs-api-key",        baseUrl: "https://api.elevenlabs.io",        speakerVoiceId: "voice_id",        modelId: "eleven_multilingual_v2",        seed: 42,        applyTextNormalization: "auto",        languageCode: "en",        voiceSettings: {          stability: 0.5,          similarityBoost: 0.75,          style: 0.0,          useSpeakerBoost: true,          speed: 1.0,        },      },      microsoft: {        speakerVoice: "en-US-MichelleNeural",        lang: "en-US",        outputFormat: "audio-24khz-48kbitrate-mono-mp3",      },      openai: {        apiKey: "example-openai-api-key",        baseUrl: "https://api.openai.com/v1",        model: "gpt-4o-mini-tts",        speakerVoice: "coral",      },    },  },}

वैश्विक प्राथमिकताओं का पथ मशीन स्थिति है (डिफ़ॉल्ट ~/.openclaw/settings/tts.json; इसे OPENCLAW_TTS_PREFS से ओवरराइड करें)। उन्नत बहु-एजेंट सेटअप प्रत्येक एजेंट के लिए अलग प्राथमिकता स्टोर हेतु agents.entries.<id>.tts.prefsPath सेट कर सकते हैं।

auto डिफ़ॉल्ट स्वचालित TTS मोड नियंत्रित करता है: off, always, inbound, या tagged। /tts on|off स्थानीय प्राथमिकताओं को ओवरराइड कर सकता है, और /tts status प्रभावी स्थिति दिखाता है।
summaryModel स्वचालित सारांश के लिए agents.defaults.model.primary को ओवरराइड करता है।
modelOverrides डिफ़ॉल्ट रूप से सक्षम है (enabled !== false); modelOverrides.allowProvider वैकल्पिक रूप से सक्षम किया जाता है।
API कुंजियाँ वापस ELEVENLABS_API_KEY/XI_API_KEY और OPENAI_API_KEY का उपयोग करती हैं।
बंडल किए गए वाक् प्रदाता Plugin के स्वामित्व में हैं। यदि plugins.allow सेट है, तो उपयोग किए जाने वाले प्रत्येक TTS प्रदाता Plugin को शामिल करें, उदाहरण के लिए Edge TTS हेतु microsoft। पुराने edge प्रदाता आईडी को microsoft के उपनाम के रूप में स्वीकार किया जाता है।
providers.openai.baseUrl OpenAI TTS एंडपॉइंट को ओवरराइड करता है। समाधान क्रम है: कॉन्फ़िगरेशन, फिर OPENAI_TTS_BASE_URL, फिर https://api.openai.com/v1।
जब providers.openai.baseUrl किसी गैर-OpenAI एंडपॉइंट की ओर संकेत करता है, तो OpenClaw उसे OpenAI-संगत TTS सर्वर मानता है और मॉडल/वॉइस सत्यापन को शिथिल कर देता है।

वार्तालाप

वार्तालाप मोड के डिफ़ॉल्ट (macOS/iOS/Android और ब्राउज़र Control UI)।

json5

{  talk: {    provider: "elevenlabs",    providers: {      elevenlabs: {        speakerVoiceId: "elevenlabs_voice_id",        voiceAliases: {          Clawd: "EXAVITQu4vr4xnSDxMaL",          Roger: "CwhRBWXzGAHq8TQ4Fs17",        },        modelId: "eleven_multilingual_v2",        outputFormat: "mp3_44100_128",        apiKey: "elevenlabs_api_key",      },      mlx: {        modelId: "mlx-community/Soprano-80M-bf16",      },      system: {},    },    consultThinkingLevel: "low",    consultFastMode: true,    speechLocale: "ru-RU",    silenceTimeoutMs: 1500,    interruptOnSpeech: true,    realtime: {      provider: "openai",      providers: {        openai: {          model: "gpt-realtime-2.1",          speakerVoice: "cedar",        },      },      instructions: "सौहार्दपूर्ण ढंग से बोलें और उत्तर संक्षिप्त रखें।",      mode: "realtime", // realtime | stt-tts | transcription      transport: "webrtc", // webrtc | provider-websocket | gateway-relay | managed-room      vadThreshold: 0.5,      silenceDurationMs: 500,      prefixPaddingMs: 300,      reasoningEffort: "medium",      brain: "agent-consult", // agent-consult | direct-tools | none    },  },}

जब एकाधिक वार्तालाप प्रदाता कॉन्फ़िगर किए गए हों, तब talk.provider का talk.providers की किसी कुंजी से मेल खाना आवश्यक है।
पुरानी समतल वार्तालाप कुंजियाँ (talk.voiceId, talk.voiceAliases, talk.modelId, talk.outputFormat, talk.apiKey) केवल संगतता के लिए हैं। स्थायी कॉन्फ़िगरेशन को talk.providers.<provider> में पुनर्लिखने के लिए openclaw doctor --fix चलाएँ।
वॉइस आईडी वापस ELEVENLABS_VOICE_ID या SAG_VOICE_ID का उपयोग करते हैं (macOS वार्तालाप क्लाइंट का व्यवहार)।
providers.*.apiKey सादे टेक्स्ट स्ट्रिंग या SecretRef ऑब्जेक्ट स्वीकार करता है।
ELEVENLABS_API_KEY फ़ॉलबैक केवल तब लागू होता है, जब कोई वार्तालाप API कुंजी कॉन्फ़िगर नहीं की गई हो।
providers.*.voiceAliases वार्तालाप निर्देशों को सरल नामों का उपयोग करने देता है।
providers.mlx.modelId macOS के स्थानीय MLX सहायक द्वारा उपयोग किया जाने वाला Hugging Face रिपॉज़िटरी चुनता है। इसे छोड़ने पर macOS mlx-community/Soprano-80M-bf16 का उपयोग करता है।
macOS MLX प्लेबैक उपलब्ध होने पर बंडल किए गए openclaw-mlx-tts सहायक के माध्यम से, अन्यथा PATH पर उपलब्ध निष्पादन योग्य फ़ाइल के माध्यम से चलता है; विकास के लिए OPENCLAW_MLX_TTS_BIN सहायक पथ को ओवरराइड करता है।
consultThinkingLevel Control UI वार्तालाप की रियलटाइम openclaw_agent_consult कॉल के पीछे चलने वाले पूर्ण OpenClaw एजेंट रन का चिंतन स्तर नियंत्रित करता है। सामान्य सत्र/मॉडल व्यवहार बनाए रखने के लिए इसे सेट न करें।
consultFastMode सत्र की सामान्य फ़ास्ट-मोड सेटिंग बदले बिना Control UI वार्तालाप के रियलटाइम परामर्शों के लिए एकबारगी फ़ास्ट-मोड ओवरराइड सेट करता है।
speechLocale Android, iOS और macOS वार्तालाप वाक् पहचान द्वारा उपयोग किया जाने वाला BCP 47 लोकेल आईडी सेट करता है। Android रियलटाइम इनपुट ट्रांसक्रिप्शन का मार्गदर्शन करने के लिए इसके भाषा घटक का भी उपयोग करता है। डिवाइस का डिफ़ॉल्ट उपयोग करने के लिए इसे सेट न करें।
silenceTimeoutMs नियंत्रित करता है कि उपयोगकर्ता की चुप्पी के बाद वार्तालाप मोड ट्रांसक्रिप्ट भेजने से पहले कितनी देर प्रतीक्षा करता है। इसे सेट न करने पर प्लेटफ़ॉर्म की डिफ़ॉल्ट विराम अवधि (700 ms on macOS and Android, 900 ms on iOS) बनी रहती है।
realtime.instructions प्रदाता के लिए सिस्टम निर्देशों को OpenClaw के अंतर्निहित रियलटाइम प्रॉम्प्ट में जोड़ता है, ताकि डिफ़ॉल्ट openclaw_agent_consult मार्गदर्शन खोए बिना वॉइस शैली कॉन्फ़िगर की जा सके।
realtime.vadThreshold प्रदाता की वॉइस-गतिविधि सीमा को 0 (सर्वाधिक संवेदनशील) से 1 (न्यूनतम संवेदनशील) तक सेट करता है। इसे सेट न करने पर प्रदाता का डिफ़ॉल्ट बना रहता है।
realtime.silenceDurationMs प्रदाता द्वारा रियलटाइम उपयोगकर्ता टर्न कमिट करने से पहले की धनात्मक पूर्णांक मौन अवधि सेट करता है। इसे सेट न करने पर प्रदाता का डिफ़ॉल्ट बना रहता है।
realtime.prefixPaddingMs पहचानी गई वाणी शुरू होने से पहले रखे जाने वाले ऑडियो की गैर-ऋणात्मक पूर्णांक मात्रा सेट करता है। इसे सेट न करने पर प्रदाता का डिफ़ॉल्ट बना रहता है।
realtime.reasoningEffort रियलटाइम सत्रों के लिए प्रदाता-विशिष्ट तर्क स्तर सेट करता है। इसे सेट न करने पर प्रदाता का डिफ़ॉल्ट बना रहता है।
realtime.consultRouting: जब रियलटाइम प्रदाता openclaw_agent_consult के बिना अंतिम उपयोगकर्ता ट्रांसक्रिप्ट बनाता है, तब "provider-direct" (डिफ़ॉल्ट) प्रदाता के प्रत्यक्ष उत्तरों को बनाए रखता है। इसके बजाय "force-agent-consult" अंतिम रूप दिए गए अनुरोध को OpenClaw के माध्यम से भेजता है।

एजेंट डिफ़ॉल्ट

agents.defaults.workspace

agents.defaults.repoRoot

agents.defaults.skills

agents.defaults.skipBootstrap

agents.defaults.skipOptionalBootstrapFiles

agents.defaults.contextInjection

agents.defaults.bootstrapMaxChars

agents.defaults.bootstrapTotalMaxChars

प्रति-एजेंट बूटस्ट्रैप प्रोफ़ाइल ओवरराइड

agents.defaults.bootstrapPromptTruncationWarning

संदर्भ बजट स्वामित्व मानचित्र

agents.defaults.startupContext

agents.defaults.contextLimits

agents.entries.*.contextLimits

skills.limits.maxSkillsPromptChars

agents.entries.*.skillsLimits.maxSkillsPromptChars

agents.defaults.imageMaxDimensionPx

agents.defaults.imageQuality

agents.defaults.userTimezone

agents.defaults.timeFormat

agents.defaults.model

रनटाइम नीति

CLI बैकएंड चयन

agents.defaults.promptOverlays

agents.defaults.heartbeat

agents.defaults.compaction

agents.defaults.contextPruning

ब्लॉक स्ट्रीमिंग

टाइपिंग संकेतक

agents.defaults.sandbox

agents.entries (प्रति-एजेंट ओवरराइड)

मल्टी-एजेंट रूटिंग

बाइंडिंग मिलान फ़ील्ड

प्रति-एजेंट एक्सेस प्रोफ़ाइल

सत्र

संदेश

उत्तर उपसर्ग

अभिस्वीकृति प्रतिक्रिया

कतार

इनबाउंड डीबाउंस

अन्य संदेश कुंजियाँ

TTS (टेक्स्ट-टू-स्पीच)

वार्तालाप

संबंधित

On this page

`agents.defaults.workspace`

`agents.defaults.repoRoot`

`agents.defaults.skills`

`agents.defaults.skipBootstrap`

`agents.defaults.skipOptionalBootstrapFiles`

`agents.defaults.contextInjection`

`agents.defaults.bootstrapMaxChars`

`agents.defaults.bootstrapTotalMaxChars`

`agents.defaults.bootstrapPromptTruncationWarning`

`agents.defaults.startupContext`

`agents.defaults.contextLimits`

`agents.entries.*.contextLimits`

`skills.limits.maxSkillsPromptChars`

`agents.entries.*.skillsLimits.maxSkillsPromptChars`

`agents.defaults.imageMaxDimensionPx`

`agents.defaults.imageQuality`

`agents.defaults.userTimezone`

`agents.defaults.timeFormat`

`agents.defaults.model`

`agents.defaults.promptOverlays`

`agents.defaults.heartbeat`

`agents.defaults.compaction`

`agents.defaults.contextPruning`

`agents.defaults.sandbox`

`agents.entries` (प्रति-एजेंट ओवरराइड)