कॉन्फ़िगरेशन — चैनल

channels.* के अंतर्गत प्रति-चैनल कॉन्फ़िगरेशन कुंजियाँ: DM और समूह पहुँच, बहु-अकाउंट सेटअप, उल्लेख गेटिंग, और Slack, Discord, Telegram, WhatsApp, Matrix, iMessage तथा अन्य चैनल plugins के लिए प्रति-चैनल कुंजियाँ।

एजेंट, टूल, Gateway रनटाइम और अन्य शीर्ष-स्तरीय कुंजियों के लिए, कॉन्फ़िगरेशन संदर्भ देखें।

चैनल

प्रत्येक चैनल का कॉन्फ़िगरेशन अनुभाग मौजूद होने पर वह स्वचालित रूप से शुरू होता है (जब तक कि enabled: false न हो)। Telegram और iMessage कोर openclaw पैकेज के भीतर उपलब्ध होते हैं। अन्य आधिकारिक चैनल (Discord, Slack, WhatsApp, Matrix, Microsoft Teams, IRC, Google Chat, Signal, Mattermost और अन्य) openclaw plugins install <spec> के साथ अलग plugins के रूप में इंस्टॉल होते हैं; पूरी सूची और इंस्टॉलेशन विनिर्देशों के लिए चैनल देखें।

DM और समूह पहुँच

सभी चैनल DM नीतियों और समूह नीतियों का समर्थन करते हैं:

चैनल मॉडल ओवरराइड

विशिष्ट चैनल आईडी या डायरेक्ट-मैसेज पीयर को किसी मॉडल से पिन करने के लिए channels.modelByChannel का उपयोग करें। मान provider/model या कॉन्फ़िगर किए गए मॉडल उपनाम स्वीकार करते हैं। चैनल मैपिंग केवल तभी लागू होती है जब किसी सत्र में पहले से सक्रिय मॉडल ओवरराइड न हो (उदाहरण के लिए, /model के माध्यम से सेट किया गया ओवरराइड)।

समूह/थ्रेड वार्तालापों के लिए, कुंजियाँ चैनल-विशिष्ट समूह आईडी, विषय आईडी या चैनल नाम होती हैं। डायरेक्ट-मैसेज (DM) वार्तालापों के लिए, कुंजियाँ चैनल की प्रेषक पहचान (nativeDirectUserId, origin.from, origin.to, OriginatingTo, From या SenderId) से प्राप्त पीयर पहचानकर्ता होती हैं। कुंजी का सटीक रूप चैनल पर निर्भर करता है:

{  channels: {    modelByChannel: {      discord: {        "123456789012345678": "anthropic/claude-opus-4-6",      },      slack: {        C1234567890: "openai/gpt-5.6-sol",        "user:U12345": "openai/gpt-5.4-mini",      },      telegram: {        "-1001234567890": "openai/gpt-5.4-mini",        "-1001234567890:topic:99": "anthropic/claude-sonnet-4-6",        "123456789": "openai/gpt-4.1",      },    },  },}

DM-विशिष्ट कुंजियाँ केवल डायरेक्ट-मैसेज वार्तालापों में मेल खाती हैं; वे समूह/थ्रेड रूटिंग को प्रभावित नहीं करतीं।

चैनल डिफ़ॉल्ट और Heartbeat

सभी प्रदाताओं में साझा समूह-नीति, अंतर्निहित-उल्लेख और Heartbeat व्यवहार के लिए channels.defaults का उपयोग करें:

