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

​

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

​

agents.defaults.workspace

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

​

agents.defaults.repoRoot

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

​

agents.defaults.skills

{
  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: { defaults: { skipBootstrap: true } },
}

​

agents.defaults.skipOptionalBootstrapFiles

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

​

agents.defaults.contextInjection

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

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

​

agents.defaults.bootstrapMaxChars

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

​

agents.defaults.bootstrapTotalMaxChars

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

​

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

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

​

agents.defaults.bootstrapPromptTruncationWarning

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

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

​

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

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

​

agents.defaults.startupContext

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

​

agents.defaults.contextLimits

{
  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

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

​

skills.limits.maxSkillsPromptChars

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

​

agents.entries.*.skillsLimits.maxSkillsPromptChars

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

​

agents.defaults.imageMaxDimensionPx

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

​

agents.defaults.imageQuality

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

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

​

agents.defaults.userTimezone

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

​

agents.defaults.timeFormat

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

​

agents.defaults.model

{
  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।

​

रनटाइम नीति

{
  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 अब भी अपनी प्रदाता/मॉडल सेटिंग का उपयोग करते हैं।

​

CLI बैकएंड चयन

​

agents.defaults.promptOverlays

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

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

​

agents.defaults.heartbeat

{
  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

{
  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 फ्लश को बाध्य करता है, भले ही टोकन काउंटर पुराने हों। कार्यस्थान केवल-पठन होने पर इसे छोड़ दिया जाता है।

​

agents.defaults.contextPruning

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

​

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

{
  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।

​

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

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

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

​

agents.defaults.sandbox

{
  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"],
      },
    },
  },
}

{
  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,
        },
      },
    },
  },
}

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

​

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

{
  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।

​

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

{
  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 }

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

​

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

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

{
  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"],
        },
      },
    ],
  },
}

{
  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",
          ],
        },
      },
    ],
  },
}

​

सत्र

{
  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",
    },
  },
}

​

संदेश

{
  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,
      },
    },
  },
}

​

उत्तर उपसर्ग

​

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

• डिफ़ॉल्ट रूप से सक्रिय एजेंट का 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 ओवरराइड।

​

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

​

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

• 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 (टेक्स्ट-टू-स्पीच)

{
  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",
      },
    },
  },
}

• 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 सर्वर मानता है और मॉडल/वॉइस सत्यापन को शिथिल कर देता है।

​

वार्तालाप

{
  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 के माध्यम से भेजता है।

​

संबंधित

• कॉन्फ़िगरेशन संदर्भ — अन्य सभी कॉन्फ़िगरेशन कुंजियाँ
• कॉन्फ़िगरेशन — सामान्य कार्य और त्वरित सेटअप
• कॉन्फ़िगरेशन उदाहरण