{  channels: {    defaults: {      groupPolicy: "allowlist", // open | allowlist | disabled      contextVisibility: "all", // all | allowlist | allowlist_quote      implicitMentions: {        replyToBot: true,        quotedBot: true,        threadParticipation: true,      },      heartbeat: {        showOk: false,        showAlerts: true,        useIndicator: true,      },    },  },}

• channels.defaults.groupPolicy: जब प्रदाता-स्तरीय groupPolicy सेट न हो, तब फ़ॉलबैक समूह नीति।
• channels.defaults.contextVisibility: सभी चैनलों के लिए डिफ़ॉल्ट पूरक संदर्भ दृश्यता मोड। मान: all (डिफ़ॉल्ट, सभी उद्धृत/थ्रेड/इतिहास संदर्भ शामिल करें), allowlist (केवल अनुमति-सूचीबद्ध प्रेषकों का संदर्भ शामिल करें), allowlist_quote (अनुमति-सूची के समान, लेकिन स्पष्ट उद्धरण/उत्तर संदर्भ बनाए रखें)। प्रति-चैनल ओवरराइड: channels.<channel>.contextVisibility।
• channels.defaults.implicitMentions: नियंत्रित करता है कि कौन-से समर्थित इनबाउंड तथ्य उल्लेख माने जाते हैं। replyToBot, quotedBot और threadParticipation प्रत्येक का डिफ़ॉल्ट true है, जिससे वर्तमान व्यवहार सुरक्षित रहता है। प्रति चैनल channels.<channel>.implicitMentions या प्रति अकाउंट channels.<channel>.accounts.<id>.implicitMentions के साथ ओवरराइड करें; प्रत्येक फ़्लैग स्वतंत्र रूप से अकाउंट -> चैनल -> डिफ़ॉल्ट क्रम में हल होता है। नाम सकारात्मक हैं: उस तथ्य को उल्लेख गेटिंग बायपास करने से रोकने के लिए फ़्लैग को false पर सेट करें। मूल स्पष्ट उल्लेखों की हमेशा अनुमति होती है, और जब चैनल वह तथ्य उत्पन्न नहीं करता तो फ़्लैग का कोई प्रभाव नहीं होता। वर्तमान उत्पादक मैट्रिक्स के लिए उल्लेख गेटिंग देखें। ये सेटिंग्स आउटबाउंड उत्तर/थ्रेड मोड या अधिकृत कमांड प्रबंधन को नहीं बदलतीं।
• channels.defaults.heartbeat.showOk: Heartbeat आउटपुट में स्वस्थ चैनल स्थितियाँ शामिल करें (डिफ़ॉल्ट false)।
• channels.defaults.heartbeat.showAlerts: Heartbeat आउटपुट में अवनत/त्रुटि स्थितियाँ शामिल करें (डिफ़ॉल्ट true)।
• channels.defaults.heartbeat.useIndicator: संक्षिप्त संकेतक-शैली Heartbeat आउटपुट रेंडर करें (डिफ़ॉल्ट true)।

WhatsApp

WhatsApp, Gateway के वेब चैनल (Baileys Web) के माध्यम से चलता है। लिंक किया हुआ सत्र मौजूद होने पर यह स्वचालित रूप से शुरू हो जाता है।

{  web: {    enabled: true,  },  channels: {    whatsapp: {      dmPolicy: "pairing", // pairing | allowlist | open | disabled      allowFrom: ["+15555550123", "+447700900123"],      textChunkLimit: 4000,      streaming: { chunkMode: "length" }, // length | newline      mediaMaxMb: 50,      sendReadReceipts: true, // blue ticks (false in self-chat mode)      groups: {        "*": { requireMention: true },      },      groupPolicy: "allowlist",      groupAllowFrom: ["+15551234567"],    },  },}

• type: "acp" वाली शीर्ष-स्तरीय bindings[] प्रविष्टियाँ WhatsApp DM और समूहों के लिए स्थायी ACP बाइंडिंग कॉन्फ़िगर करती हैं। match.peer.id में E.164 डायरेक्ट नंबर या WhatsApp समूह JID का उपयोग करें। फ़ील्ड का अर्थ ACP एजेंट में साझा किया गया है।

{channels: {  whatsapp: {    accounts: {      default: {},      personal: {},      biz: {        // authDir: "~/.openclaw/credentials/whatsapp/biz",      },    },  },},}

Telegram

{  channels: {    telegram: {      enabled: true,      botToken: "your-bot-token",      dmPolicy: "pairing",      allowFrom: ["tg:123456789"],      groups: {        "*": { requireMention: true },        "-1001234567890": {          allowFrom: ["@admin"],          systemPrompt: "Keep answers brief.",          topics: {            "99": {              requireMention: false,              skills: ["search"],              systemPrompt: "Stay on topic.",            },          },        },      },      customCommands: [        { command: "backup", description: "Git backup" },        { command: "generate", description: "Create an image" },      ],      historyLimit: 50,      replyToMode: "first", // off | first | all | batched      linkPreview: true,      streaming: { mode: "partial" }, // off | partial | block | progress (default: partial)      actions: { reactions: true, sendMessage: true },      reactionNotifications: "own", // off | own | all      mediaMaxMb: 100,      retry: {        attempts: 3,        minDelayMs: 400,        maxDelayMs: 30000,        jitter: 0.1,      },      network: {        autoSelectFamily: true,        dnsResultOrder: "ipv4first",      },      apiRoot: "https://api.telegram.org",      trustedLocalFileRoots: ["/srv/telegram-bot-api-data"],      proxy: "socks5://localhost:9050",      webhookUrl: "https://example.com/telegram-webhook",      webhookSecret: "secret",      webhookPath: "/telegram-webhook",    },  },}

• बॉट टोकन: channels.telegram.botToken या channels.telegram.tokenFile (केवल नियमित फ़ाइल; सिमलिंक अस्वीकार किए जाते हैं), डिफ़ॉल्ट अकाउंट के लिए फ़ॉलबैक के रूप में TELEGRAM_BOT_TOKEN।
• apiRoot केवल Telegram Bot API रूट है। https://api.telegram.org/bot<TOKEN> के बजाय https://api.telegram.org या अपने स्व-होस्टेड/प्रॉक्सी रूट का उपयोग करें; openclaw doctor --fix अनजाने में लगे अंतिम /bot<TOKEN> प्रत्यय को हटा देता है।
• --local मोड में स्व-होस्टेड Bot API सर्वर के लिए, trustedLocalFileRoots उन होस्ट पथों को सूचीबद्ध करता है जिन्हें OpenClaw पढ़ सकता है। सर्वर डेटा वॉल्यूम को OpenClaw होस्ट पर माउंट करें और या तो उसका डेटा रूट या प्रति-टोकन डायरेक्टरी कॉन्फ़िगर करें; /var/lib/telegram-bot-api के अंतर्गत कंटेनर पथ इन रूट में मैप किए जाते हैं। अन्य निरपेक्ष पथ अस्वीकार किए जाते हैं।
• वैकल्पिक channels.telegram.defaultAccount, कॉन्फ़िगर किए गए अकाउंट आईडी से मेल खाने पर डिफ़ॉल्ट अकाउंट चयन को ओवरराइड करता है।
• बहु-अकाउंट सेटअप (2+ अकाउंट आईडी) में, फ़ॉलबैक रूटिंग से बचने के लिए स्पष्ट डिफ़ॉल्ट (channels.telegram.defaultAccount या channels.telegram.accounts.default) सेट करें; इसके अनुपस्थित या अमान्य होने पर openclaw doctor चेतावनी देता है।
• configWrites: false, Telegram द्वारा आरंभ किए गए कॉन्फ़िगरेशन लेखन (सुपरग्रुप आईडी माइग्रेशन, /config set|unset) को ब्लॉक करता है।
• type: "acp" वाली शीर्ष-स्तरीय bindings[] प्रविष्टियाँ फ़ोरम विषयों के लिए स्थायी ACP बाइंडिंग कॉन्फ़िगर करती हैं (match.peer.id में कैनोनिकल chatId:topic:topicId का उपयोग करें)। फ़ील्ड का अर्थ ACP एजेंट में साझा किया गया है।
• Telegram स्ट्रीम पूर्वावलोकन sendMessage + editMessageText का उपयोग करते हैं (डायरेक्ट और समूह चैट दोनों में काम करता है)।
• सामान्य IPv6 फ़ेच विफलताओं से बचने के लिए network.dnsResultOrder का डिफ़ॉल्ट "ipv4first" है।
• पुनः प्रयास नीति: पुनः प्रयास नीति देखें।

Discord

{  channels: {    discord: {      enabled: true,      token: "your-bot-token",      mediaMaxMb: 100,      allowBots: false,      actions: {        reactions: true,        stickers: true,        polls: true,        permissions: true,        messages: true,        threads: true,        pins: true,        search: true,        memberInfo: true,        roleInfo: true,        roles: false,        channelInfo: true,        voiceStatus: true,        events: true,        moderation: false,      },      replyToMode: "off", // off | first | all | batched      dmPolicy: "pairing",      allowFrom: ["1234567890", "123456789012345678"],      dm: { enabled: true, groupEnabled: false, groupChannels: ["openclaw-dm"] },      guilds: {        "123456789012345678": {          slug: "friends-of-openclaw",          requireMention: false,          ignoreOtherMentions: true,          reactionNotifications: "own",          users: ["987654321098765432"],          channels: {            general: { allow: true },            help: {              allow: true,              requireMention: true,              users: ["987654321098765432"],              skills: ["docs"],              systemPrompt: "Short answers only.",            },          },        },      },      historyLimit: 20,      textChunkLimit: 2000,      suppressEmbeds: true,      streaming: {        mode: "progress", // off | partial | block | progress (Discord default: progress)        chunkMode: "length", // length | newline        progress: {          label: "auto",          maxLines: 8,          maxLineChars: 120,          toolProgress: true,        },      },      maxLinesPerMessage: 17,      ui: {        components: {          accentColor: "#5865F2",        },      },      threadBindings: {        enabled: true,        idleHours: 24,        maxAgeHours: 0,        spawnSessions: true,        defaultSpawnContext: "fork",      },      voice: {        enabled: true,        autoJoin: [          {            guildId: "123456789012345678",            channelId: "234567890123456789",          },        ],        daveEncryption: true,        decryptionFailureTolerance: 24,        connectTimeoutMs: 30000,        reconnectGraceMs: 15000,        tts: {          provider: "openai",          openai: { voice: "alloy" },        },      },      execApprovals: {        enabled: "auto", // true | false | "auto"        approvers: ["987654321098765432"],        agentFilter: ["default"],        sessionFilter: ["discord:"],        target: "dm", // dm | channel | both        cleanupAfterResolve: false,      },      retry: {        attempts: 3,        minDelayMs: 500,        maxDelayMs: 30000,        jitter: 0.1,      },    },  },}

• टोकन: channels.discord.token, जिसमें डिफ़ॉल्ट खाते के लिए फ़ॉलबैक के रूप में DISCORD_BOT_TOKEN होता है।
• स्पष्ट Discord token प्रदान करने वाली प्रत्यक्ष आउटबाउंड कॉल उस कॉल के लिए उसी टोकन का उपयोग करती हैं; खाते की पुनः प्रयास/नीति सेटिंग अब भी सक्रिय रनटाइम स्नैपशॉट में चुने गए खाते से आती हैं।
• वैकल्पिक channels.discord.defaultAccount, कॉन्फ़िगर किए गए खाता ID से मेल खाने पर डिफ़ॉल्ट खाता चयन को ओवरराइड करता है।
• डिलीवरी लक्ष्यों के लिए user:<id> (DM) या channel:<id> (गिल्ड चैनल) का उपयोग करें; केवल संख्यात्मक ID अस्वीकार कर दिए जाते हैं।
• गिल्ड स्लग लोअरकेस में होते हैं और रिक्त स्थानों को - से बदला जाता है; चैनल कुंजियाँ स्लग बनाए गए नाम का उपयोग करती हैं (# के बिना)। गिल्ड ID को प्राथमिकता दें।
• बॉट द्वारा लिखे गए संदेश डिफ़ॉल्ट रूप से अनदेखे किए जाते हैं। allowBots: true उन्हें सक्षम करता है; केवल बॉट का उल्लेख करने वाले बॉट संदेश स्वीकार करने के लिए allowBots: "mentions" का उपयोग करें (स्वयं के संदेश अब भी फ़िल्टर किए जाते हैं)।
• बॉट द्वारा लिखे गए इनबाउंड संदेशों का समर्थन करने वाले चैनल साझा बॉट लूप सुरक्षा का उपयोग कर सकते हैं। आधारभूत युग्म बजट के लिए channels.defaults.botLoopProtection सेट करें, फिर केवल तभी चैनल या खाते को ओवरराइड करें जब किसी एक सतह को अलग सीमाओं की आवश्यकता हो।
• channels.discord.guilds.<id>.ignoreOtherMentions (और चैनल ओवरराइड) उन संदेशों को हटा देता है जो किसी अन्य उपयोगकर्ता या भूमिका का उल्लेख करते हैं, लेकिन बॉट का नहीं (@everyone/@here को छोड़कर)।
• channels.discord.mentionAliases भेजने से पहले स्थिर आउटबाउंड @handle टेक्स्ट को Discord उपयोगकर्ता ID से मैप करता है, ताकि क्षणिक डायरेक्टरी कैश खाली होने पर भी ज्ञात टीम-साथियों का उल्लेख निर्धारक रूप से किया जा सके। प्रति-खाता ओवरराइड channels.discord.accounts.<accountId>.mentionAliases के अंतर्गत होते हैं।
• maxLinesPerMessage (डिफ़ॉल्ट 17) लंबे संदेशों को 2000 वर्णों से कम होने पर भी विभाजित करता है।
• channels.discord.suppressEmbeds का डिफ़ॉल्ट true है, इसलिए अक्षम किए जाने तक आउटबाउंड URL Discord लिंक पूर्वावलोकन में विस्तृत नहीं होते। स्पष्ट embeds पेलोड अब भी सामान्य रूप से भेजे जाते हैं; प्रति-संदेश टूल कॉल suppressEmbeds से इसे ओवरराइड कर सकते हैं।
• channels.discord.threadBindings Discord थ्रेड-बाउंड रूटिंग को नियंत्रित करता है:
  • enabled: थ्रेड-बाउंड सत्र सुविधाओं के लिए Discord ओवरराइड (/focus, /unfocus, /agents, /session idle, /session max-age, और बाउंड डिलीवरी/रूटिंग)
  • idleHours: घंटों में निष्क्रियता के बाद स्वतः अनफ़ोकस के लिए Discord ओवरराइड (0 इसे अक्षम करता है)
  • maxAgeHours: घंटों में कठोर अधिकतम आयु के लिए Discord ओवरराइड (0 इसे अक्षम करता है)
  • spawnSessions: sessions_spawn({ thread: true }) और ACP थ्रेड-स्पॉन की स्वतः थ्रेड रचना/बाइंडिंग के लिए स्विच (डिफ़ॉल्ट: true)
  • defaultSpawnContext: थ्रेड-बाउंड स्पॉन के लिए नेटिव सबएजेंट संदर्भ (डिफ़ॉल्ट रूप से "fork")
• type: "acp" वाली शीर्ष-स्तरीय bindings[] प्रविष्टियाँ चैनलों और थ्रेडों के लिए स्थायी ACP बाइंडिंग कॉन्फ़िगर करती हैं (match.peer.id में चैनल/थ्रेड ID का उपयोग करें)। फ़ील्ड के अर्थ ACP एजेंट में साझा किए गए हैं।
• channels.discord.ui.components.accentColor Discord कंपोनेंट v2 कंटेनरों के लिए एक्सेंट रंग सेट करता है।
• channels.discord.agentComponents.ttlMs नियंत्रित करता है कि भेजे गए Discord कंपोनेंट कॉलबैक कितने समय तक पंजीकृत रहें। डिफ़ॉल्ट 1800000 (30 मिनट), अधिकतम 86400000 (24 घंटे)। प्रति-खाता ओवरराइड channels.discord.accounts.<accountId>.agentComponents.ttlMs के अंतर्गत होते हैं। कार्यप्रवाह के अनुकूल सबसे छोटी TTL को प्राथमिकता दें।
• channels.discord.voice Discord वॉइस चैनल वार्तालाप और वैकल्पिक स्वतः-जुड़ाव + LLM + TTS ओवरराइड सक्षम करता है। केवल-टेक्स्ट Discord कॉन्फ़िगरेशन में वॉइस डिफ़ॉल्ट रूप से बंद रहती है; इसे चुनने के लिए channels.discord.voice.enabled=true सेट करें।
• channels.discord.voice.model वैकल्पिक रूप से Discord वॉइस चैनल प्रतिक्रियाओं के लिए उपयोग किए जाने वाले LLM मॉडल को ओवरराइड करता है।
• channels.discord.voice.daveEncryption (डिफ़ॉल्ट true) और channels.discord.voice.decryptionFailureTolerance (डिफ़ॉल्ट 24) को @discordjs/voice DAVE विकल्पों में आगे भेजा जाता है।
• channels.discord.voice.connectTimeoutMs, /vc join और स्वतः-जुड़ाव प्रयासों के लिए आरंभिक @discordjs/voice Ready प्रतीक्षा को नियंत्रित करता है (डिफ़ॉल्ट 30000)।
• channels.discord.voice.reconnectGraceMs नियंत्रित करता है कि OpenClaw द्वारा नष्ट किए जाने से पहले डिस्कनेक्ट हुआ वॉइस सत्र पुनः कनेक्ट संकेत में प्रवेश करने के लिए कितना समय ले सकता है (डिफ़ॉल्ट 15000)।
• किसी अन्य उपयोगकर्ता के बोलना-आरंभ इवेंट से Discord वॉइस प्लेबैक बाधित नहीं होता। फ़ीडबैक लूप से बचने के लिए, TTS चलने के दौरान OpenClaw नए वॉइस कैप्चर को अनदेखा करता है।
• OpenClaw बार-बार डिक्रिप्शन विफल होने के बाद वॉइस सत्र छोड़कर उससे पुनः जुड़ते हुए वॉइस रिसीव पुनर्प्राप्ति का अतिरिक्त प्रयास करता है।
• channels.discord.streaming कैननिकल स्ट्रीम मोड कुंजी है। Discord का डिफ़ॉल्ट streaming.mode: "progress" है, ताकि टूल/कार्य की प्रगति एक ही संपादित पूर्वावलोकन संदेश में दिखाई दे; इसे अक्षम करने के लिए streaming.mode: "off" सेट करें। पुराने फ़्लैट कुंजी (streamMode, chunkMode, blockStreaming, draftChunk, blockStreamingCoalesce) अब रनटाइम पर पढ़े नहीं जाते; स्थायी कॉन्फ़िगरेशन माइग्रेट करने के लिए openclaw doctor --fix चलाएँ।
• channels.discord.autoPresence रनटाइम उपलब्धता को बॉट उपस्थिति से मैप करता है (स्वस्थ => ऑनलाइन, अवनत => निष्क्रिय, समाप्त => dnd) और वैकल्पिक स्थिति टेक्स्ट ओवरराइड की अनुमति देता है।
• channels.discord.guilds.<id>.presenceEvents मानव उपलब्धता आगमन को एजेंट सिस्टम इवेंट के रूप में एक कॉन्फ़िगर किए गए Discord चैनल में रूट करता है। योग्य सदस्यों को channelId देखने में सक्षम होना चाहिए; सार्वजनिक थ्रेड मूल दृश्यता प्राप्त करते हैं, जबकि निजी थ्रेडों के लिए सदस्यता या Manage Threads की भी आवश्यकता होती है। users उस दर्शक-वर्ग को और सीमित कर सकता है। यह पूर्ण GUILD_CREATE स्नैपशॉट से वर्तमान ऑनलाइन सदस्यों को आरंभिक रूप से दर्ज करता है, देखे गए ऑफ़लाइन-से-ऑनलाइन संक्रमणों को रूट करता है, और पहले न देखे गए सदस्य के लिए बाद में मिले प्रथम ऑनलाइन संकेत को नई उपलब्धता मानता है, बिना यह दावा किए कि वे ऑनलाइन हुए या स्नैपशॉट के बाद जुड़े। Discord की 75,000-सदस्य स्नैपशॉट सीमा से बड़े गिल्डों को पहले एक स्पष्ट ऑफ़लाइन अपडेट की आवश्यकता होती है। थ्रॉटलिंग नियंत्रण: reconnectSuppressSeconds (नए Gateway सत्र के बाद गिल्ड उपस्थिति स्थिति पुनर्निर्मित होने के दौरान शांत अवधि, डिफ़ॉल्ट 300, 0 इसे अक्षम करता है) और burstLimit/burstWindowSeconds (प्रति-गिल्ड सफलतापूर्वक कतारबद्ध इवेंट दर सीमा, डिफ़ॉल्ट रूप से 60s की स्लाइडिंग विंडो में 8 इवेंट)। पुनः शुरू किए गए सत्र पुनः कनेक्ट दमन विंडो आरंभ नहीं करते। मौजूदा प्रति-उपयोगकर्ता पुनः-अभिवादन कूलडाउन आठ घंटे रहता है। इसके लिए channels.discord.intents.presence=true, Discord के Developer Portal में विशेषाधिकार प्राप्त Presence Intent, और सक्षम एजेंट Heartbeat आवश्यक हैं।
• channels.discord.dangerouslyAllowNameMatching परिवर्तनीय नाम/टैग मिलान को पुनः सक्षम करता है (आपातकालीन संगतता मोड)।
• channels.discord.execApprovals: Discord-नेटिव निष्पादन अनुमोदन डिलीवरी और अनुमोदक प्राधिकरण।
  • enabled: true, false, या "auto" (डिफ़ॉल्ट)। स्वचालित मोड में, जब अनुमोदकों को approvers या commands.ownerAllowFrom से हल किया जा सकता है, तब निष्पादन अनुमोदन सक्रिय होते हैं।
  • approvers: निष्पादन अनुरोध अनुमोदित करने की अनुमति वाले Discord उपयोगकर्ता ID। छोड़े जाने पर commands.ownerAllowFrom का फ़ॉलबैक होता है।
  • agentFilter: वैकल्पिक एजेंट ID अनुमतिसूची। सभी एजेंटों के अनुमोदन अग्रेषित करने के लिए इसे छोड़ दें।
  • sessionFilter: वैकल्पिक सत्र कुंजी पैटर्न (सबस्ट्रिंग या रेगेक्स)।
  • target: अनुमोदन प्रॉम्प्ट कहाँ भेजे जाएँ। "dm" (डिफ़ॉल्ट) अनुमोदक के DM में भेजता है, "channel" मूल चैनल में भेजता है, "both" दोनों में भेजता है। जब लक्ष्य में "channel" शामिल होता है, तो बटन केवल हल किए गए अनुमोदकों द्वारा उपयोग किए जा सकते हैं।
  • cleanupAfterResolve: true होने पर अनुमोदन, अस्वीकृति या समय-समाप्ति के बाद अनुमोदन DM हटा देता है।

प्रतिक्रिया सूचना मोड: off (कोई नहीं), own (बॉट के संदेश, डिफ़ॉल्ट), all (सभी संदेश), allowlist (सभी संदेशों पर guilds.<id>.users से)।

Google Chat

{  channels: {    googlechat: {      enabled: true,      serviceAccountFile: "/path/to/service-account.json",      audienceType: "app-url", // app-url | project-number      audience: "https://gateway.example.com/googlechat",      webhookPath: "/googlechat",      botUser: "users/1234567890",      dmPolicy: "pairing",      allowFrom: ["users/1234567890"],      groupPolicy: "allowlist",      groups: {        "spaces/AAAA": { allow: true, requireMention: true },      },      actions: { reactions: true },      typingIndicator: "message",      mediaMaxMb: 20,    },  },}

• सेवा खाता JSON: इनलाइन (serviceAccount) या फ़ाइल-आधारित (serviceAccountFile)।
• serviceAccount सीधे SecretRef स्वीकार करता है।
• पर्यावरण फ़ॉलबैक: GOOGLE_CHAT_SERVICE_ACCOUNT या GOOGLE_CHAT_SERVICE_ACCOUNT_FILE (केवल डिफ़ॉल्ट खाता)।
• डिलीवरी लक्ष्यों के लिए spaces/<spaceId> या users/<userId> का उपयोग करें।
• channels.googlechat.dangerouslyAllowNameMatching परिवर्तनीय ईमेल प्रिंसिपल मिलान को पुनः सक्षम करता है (आपातकालीन संगतता मोड)।

Slack

{  channels: {    slack: {      enabled: true,      botToken: "xoxb-...",      appToken: "xapp-...",      socketMode: {        clientPingTimeout: 15000,        serverPingTimeout: 30000,        pingPongLoggingEnabled: false,      },      dmPolicy: "pairing",      allowFrom: ["U123", "U456", "*"],      dm: { enabled: true, groupEnabled: false, groupChannels: ["G123"] },      channels: {        C123: { enabled: true, requireMention: true, allowBots: false },        "#general": {          enabled: true,          requireMention: true,          allowBots: false,          users: ["U123"],          skills: ["docs"],          systemPrompt: "केवल संक्षिप्त उत्तर दें।",        },      },      historyLimit: 50,      allowBots: false,      reactionNotifications: "own",      reactionAllowlist: ["U123"],      replyToMode: "off", // off | first | all | batched      thread: {        historyScope: "thread", // thread | channel        inheritParent: false,        initialHistoryLimit: 20,      },      actions: {        reactions: true,        messages: true,        pins: true,        memberInfo: true,        emojiList: true,      },      slashCommand: {        enabled: true,        name: "openclaw",        sessionPrefix: "slack:slash",        ephemeral: true,      },      typingReaction: "hourglass_flowing_sand",      unfurlLinks: false,      unfurlMedia: false,      textChunkLimit: 4000,      streaming: {        mode: "partial", // off | partial | block | progress        chunkMode: "length", // length | newline        nativeTransport: true, // mode=partial होने पर Slack के मूल स्ट्रीमिंग API का उपयोग करें      },      mediaMaxMb: 20,      execApprovals: {        enabled: "auto", // true | false | "auto"        approvers: ["U123"],        agentFilter: ["default"],        sessionFilter: ["slack:"],        target: "dm", // dm | channel | both      },    },  },}

• Socket मोड के लिए botToken और appToken दोनों आवश्यक हैं (डिफ़ॉल्ट अकाउंट env फ़ॉलबैक के लिए SLACK_BOT_TOKEN + SLACK_APP_TOKEN)।
• HTTP मोड के लिए botToken के साथ signingSecret आवश्यक है (रूट पर या प्रति-अकाउंट)।
• उपयोगकर्ता पहचान (identity: "user") अधिकृत करने वाले व्यक्ति के रूप में पोस्ट करती और पढ़ती है। इसके लिए Socket Mode में userToken के साथ appToken, या HTTP मोड में userToken के साथ signingSecret आवश्यक है। किसी bot token या bot user की आवश्यकता नहीं है। उपयोगकर्ता स्कोप और इवेंट सब्सक्रिप्शन के लिए उपयोगकर्ता पहचान देखें।
• enterpriseOrgInstall: true किसी अकाउंट को Slack Enterprise Grid के संगठन-व्यापी इवेंट पथ में शामिल करता है। स्टार्टअप auth.test से bot token सत्यापित करता है और कॉन्फ़िगर किया गया मोड Slack की इंस्टॉलेशन पहचान से मेल न खाने पर विफल हो जाता है। Enterprise DM अक्षम होने चाहिए या प्रभावी allowFrom: ["*"] के साथ dmPolicy: "open" का उपयोग करना चाहिए। चैनल और उपयोगकर्ता नीतियों में स्थायी Slack ID का उपयोग होना चाहिए; परिवर्तनशील नाम और असमर्थित चैनल प्रीफ़िक्स स्टार्टअप को विफल कर देते हैं। V1 केवल सीधे Socket Mode या HTTP message और app_mention इवेंट को तत्काल उत्तरों के साथ संभालता है; relay, commands, interactions, App Home, reaction event listeners, pins, action tools, मूल approvals, bindings, स्थगित डिलीवरी और सक्रिय रूप से भेजना उपलब्ध नहीं है। Listener के स्वामित्व वाली acknowledgment, typing और status reactions reactions:write के साथ उपलब्ध रहती हैं; आने वाली reaction notifications और reaction action tools उपलब्ध नहीं हैं। न्यूनतम-अधिकार वाले manifest, सेटअप कार्यप्रवाह और संपूर्ण प्रतिबंधों के लिए Enterprise Grid के संगठन-व्यापी इंस्टॉल देखें।
• socketMode Slack SDK Socket Mode की ट्रांसपोर्ट ट्यूनिंग को सार्वजनिक Bolt receiver API तक पहुँचाता है। इसका उपयोग केवल ping/pong टाइमआउट या पुराने websocket व्यवहार की जाँच करते समय करें। clientPingTimeout का डिफ़ॉल्ट 15000 है; serverPingTimeout और pingPongLoggingEnabled केवल कॉन्फ़िगर होने पर भेजे जाते हैं।
• botToken, appToken, signingSecret, और userToken सादे टेक्स्ट स्ट्रिंग या SecretRef ऑब्जेक्ट स्वीकार करते हैं।
• Slack अकाउंट स्नैपशॉट प्रति-क्रेडेंशियल स्रोत/स्थिति फ़ील्ड दिखाते हैं, जैसे botTokenSource, botTokenStatus, userTokenSource, userTokenStatus, appTokenStatus, और HTTP मोड में signingSecretStatus। configured_unavailable का अर्थ है कि अकाउंट SecretRef के माध्यम से कॉन्फ़िगर किया गया है, लेकिन वर्तमान कमांड/रनटाइम पथ secret मान को हल नहीं कर सका।
• configWrites: false Slack द्वारा आरंभ किए गए कॉन्फ़िगरेशन लेखन को रोकता है।
• वैकल्पिक channels.slack.defaultAccount किसी कॉन्फ़िगर किए गए अकाउंट ID से मेल खाने पर डिफ़ॉल्ट अकाउंट चयन को ओवरराइड करता है।
• channels.slack.streaming.mode Slack का कैनोनिकल स्ट्रीम मोड कुंजी है (डिफ़ॉल्ट "partial")। channels.slack.streaming.nativeTransport Slack के मूल स्ट्रीमिंग ट्रांसपोर्ट को नियंत्रित करता है (डिफ़ॉल्ट true)। पुराने streamMode, बूलियन streaming, chunkMode, blockStreaming, blockStreamingCoalesce, और nativeStreaming मान अब रनटाइम पर नहीं पढ़े जाते; स्थायी कॉन्फ़िगरेशन को streaming.{mode,chunkMode,block.enabled,block.coalesce,nativeTransport} में माइग्रेट करने के लिए openclaw doctor --fix चलाएँ।
• unfurlLinks और unfurlMedia bot उत्तरों के लिए Slack के chat.postMessage लिंक और मीडिया unfurl बूलियन को आगे भेजते हैं। unfurlLinks का डिफ़ॉल्ट false है, इसलिए सक्षम किए बिना आउटबाउंड bot लिंक इनलाइन विस्तृत नहीं होते; कॉन्फ़िगर न होने पर unfurlMedia छोड़ दिया जाता है। किसी एक अकाउंट के लिए शीर्ष-स्तरीय मान को ओवरराइड करने हेतु channels.slack.accounts.<accountId> पर कोई भी मान सेट करें।
• डिलीवरी लक्ष्यों के लिए user:<id> (DM) या channel:<id> का उपयोग करें।

Reaction notification मोड: off, own (डिफ़ॉल्ट), all, allowlist (reactionAllowlist से)।

थ्रेड सेशन पृथक्करण: thread.historyScope प्रति-थ्रेड (डिफ़ॉल्ट) होता है या पूरे चैनल में साझा होता है। thread.inheritParent पैरेंट चैनल ट्रांसक्रिप्ट को नए थ्रेड में कॉपी करता है। thread.initialHistoryLimit (डिफ़ॉल्ट 20) सीमित करता है कि नया थ्रेड सेशन शुरू होने पर कितने मौजूदा थ्रेड संदेश फ़ेच किए जाएँ; 0 थ्रेड इतिहास फ़ेच करना अक्षम करता है।

• Slack की मूल स्ट्रीमिंग और Slack assistant-शैली की "is typing..." थ्रेड स्थिति के लिए उत्तर का थ्रेड लक्ष्य आवश्यक है। शीर्ष-स्तरीय DM डिफ़ॉल्ट रूप से थ्रेड से बाहर रहते हैं, इसलिए वे थ्रेड-शैली का मूल स्ट्रीम/स्थिति पूर्वावलोकन दिखाने के बजाय Slack के ड्राफ़्ट पोस्ट-और-संपादन पूर्वावलोकनों के माध्यम से स्ट्रीम कर सकते हैं।
• typingReaction उत्तर चलने के दौरान आने वाले Slack संदेश पर अस्थायी reaction जोड़ता है और पूर्ण होने पर उसे हटा देता है। "hourglass_flowing_sand" जैसे Slack emoji shortcode का उपयोग करें।
• channels.slack.execApprovals: Slack-मूल approval-client डिलीवरी और exec approver प्राधिकरण। Discord के समान स्कीमा: enabled (true/false/"auto"), approvers (Slack उपयोगकर्ता ID), agentFilter, sessionFilter, और target ("dm", "channel", या "both")। Slack Plugin approver हल होने पर Plugin approval, Slack से आरंभ हुए अनुरोधों के लिए इस मूल-client पथ का उपयोग कर सकते हैं; Slack से आरंभ हुए सेशन या Slack लक्ष्यों के लिए Slack-मूल Plugin approval डिलीवरी को approvals.plugin के माध्यम से भी सक्षम किया जा सकता है। Plugin approval, allowFrom और डिफ़ॉल्ट रूटिंग के Slack Plugin approver का उपयोग करते हैं, exec approver का नहीं।

Mattermost

Mattermost एक अलग Plugin के रूप में इंस्टॉल होता है, ठीक वैसे ही जैसे Discord, Slack और WhatsApp होते हैं:

openclaw plugins install @openclaw/mattermost

किसी संस्करण को पिन करने से पहले वर्तमान dist-tags के लिए npmjs.com/package/@openclaw/mattermost देखें।

{  channels: {    mattermost: {      enabled: true,      botToken: "mm-token",      baseUrl: "https://chat.example.com",      dmPolicy: "pairing",      chatmode: "oncall", // oncall | onmessage | onchar      oncharPrefixes: [">", "!"],      groups: {        "*": { requireMention: true },        "team-channel-id": { requireMention: false },      },      commands: {        native: true, // स्वैच्छिक रूप से सक्षम करें        nativeSkills: true,        callbackPath: "/api/channels/mattermost/command",        // reverse-proxy/सार्वजनिक डिप्लॉयमेंट के लिए वैकल्पिक स्पष्ट URL        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",      },      textChunkLimit: 4000,      streaming: { chunkMode: "length" },    },  },}

चैट मोड: oncall (@-mention पर उत्तर दें, डिफ़ॉल्ट), onmessage (हर संदेश), onchar (ट्रिगर प्रीफ़िक्स से शुरू होने वाले संदेश)।

Mattermost के मूल कमांड सक्षम होने पर:

• commands.callbackPath एक पथ होना चाहिए (उदाहरण के लिए /api/channels/mattermost/command), पूरा URL नहीं।
• commands.callbackUrl को OpenClaw Gateway एंडपॉइंट पर हल होना चाहिए और Mattermost सर्वर से पहुँच योग्य होना चाहिए।
• मूल slash callbacks को slash command पंजीकरण के दौरान Mattermost द्वारा लौटाए गए प्रति-कमांड token से प्रमाणित किया जाता है। यदि पंजीकरण विफल हो जाता है या कोई कमांड सक्रिय नहीं होता, तो OpenClaw callbacks को Unauthorized: invalid command token. के साथ अस्वीकार करता है।
• निजी/tailnet/आंतरिक callback होस्ट के लिए Mattermost को callback होस्ट/डोमेन शामिल करने हेतु ServiceSettings.AllowedUntrustedInternalConnections की आवश्यकता हो सकती है। पूरे URL के बजाय होस्ट/डोमेन मानों का उपयोग करें।
• channels.mattermost.configWrites: Mattermost द्वारा आरंभ किए गए कॉन्फ़िगरेशन लेखन को अनुमति दें या अस्वीकार करें।
• channels.mattermost.requireMention: चैनलों में उत्तर देने से पहले @mention आवश्यक बनाएँ।
• channels.mattermost.groups.<channelId>.requireMention: प्रति-चैनल mention-gating ओवरराइड (डिफ़ॉल्ट के लिए "*")।
• वैकल्पिक channels.mattermost.defaultAccount किसी कॉन्फ़िगर किए गए अकाउंट ID से मेल खाने पर डिफ़ॉल्ट अकाउंट चयन को ओवरराइड करता है।

Signal

{  channels: {    signal: {      enabled: true,      account: "+15555550123", // वैकल्पिक अकाउंट बाइंडिंग      dmPolicy: "pairing",      allowFrom: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],      configWrites: true,      reactionNotifications: "own", // off | own | all | allowlist      reactionAllowlist: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],      historyLimit: 50,    },  },}

Reaction notification मोड: off, own (डिफ़ॉल्ट), all, allowlist (reactionAllowlist से)।

• channels.signal.account: चैनल स्टार्टअप को किसी विशिष्ट Signal अकाउंट पहचान से बाँधें।
• channels.signal.configWrites: Signal द्वारा आरंभ किए गए कॉन्फ़िगरेशन लेखन को अनुमति दें या अस्वीकार करें।
• वैकल्पिक channels.signal.defaultAccount किसी कॉन्फ़िगर किए गए अकाउंट ID से मेल खाने पर डिफ़ॉल्ट अकाउंट चयन को ओवरराइड करता है।

iMessage

OpenClaw imsg rpc को प्रारंभ करता है (stdio पर JSON-RPC)। किसी daemon या port की आवश्यकता नहीं है। जब होस्ट Messages डेटाबेस और Automation अनुमतियाँ दे सकता हो, तब नए OpenClaw iMessage सेटअप के लिए यही पसंदीदा पथ है।

BlueBubbles समर्थन हटा दिया गया है। वर्तमान OpenClaw में channels.bluebubbles समर्थित रनटाइम कॉन्फ़िगरेशन सतह नहीं है। पुराने कॉन्फ़िगरेशन को channels.imessage में माइग्रेट करें; संक्षिप्त संस्करण के लिए BlueBubbles को हटाना और imsg iMessage पथ तथा पूर्ण रूपांतरण तालिका के लिए BlueBubbles से आना देखें।

यदि Gateway साइन-इन किए गए Messages Mac पर नहीं चल रहा है, तो channels.imessage.enabled=true बनाए रखें और channels.imessage.cliPath को ऐसे SSH wrapper पर सेट करें जो उस Mac पर imsg "$@" चलाता हो। डिफ़ॉल्ट स्थानीय imsg पथ केवल macOS के लिए है।

उत्पादन प्रेषणों के लिए SSH रैपर पर निर्भर होने से पहले, उसी रैपर के माध्यम से एक आउटबाउंड imsg send सत्यापित करें। कुछ macOS TCC स्थितियाँ Messages Automation को /usr/libexec/sshd-keygen-wrapper को असाइन करती हैं, जिससे पठन और जाँच काम कर सकती हैं, जबकि प्रेषण AppleEvents -1743 के साथ विफल होते हैं; iMessage पर SSH रैपर समस्या-निवारण अनुभाग देखें।

{  channels: {    imessage: {      enabled: true,      cliPath: "imsg",      dbPath: "~/Library/Messages/chat.db",      remoteHost: "user@gateway-host",      dmPolicy: "pairing",      allowFrom: ["+15555550123", "user@example.com", "chat_id:123"],      historyLimit: 50,      includeAttachments: false,      attachmentRoots: ["/Users/*/Library/Messages/Attachments"],      remoteAttachmentRoots: ["/Users/*/Library/Messages/Attachments"],      mediaMaxMb: 16,      service: "auto",      sendTransport: "auto",      region: "US",      actions: {        reactions: true,        edit: true,        unsend: true,        reply: true,        sendWithEffect: true,        sendAttachment: true,      },    },  },}

• वैकल्पिक channels.imessage.defaultAccount किसी कॉन्फ़िगर किए गए अकाउंट id से मेल खाने पर डिफ़ॉल्ट अकाउंट चयन को ओवरराइड करता है।
• Messages DB के लिए Full Disk Access आवश्यक है।
• chat_id:<id> लक्ष्यों को प्राथमिकता दें। चैट सूचीबद्ध करने के लिए imsg chats --limit 20 का उपयोग करें।
• cliPath किसी SSH रैपर की ओर संकेत कर सकता है; SCP अटैचमेंट प्राप्त करने के लिए remoteHost (host या user@host) सेट करें।
• attachmentRoots और remoteAttachmentRoots इनबाउंड अटैचमेंट पथों को प्रतिबंधित करते हैं (डिफ़ॉल्ट: /Users/*/Library/Messages/Attachments)।
• SCP सख्त होस्ट-कुंजी जाँच का उपयोग करता है, इसलिए सुनिश्चित करें कि रिले होस्ट कुंजी पहले से ~/.ssh/known_hosts में मौजूद है।
• channels.imessage.configWrites: iMessage द्वारा आरंभ किए गए कॉन्फ़िगरेशन लेखन को अनुमति दें या अस्वीकार करें।
• channels.imessage.sendTransport: सामान्य आउटबाउंड उत्तरों के लिए पसंदीदा imsg RPC प्रेषण ट्रांसपोर्ट। auto (डिफ़ॉल्ट) चल रहे IMCore ब्रिज का मौजूदा चैट के लिए उपयोग करता है, फिर AppleScript पर फ़ॉलबैक करता है; bridge के लिए निजी-API डिलीवरी आवश्यक है; applescript सार्वजनिक Messages ऑटोमेशन पथ को बाध्य करता है।
• channels.imessage.actions.*: उन निजी API क्रियाओं को सक्षम करें जिन्हें imsg status / openclaw channels status --probe द्वारा भी नियंत्रित किया जाता है।
• channels.imessage.includeAttachments डिफ़ॉल्ट रूप से बंद है; एजेंट टर्न में इनबाउंड मीडिया की अपेक्षा करने से पहले इसे true पर सेट करें।
• ब्रिज/Gateway पुनरारंभ के बाद इनबाउंड पुनर्प्राप्ति स्वचालित है (GUID डीडुप्लिकेशन और पुराने बैकलॉग की आयु-सीमा)। मौजूदा channels.imessage.catchup.enabled: true कॉन्फ़िगरेशन को अब भी बहिष्कृत संगतता प्रोफ़ाइल के रूप में स्वीकार किया जाता है; catchup डिफ़ॉल्ट रूप से अक्षम है।
• channels.imessage.groups: समूह रजिस्ट्री और प्रति-समूह सेटिंग्स। groupPolicy: "allowlist" के साथ, स्पष्ट chat_id कुंजियाँ या एक "*" वाइल्डकार्ड प्रविष्टि कॉन्फ़िगर करें, ताकि समूह संदेश रजिस्ट्री गेट से गुजर सकें।
• type: "acp" वाली शीर्ष-स्तरीय bindings[] प्रविष्टियाँ iMessage वार्तालापों को स्थायी ACP सत्रों से बाँध सकती हैं। match.peer.id में सामान्यीकृत हैंडल या स्पष्ट चैट लक्ष्य (chat_id:*, chat_guid:*, chat_identifier:*) का उपयोग करें। साझा फ़ील्ड अर्थविज्ञान: ACP एजेंट।

#!/usr/bin/env bashexec ssh -T gateway-host imsg "$@"

Matrix

Matrix Plugin-समर्थित है और channels.matrix के अंतर्गत कॉन्फ़िगर किया जाता है।

{  channels: {    matrix: {      enabled: true,      homeserver: "https://matrix.example.org",      accessToken: "syt_bot_xxx",      proxy: "http://127.0.0.1:7890",      encryption: true,      initialSyncLimit: 20,      defaultAccount: "ops",      accounts: {        ops: {          name: "Ops",          userId: "@ops:example.org",          accessToken: "syt_ops_xxx",        },        alerts: {          userId: "@alerts:example.org",          password: "secret",          proxy: "http://127.0.0.1:7891",        },      },    },  },}

• टोकन प्रमाणीकरण accessToken का उपयोग करता है; पासवर्ड प्रमाणीकरण userId + password का उपयोग करता है।
• channels.matrix.proxy Matrix HTTP ट्रैफ़िक को स्पष्ट HTTP(S) प्रॉक्सी के माध्यम से रूट करता है। नामित अकाउंट इसे channels.matrix.accounts.<id>.proxy से ओवरराइड कर सकते हैं।
• channels.matrix.network.dangerouslyAllowPrivateNetwork निजी/आंतरिक होमसर्वर की अनुमति देता है। proxy और यह नेटवर्क ऑप्ट-इन स्वतंत्र नियंत्रण हैं।
• channels.matrix.defaultAccount बहु-अकाउंट सेटअप में पसंदीदा अकाउंट चुनता है।
• channels.matrix.autoJoin का डिफ़ॉल्ट "off" है, इसलिए आमंत्रित रूम और नए DM-शैली आमंत्रण तब तक अनदेखे किए जाते हैं, जब तक आप autoJoin: "allowlist" को autoJoinAllowlist या autoJoin: "always" के साथ सेट नहीं करते।
• channels.matrix.execApprovals: Matrix-नेटिव निष्पादन अनुमोदन डिलीवरी और अनुमोदक प्राधिकरण।
  • enabled: true, false, या "auto" (डिफ़ॉल्ट)। स्वचालित मोड में, निष्पादन अनुमोदन तब सक्रिय होते हैं जब अनुमोदकों को approvers या commands.ownerAllowFrom से निर्धारित किया जा सकता है।
  • approvers: वे Matrix उपयोगकर्ता ID (जैसे @owner:example.org) जिन्हें निष्पादन अनुरोधों को अनुमोदित करने की अनुमति है।
  • agentFilter: वैकल्पिक एजेंट ID अनुमति-सूची। सभी एजेंटों के अनुमोदन अग्रेषित करने के लिए इसे छोड़ दें।
  • sessionFilter: वैकल्पिक सत्र कुंजी पैटर्न (सबस्ट्रिंग या रेगेक्स)।
  • target: अनुमोदन प्रॉम्प्ट कहाँ भेजने हैं। "dm" (डिफ़ॉल्ट), "channel" (मूल रूम), या "both"।
  • प्रति-अकाउंट ओवरराइड: channels.matrix.accounts.<id>.execApprovals।
• channels.matrix.dm.sessionScope नियंत्रित करता है कि Matrix DM सत्रों में कैसे समूहित होते हैं: per-user (डिफ़ॉल्ट) रूट किए गए पीयर के अनुसार साझा करता है, जबकि per-room प्रत्येक DM रूम को अलग रखता है।
• Matrix स्थिति जाँच और लाइव डायरेक्टरी लुकअप रनटाइम ट्रैफ़िक जैसी ही प्रॉक्सी नीति का उपयोग करते हैं।
• संपूर्ण Matrix कॉन्फ़िगरेशन, लक्ष्यीकरण नियम और सेटअप उदाहरण Matrix में प्रलेखित हैं।

Microsoft Teams

Microsoft Teams Plugin-समर्थित है और channels.msteams के अंतर्गत कॉन्फ़िगर किया जाता है।

{  channels: {    msteams: {      enabled: true,      configWrites: true,      // appId, appPassword, tenantId, webhook, team/channel नीतियाँ:      // /channels/msteams देखें    },  },}

• यहाँ शामिल मुख्य कुंजी पथ: channels.msteams, channels.msteams.configWrites।
• Teams का संपूर्ण कॉन्फ़िगरेशन (क्रेडेंशियल, Webhook, DM/समूह नीति, प्रति-टीम/प्रति-चैनल ओवरराइड) Microsoft Teams में प्रलेखित है।

IRC

IRC Plugin-समर्थित है और channels.irc के अंतर्गत कॉन्फ़िगर किया जाता है।

{  channels: {    irc: {      enabled: true,      dmPolicy: "pairing",      configWrites: true,      nickserv: {        enabled: true,        service: "NickServ",        password: "${IRC_NICKSERV_PASSWORD}",        register: false,        registerEmail: "bot@example.com",      },    },  },}

• यहाँ शामिल मुख्य कुंजी पथ: channels.irc, channels.irc.dmPolicy, channels.irc.configWrites, channels.irc.nickserv.*।
• वैकल्पिक channels.irc.defaultAccount किसी कॉन्फ़िगर किए गए अकाउंट id से मेल खाने पर डिफ़ॉल्ट अकाउंट चयन को ओवरराइड करता है।
• संपूर्ण IRC चैनल कॉन्फ़िगरेशन (होस्ट/पोर्ट/TLS/चैनल/अनुमति-सूचियाँ/उल्लेख गेटिंग) IRC में प्रलेखित है।

बहु-अकाउंट (सभी चैनल)

प्रति चैनल एकाधिक अकाउंट चलाएँ (प्रत्येक का अपना accountId):

{  channels: {    telegram: {      accounts: {        default: {          name: "Primary bot",          botToken: "123456:ABC...",        },        alerts: {          name: "Alerts bot",          botToken: "987654:XYZ...",        },      },    },  },}

• accountId छोड़े जाने पर default का उपयोग किया जाता है (CLI + रूटिंग)।
• पर्यावरण टोकन केवल डिफ़ॉल्ट अकाउंट पर लागू होते हैं।
• मूल चैनल सेटिंग्स सभी अकाउंट पर लागू होती हैं, जब तक कि उन्हें प्रति अकाउंट ओवरराइड न किया गया हो।
• प्रत्येक अकाउंट को अलग एजेंट पर रूट करने के लिए bindings[].match.accountId का उपयोग करें।
• यदि आप अभी भी एकल-अकाउंट शीर्ष-स्तरीय चैनल कॉन्फ़िगरेशन पर रहते हुए openclaw channels add (या चैनल ऑनबोर्डिंग) के माध्यम से गैर-डिफ़ॉल्ट अकाउंट जोड़ते हैं, तो OpenClaw पहले अकाउंट-स्कोप वाले शीर्ष-स्तरीय एकल-अकाउंट मानों को चैनल अकाउंट मैप में उन्नत करता है, ताकि मूल अकाउंट काम करता रहे। अधिकांश चैनल उन्हें channels.<channel>.accounts.default में ले जाते हैं; इसके बजाय Matrix किसी मौजूदा मेल खाते नामित/डिफ़ॉल्ट लक्ष्य को संरक्षित कर सकता है।
• मौजूदा केवल-चैनल बाइंडिंग (accountId के बिना) डिफ़ॉल्ट अकाउंट से मेल खाती रहती हैं; अकाउंट-स्कोप वाली बाइंडिंग वैकल्पिक रहती हैं।
• openclaw doctor --fix अकाउंट-स्कोप वाले शीर्ष-स्तरीय एकल-अकाउंट मानों को उस चैनल के लिए चुने गए उन्नत अकाउंट में ले जाकर मिश्रित संरचनाओं की भी मरम्मत करता है। अधिकांश चैनल accounts.default का उपयोग करते हैं; इसके बजाय Matrix किसी मौजूदा मेल खाते नामित/डिफ़ॉल्ट लक्ष्य को संरक्षित कर सकता है।

अन्य Plugin चैनल

कई Plugin चैनल channels.<id> के रूप में कॉन्फ़िगर किए जाते हैं और उनके समर्पित चैनल पृष्ठों में प्रलेखित हैं (उदाहरण के लिए Feishu, LINE, Nextcloud Talk, Nostr, QQ Bot, Synology Chat, Twitch और Zalo)। संपूर्ण चैनल अनुक्रमणिका देखें: चैनल।

समूह चैट उल्लेख गेटिंग

समूह संदेशों में डिफ़ॉल्ट रूप से उल्लेख आवश्यक होता है (मेटाडेटा उल्लेख या सुरक्षित रेगेक्स पैटर्न)। यह WhatsApp, Telegram, Discord, Google Chat और iMessage समूह चैट पर लागू होता है।

दृश्यमान उत्तरों को अलग से नियंत्रित किया जाता है। सामान्य समूह, चैनल और आंतरिक WebChat प्रत्यक्ष अनुरोधों में डिफ़ॉल्ट रूप से स्वचालित अंतिम डिलीवरी होती है: अंतिम सहायक टेक्स्ट पुराने दृश्यमान उत्तर पथ से पोस्ट होता है। जब मॉडल द्वारा लिखे गए स्रोत उत्तर केवल एजेंट के message(action=send) को कॉल करने के बाद पोस्ट होने चाहिए, तो messages.visibleReplies: "message_tool" या messages.groupChat.visibleReplies: "message_tool" को ऑप्ट-इन करें। यदि मॉडल ऑप्ट-इन किए गए केवल-टूल मोड में संदेश टूल को कॉल किए बिना कोई सार्थक अंतिम उत्तर देता है, तो वह अंतिम टेक्स्ट निजी रहता है, Gateway का वर्बोज़ लॉग दबाए गए पेलोड का मेटाडेटा दर्ज करता है और OpenClaw मॉडल से वही उत्तर message(action=send) के माध्यम से वितरित करने के लिए कहते हुए एक पुनर्प्राप्ति पुनःप्रयास कतारबद्ध करता है।

केवल-टूल नीति सहायक के स्रोत उत्तरों और सामान्य टूल मीडिया को नियंत्रित करती है। यह रनटाइम-स्वामित्व वाले टर्मिनल आउटपुट को नहीं दबाती, जैसे अधिकृत कमांड प्रतिक्रियाएँ, स्थायी पूर्णता सूचनाएँ या प्रदाता-नेटिव आर्टिफ़ैक्ट जिन्हें स्वामी हार्नेस स्पष्ट रूप से होस्ट-स्वामित्व वाला वर्गीकृत करता है। होस्ट-स्वामित्व वाले आर्टिफ़ैक्ट सामान्य चैनल डिस्पैच पथ से वितरित किए जाते हैं और फिर भी आउटबाउंड sendPolicy अस्वीकृति का पालन करते हैं। परिवेशी room_event टर्न तब तक शांत रहते हैं, जब तक वे स्पष्ट कमांड न हों, भले ही रनटाइम आउटपुट होस्ट-स्वामित्व वाला चिह्नित हो।

केवल-टूल दृश्यमान उत्तरों के लिए ऐसा मॉडल/रनटाइम आवश्यक है जो विश्वसनीय रूप से टूल कॉल करे, और GPT-5.6 Sol जैसे नवीनतम पीढ़ी के मॉडल वाले साझा परिवेशी रूम के लिए इनकी अनुशंसा की जाती है। कुछ कमज़ोर मॉडल अंतिम टेक्स्ट में उत्तर दे सकते हैं, लेकिन यह समझने में विफल रहते हैं कि स्रोत में दृश्यमान आउटपुट को message(action=send) के साथ भेजना आवश्यक है। OpenClaw सामान्य फँसे हुए अंतिम उत्तर की स्थिति को डिफ़ॉल्ट रूप से केवल तभी पुनर्प्राप्त करता है, जब अंतिम उत्तर सार्थक हो, स्रोत टर्न कोई रूम इवेंट न हो, प्रेषण नीति ने डिलीवरी अस्वीकार न की हो और कोई स्रोत उत्तर पहले से न भेजा गया हो। पुनर्प्राप्ति केवल एक पुनःप्रयास तक सीमित है; यह कृत्रिम पुनःप्रयास प्रॉम्प्ट का स्थायीकरण दबाती है और उस पुनःप्रयास को संग्रह बैचिंग से बाहर रखती है, ताकि वह असंबंधित कतारबद्ध प्रॉम्प्ट के साथ विलय न हो सके। यदि पुनःप्रयास भी फँस जाता है या कतारबद्ध नहीं किया जा सकता, तो OpenClaw केवल स्वच्छ किया गया निदान वितरित करता है, जैसे "मैंने एक उत्तर बनाया, लेकिन उसे इस चैट में वितरित नहीं कर सका। कृपया फिर प्रयास करें।" मूल निजी अंतिम टेक्स्ट को स्वचालित स्रोत डिलीवरी के लिए कभी चिह्नित नहीं किया जाता। जो मॉडल बार-बार उत्तर फँसाते हैं, उनके लिए "automatic" का उपयोग करें ताकि अंतिम सहायक टर्न दृश्यमान उत्तर पथ हो, अधिक सक्षम टूल-कॉलिंग मॉडल अपनाएँ, दबाए गए पेलोड सारांश के लिए Gateway के वर्बोज़ लॉग की जाँच करें, या प्रत्येक समूह/चैनल अनुरोध के लिए दृश्यमान अंतिम उत्तरों का उपयोग करने हेतु messages.groupChat.visibleReplies: "automatic" सेट करें।

यदि सक्रिय टूल नीति के अंतर्गत संदेश टूल अनुपलब्ध है, तो OpenClaw प्रतिक्रिया को चुपचाप दबाने के बजाय स्वचालित दृश्यमान उत्तरों पर वापस चला जाता है। openclaw doctor इस असंगति के बारे में चेतावनी देता है।

यह नियम सामान्य एजेंट अंतिम टेक्स्ट पर लागू होता है। Plugin-स्वामित्व वाली वार्तालाप बाइंडिंग, दावा किए गए बाउंड-थ्रेड टर्न के लिए स्वामी Plugin द्वारा लौटाए गए उत्तर को दृश्यमान प्रतिक्रिया के रूप में उपयोग करती हैं; उन बाइंडिंग उत्तरों के लिए Plugin को message(action=send) कॉल करने की आवश्यकता नहीं है।

समस्या निवारण: समूह @mention से टाइपिंग शुरू होती है, फिर मौन रहता है (कोई त्रुटि नहीं)

लक्षण: किसी समूह/चैनल में @mention टाइपिंग संकेतक दिखाता है और Gateway लॉग dispatch complete (queuedFinal=false, replies=0) रिपोर्ट करता है, लेकिन रूम में कोई संदेश नहीं पहुँचता। उसी एजेंट को भेजे गए DM सामान्य रूप से उत्तर देते हैं।

कारण: समूह/चैनल दृश्यमान-उत्तर मोड "message_tool" पर रिज़ॉल्व होता है, इसलिए OpenClaw टर्न चलाता है लेकिन अंतिम सहायक टेक्स्ट को तब तक दबाता है जब तक एजेंट message(action=send) कॉल नहीं करता। इस मोड में कोई NO_REPLY अनुबंध नहीं है; संदेश-टूल कॉल न होने का अर्थ है कि मूल अंतिम टेक्स्ट निजी है। ठोस स्रोत टर्न के लिए OpenClaw अब एक संरक्षित पुनर्प्राप्ति पुनःप्रयास करता है; छोटे नोट, स्पष्ट मौन, रूम इवेंट, प्रेषण-नीति द्वारा अस्वीकृत टर्न और पहले ही डिलीवर किए जा चुके टर्न का पुनःप्रयास नहीं किया जाता। सामान्य समूह और चैनल टर्न डिफ़ॉल्ट रूप से "automatic" का उपयोग करते हैं, इसलिए यह लक्षण केवल तभी दिखाई देता है जब messages.groupChat.visibleReplies (या वैश्विक messages.visibleReplies) को स्पष्ट रूप से "message_tool" पर सेट किया गया हो। Harness defaultVisibleReplies यहाँ लागू नहीं होता — समूह/चैनल रिज़ॉल्वर इसे अनदेखा करता है; यह केवल प्रत्यक्ष/स्रोत चैट को प्रभावित करता है (Codex harness इसी तरह प्रत्यक्ष-चैट के अंतिम उत्तरों को दबाता है)।

समाधान: या तो अधिक सक्षम टूल-कॉलिंग मॉडल चुनें, "automatic" डिफ़ॉल्ट पर वापस जाने के लिए स्पष्ट "message_tool" ओवरराइड हटाएँ, या प्रत्येक समूह/चैनल अनुरोध के लिए दृश्यमान उत्तर बाध्य करने हेतु messages.groupChat.visibleReplies: "automatic" सेट करें। कोई ठोस अटकी हुई अंतिम प्रतिक्रिया अब मौन सफलता के रूप में समाप्त नहीं होनी चाहिए; उसे या तो एक message(action=send) पुनःप्रयास के माध्यम से पुनर्प्राप्त होना चाहिए या स्वच्छीकृत डिलीवरी-विफलता निदान दिखाना चाहिए। फ़ाइल सहेजे जाने के बाद Gateway messages कॉन्फ़िगरेशन को हॉट-रीलोड करता है; Gateway को केवल तभी पुनः आरंभ करें जब डिप्लॉयमेंट में फ़ाइल निगरानी या कॉन्फ़िगरेशन रीलोड अक्षम हो।

उल्लेख के प्रकार:

• मेटाडेटा उल्लेख: मूल प्लेटफ़ॉर्म @-उल्लेख। WhatsApp स्व-चैट मोड में अनदेखे किए जाते हैं।
• टेक्स्ट पैटर्न: agents.entries.*.groupChat.mentionPatterns में सुरक्षित रेगेक्स पैटर्न। अमान्य पैटर्न और असुरक्षित नेस्टेड पुनरावृत्ति अनदेखी की जाती हैं।
• उल्लेख गेटिंग केवल तभी लागू होती है जब पहचान संभव हो (मूल उल्लेख या कम-से-कम एक पैटर्न)।

{  messages: {    visibleReplies: "automatic", // प्रत्यक्ष/स्रोत चैट के लिए पुराने स्वचालित अंतिम उत्तर बाध्य करें    groupChat: {      historyLimit: 50,      unmentionedInbound: "room_event", // हमेशा चालू बिना-उल्लेख वाली रूम बातचीत शांत संदर्भ बन जाती है      visibleReplies: "message_tool", // ऑप्ट-इन; दृश्यमान रूम उत्तरों के लिए message(action=send) आवश्यक करें    },  },  agents: {    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],  },}

messages.groupChat.historyLimit वैश्विक डिफ़ॉल्ट सेट करता है। चैनल channels.<channel>.historyLimit (या प्रति-अकाउंट) से इसे ओवरराइड कर सकते हैं। अक्षम करने के लिए 0 सेट करें।

messages.groupChat.unmentionedInbound: "room_event" समर्थित चैनलों पर बिना-उल्लेख वाले हमेशा चालू समूह/चैनल संदेशों को शांत रूम संदर्भ के रूप में सबमिट करता है। उल्लेख वाले संदेश, कमांड और प्रत्यक्ष संदेश उपयोगकर्ता अनुरोध बने रहते हैं। संपूर्ण Discord, Slack और Telegram उदाहरणों के लिए परिवेशी रूम इवेंट देखें।

messages.visibleReplies वैश्विक स्रोत-इवेंट डिफ़ॉल्ट है; समूह/चैनल स्रोत इवेंट के लिए messages.groupChat.visibleReplies इसे ओवरराइड करता है। जब messages.visibleReplies सेट नहीं होता, तो प्रत्यक्ष/स्रोत चैट चुने गए रनटाइम या Harness डिफ़ॉल्ट का उपयोग करती हैं, लेकिन आंतरिक WebChat प्रत्यक्ष टर्न Pi/Codex प्रॉम्प्ट समानता के लिए स्वचालित अंतिम डिलीवरी का उपयोग करते हैं। दृश्यमान आउटपुट के लिए जानबूझकर message(action=send) आवश्यक करने हेतु messages.visibleReplies: "message_tool" सेट करें। चैनल अनुमति-सूचियाँ और उल्लेख गेटिंग अब भी तय करती हैं कि किसी इवेंट को प्रोसेस किया जाए या नहीं।

DM इतिहास सीमाएँ

{  channels: {    telegram: {      dmHistoryLimit: 30,      dms: {        "123456789": { historyLimit: 50 },      },    },  },}

रिज़ॉल्यूशन: प्रति-DM ओवरराइड → प्रदाता डिफ़ॉल्ट → कोई सीमा नहीं (सभी बनाए रखे जाते हैं)।

यह रिज़ॉल्वर ऐसे किसी भी चैनल के लिए channels.<provider>.dmHistoryLimit और channels.<provider>.dms.<id>.historyLimit पढ़ता है जिसकी सत्र कुंजी मानक provider:direct:<id> (या पुराने provider:dm:<id>) स्वरूप का पालन करती है, इसलिए यह केवल निश्चित सूची ही नहीं, बल्कि बंडल और Plugin चैनलों में समान रूप से काम करता है।

स्व-चैट मोड

स्व-चैट मोड सक्षम करने के लिए allowFrom में अपना नंबर शामिल करें (मूल @-उल्लेखों को अनदेखा करता है, केवल टेक्स्ट पैटर्न का उत्तर देता है):

{  channels: {    whatsapp: {      allowFrom: ["+15555550123"],      groups: { "*": { requireMention: true } },    },  },  agents: {    list: [      {        id: "main",        groupChat: { mentionPatterns: ["reisponde", "@openclaw"] },      },    ],  },}

कमांड (चैट कमांड प्रबंधन)

{  commands: {    native: "auto", // समर्थित होने पर मूल कमांड पंजीकृत करें    nativeSkills: "auto", // समर्थित होने पर मूल स्किल कमांड पंजीकृत करें    text: true, // चैट संदेशों में /commands पार्स करें    bash: false, // ! की अनुमति दें (उपनाम: /bash)    bashForegroundMs: 2000,    config: false, // /config की अनुमति दें    mcp: false, // /mcp की अनुमति दें    plugins: false, // /plugins की अनुमति दें    debug: false, // /debug की अनुमति दें    restart: true, // /restart + बाहरी SIGUSR1 पुनः आरंभ अनुरोधों की अनुमति दें    ownerAllowFrom: ["discord:123456789012345678"],    ownerDisplay: "raw", // raw | hash    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",    allowFrom: {      "*": ["user1"],      discord: ["user:123"],    },    useAccessGroups: true,  },}

संबंधित

• कॉन्फ़िगरेशन संदर्भ — शीर्ष-स्तरीय कुंजियाँ
• कॉन्फ़िगरेशन — एजेंट
• चैनल अवलोकन