Yuanbao

Tencent Yuanbao, Tencent का AI सहायक प्लेटफ़ॉर्म है। समुदाय द्वारा अनुरक्षित openclaw-plugin-yuanbao Plugin, डायरेक्ट मैसेज और समूह चैट के लिए Yuanbao बॉट को WebSocket के माध्यम से OpenClaw से जोड़ता है। स्थिति: बॉट DM और समूह चैट के लिए प्रोडक्शन हेतु तैयार। WebSocket ही एकमात्र समर्थित कनेक्शन मोड है। इस Plugin को मूल OpenClaw द्वारा नहीं, बल्कि Tencent Yuanbao टीम द्वारा बाहरी कैटलॉग प्रविष्टि के रूप में अनुरक्षित किया जाता है; नीचे दिए गए कॉन्फ़िगरेशन/व्यवहार संबंधी विवरण (इंस्टॉलेशन और सामान्य CLI सतह के अतिरिक्त) Plugin के अपने दस्तावेज़ों से लिए गए हैं और OpenClaw के मूल स्रोत के विरुद्ध सत्यापित नहीं किए गए हैं।

त्वरित शुरुआत

OpenClaw 2026.4.10 या उसके बाद का संस्करण आवश्यक है। openclaw --version से जाँचें; openclaw update से अपग्रेड करें।

अपने क्रेडेंशियल के साथ Yuanbao चैनल जोड़ें

openclaw channels add --channel yuanbao --token "appKey:appSecret"

--token में कोलन से अलग किए गए appKey:appSecret का उपयोग होता है। अपनी एप्लिकेशन सेटिंग में बॉट बनाकर इन्हें Yuanbao ऐप से प्राप्त करें।

परिवर्तन लागू करने के लिए Gateway पुनः आरंभ करें

openclaw gateway restart

इंटरैक्टिव सेटअप (वैकल्पिक)

openclaw channels login --channel yuanbao

अपना App ID और App Secret दर्ज करने के लिए संकेतों का पालन करें।

अभिगम नियंत्रण

डायरेक्ट मैसेज

channels.yuanbao.dm.policy:

मान	व्यवहार
`open` (डिफ़ॉल्ट)	सभी उपयोगकर्ताओं को अनुमति दें
`pairing`	अज्ञात उपयोगकर्ताओं को पेयरिंग कोड मिलता है; CLI के माध्यम से स्वीकृत करें
`allowlist`	केवल `allowFrom` में शामिल उपयोगकर्ता चैट कर सकते हैं
`disabled`	सभी DM अक्षम करें

पेयरिंग अनुरोध स्वीकृत करें:

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

समूह चैट

channels.yuanbao.requireMention (डिफ़ॉल्ट true): समूह में बॉट के उत्तर देने से पहले @mention आवश्यक है। बॉट के अपने संदेश का उत्तर देना अप्रत्यक्ष उल्लेख माना जाता है।

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

मूल सेटअप, खुली DM नीति:

{
  channels: {
    yuanbao: {
      appKey: "your_app_key",
      appSecret: "your_app_secret",
      dm: {
        policy: "open",
      },
    },
  },
}

DM को विशिष्ट उपयोगकर्ताओं तक सीमित करें:

{
  channels: {
    yuanbao: {
      appKey: "your_app_key",
      appSecret: "your_app_secret",
      dm: {
        policy: "allowlist",
        allowFrom: ["user_id_1", "user_id_2"],
      },
    },
  },
}

समूहों में @mention की आवश्यकता अक्षम करें:

{
  channels: {
    yuanbao: {
      requireMention: false,
    },
  },
}

आउटबाउंड डिलीवरी समायोजन:

{
  channels: {
    yuanbao: {
      outboundQueueStrategy: "merge-text",
      minChars: 2800, // इतने वर्ण होने तक बफ़र करें
      maxChars: 3000, // इस सीमा से अधिक होने पर अनिवार्य रूप से विभाजित करें
      idleMs: 5000, // निष्क्रियता टाइमआउट (ms) के बाद स्वतः फ़्लश करें
    },
  },
}

प्रत्येक खंड को बफ़र किए बिना भेजने के लिए outboundQueueStrategy: "immediate" सेट करें।

सामान्य कमांड

कमांड	विवरण
`/help`	उपलब्ध कमांड दिखाएँ
`/status`	बॉट की स्थिति दिखाएँ
`/new`	नया सत्र शुरू करें
`/stop`	वर्तमान रन रोकें
`/restart`	OpenClaw पुनः आरंभ करें
`/compact`	सत्र संदर्भ को संक्षिप्त करें

Yuanbao मूल स्लैश-कमांड मेनू का समर्थन करता है; Gateway आरंभ होने पर कमांड स्वतः प्लेटफ़ॉर्म के साथ सिंक हो जाते हैं।

समस्या निवारण

समूह चैट में बॉट उत्तर नहीं देता:

पुष्टि करें कि बॉट समूह में जोड़ा गया है
पुष्टि करें कि आपने बॉट को @mention किया है (डिफ़ॉल्ट रूप से आवश्यक)
लॉग जाँचें: openclaw logs --follow

बॉट को संदेश प्राप्त नहीं होते:

पुष्टि करें कि बॉट Yuanbao ऐप में बनाया और स्वीकृत किया गया है
पुष्टि करें कि appKey और appSecret सही ढंग से कॉन्फ़िगर किए गए हैं
पुष्टि करें कि Gateway चल रहा है: openclaw gateway status
लॉग जाँचें: openclaw logs --follow

बॉट खाली या फ़ॉलबैक उत्तर भेजता है:

जाँचें कि AI मॉडल मान्य सामग्री लौटा रहा है या नहीं
डिफ़ॉल्ट फ़ॉलबैक उत्तर: “暂时无法解答，你可以换个问题问问我哦”
channels.yuanbao.fallbackReply से अनुकूलित करें

App Secret लीक हो गया:

Yuanbao ऐप में App Secret रीसेट करें
अपने कॉन्फ़िगरेशन में मान अपडेट करें
Gateway पुनः आरंभ करें: openclaw gateway restart

उन्नत कॉन्फ़िगरेशन

एकाधिक खाते

{
  channels: {
    yuanbao: {
      defaultAccount: "main",
      accounts: {
        main: {
          appKey: "key_xxx",
          appSecret: "secret_xxx",
          name: "Primary bot",
        },
        backup: {
          appKey: "key_yyy",
          appSecret: "secret_yyy",
          name: "Backup bot",
          enabled: false,
        },
      },
    },
  },
}

जब आउटबाउंड API में accountId निर्दिष्ट नहीं होता, तब defaultAccount नियंत्रित करता है कि किस खाते का उपयोग किया जाए।

संदेश सीमाएँ

maxChars: एक संदेश में वर्णों की अधिकतम संख्या (डिफ़ॉल्ट 3000)
mediaMaxMb: मीडिया अपलोड/डाउनलोड सीमा (डिफ़ॉल्ट 20 MB)
overflowPolicy: संदेश द्वारा सीमा पार किए जाने पर व्यवहार, "split" (डिफ़ॉल्ट) या "stop"

स्ट्रीमिंग

Yuanbao ब्लॉक-स्तरीय स्ट्रीमिंग आउटपुट का समर्थन करता है; बॉट टेक्स्ट उत्पन्न करते समय उसे खंडों में भेजता है।

{
  channels: {
    yuanbao: {
      disableBlockStreaming: false, // ब्लॉक स्ट्रीमिंग सक्षम है (डिफ़ॉल्ट)
    },
  },
}

पूरा उत्तर एक संदेश में भेजने के लिए disableBlockStreaming: true सेट करें।

समूह चैट इतिहास संदर्भ

{
  channels: {
    yuanbao: {
      historyLimit: 100, // डिफ़ॉल्ट: 100, अक्षम करने के लिए 0 सेट करें
    },
  },
}

यह नियंत्रित करता है कि समूह चैट के AI संदर्भ में कितने ऐतिहासिक संदेश शामिल किए जाएँ।

उत्तर-से मोड

{
  channels: {
    yuanbao: {
      replyToMode: "first", // "off" | "first" | "all" (डिफ़ॉल्ट: "first")
    },
  },
}

मान	व्यवहार
`off`	कोई उद्धृत उत्तर नहीं
`first`	प्रत्येक इनबाउंड संदेश के केवल पहले उत्तर को उद्धृत करें (डिफ़ॉल्ट)
`all`	प्रत्येक उत्तर को उद्धृत करें

Markdown संकेत अंतःक्षेपण

डिफ़ॉल्ट रूप से, बॉट मॉडल को पूरे उत्तर को markdown कोड ब्लॉक में लपेटने से रोकने के लिए सिस्टम-प्रॉम्प्ट निर्देश अंतःक्षेपित करता है।

{
  channels: {
    yuanbao: {
      markdownHintEnabled: true, // डिफ़ॉल्ट: true
    },
  },
}

डीबग मोड

{
  channels: {
    yuanbao: {
      debugBotIds: ["bot_user_id_1", "bot_user_id_2"],
    },
  },
}

सूचीबद्ध बॉट ID के लिए अस्वच्छीकृत लॉग आउटपुट सक्षम करता है।

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

Yuanbao DM या समूहों को अलग-अलग एजेंट तक रूट करने के लिए bindings का उपयोग करें:

{
  agents: {
    list: [
      { id: "main" },
      { id: "agent-a", workspace: "/home/user/agent-a" },
      { id: "agent-b", workspace: "/home/user/agent-b" },
    ],
  },
  bindings: [
    {
      agentId: "agent-a",
      match: {
        channel: "yuanbao",
        peer: { kind: "direct", id: "user_xxx" },
      },
    },
    {
      agentId: "agent-b",
      match: {
        channel: "yuanbao",
        peer: { kind: "group", id: "group_zzz" },
      },
    },
  ],
}

match.channel: "yuanbao"
match.peer.kind: "direct" (DM) या "group" (समूह चैट)
match.peer.id: उपयोगकर्ता ID या समूह कोड

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

पूर्ण कॉन्फ़िगरेशन: Gateway कॉन्फ़िगरेशन

सेटिंग	विवरण	डिफ़ॉल्ट
`channels.yuanbao.enabled`	चैनल सक्षम/अक्षम करें	`true`
`channels.yuanbao.defaultAccount`	आउटबाउंड रूटिंग का डिफ़ॉल्ट खाता	`default`
`channels.yuanbao.accounts.<id>.appKey`	App Key (हस्ताक्षर + टिकट निर्माण)	-
`channels.yuanbao.accounts.<id>.appSecret`	App Secret (हस्ताक्षर)	-
`channels.yuanbao.accounts.<id>.token`	पहले से हस्ताक्षरित टोकन (स्वचालित टिकट हस्ताक्षर छोड़ता है)	-
`channels.yuanbao.accounts.<id>.name`	खाते का प्रदर्शन नाम	-
`channels.yuanbao.accounts.<id>.enabled`	विशिष्ट खाता सक्षम/अक्षम करें	`true`
`channels.yuanbao.dm.policy`	DM नीति	`open`
`channels.yuanbao.dm.allowFrom`	DM अनुमति-सूची (उपयोगकर्ता ID सूची)	-
`channels.yuanbao.requireMention`	समूहों में @mention आवश्यक करें	`true`
`channels.yuanbao.overflowPolicy`	लंबे संदेश का प्रबंधन (`split` या `stop`)	`split`
`channels.yuanbao.replyToMode`	समूह उत्तर-से रणनीति (`off`, `first`, `all`)	`first`
`channels.yuanbao.outboundQueueStrategy`	आउटबाउंड रणनीति (`merge-text` या `immediate`)	`merge-text`
`channels.yuanbao.minChars`	मर्ज-टेक्स्ट: प्रेषण ट्रिगर करने के लिए न्यूनतम वर्ण	`2800`
`channels.yuanbao.maxChars`	मर्ज-टेक्स्ट: प्रति संदेश अधिकतम वर्ण	`3000`
`channels.yuanbao.idleMs`	मर्ज-टेक्स्ट: स्वतः फ़्लश से पहले निष्क्रियता टाइमआउट (ms)	`5000`
`channels.yuanbao.mediaMaxMb`	मीडिया आकार सीमा (MB)	`20`
`channels.yuanbao.historyLimit`	समूह चैट इतिहास संदर्भ प्रविष्टियाँ	`100`
`channels.yuanbao.disableBlockStreaming`	ब्लॉक-स्तरीय स्ट्रीमिंग आउटपुट अक्षम करें	`false`
`channels.yuanbao.fallbackReply`	मॉडल द्वारा कोई सामग्री न लौटाने पर फ़ॉलबैक उत्तर	`暂时无法解答，你可以换个问题问问我哦`
`channels.yuanbao.markdownHintEnabled`	markdown में लपेटने से रोकने वाले निर्देश अंतःक्षेपित करें	`true`
`channels.yuanbao.debugBotIds`	डीबग अनुमति-सूची के बॉट ID (अस्वच्छीकृत लॉग)	`[]`

समर्थित संदेश प्रकार

प्राप्त करें: टेक्स्ट, चित्र, फ़ाइलें, ऑडियो/वॉइस, वीडियो, स्टिकर/कस्टम इमोजी, कस्टम एलिमेंट (लिंक कार्ड)। भेजें: टेक्स्ट (markdown), चित्र, फ़ाइलें, ऑडियो, वीडियो, स्टिकर। थ्रेड और उत्तर: उद्धृत उत्तर (replyToMode के माध्यम से कॉन्फ़िगर करने योग्य); प्लेटफ़ॉर्म थ्रेड उत्तरों का समर्थन नहीं करता।

Overview

Mainstream messaging

Developer and self-hosted

Regional platforms

Configuration

त्वरित शुरुआत

इंटरैक्टिव सेटअप (वैकल्पिक)

अभिगम नियंत्रण

डायरेक्ट मैसेज

समूह चैट

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

सामान्य कमांड

समस्या निवारण

उन्नत कॉन्फ़िगरेशन

एकाधिक खाते

संदेश सीमाएँ

स्ट्रीमिंग

समूह चैट इतिहास संदर्भ

उत्तर-से मोड

Markdown संकेत अंतःक्षेपण

डीबग मोड

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

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

समर्थित संदेश प्रकार

संबंधित

​त्वरित शुरुआत

​इंटरैक्टिव सेटअप (वैकल्पिक)

​अभिगम नियंत्रण

​डायरेक्ट मैसेज

​समूह चैट

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

​सामान्य कमांड

​समस्या निवारण

​उन्नत कॉन्फ़िगरेशन

​एकाधिक खाते

​संदेश सीमाएँ

​स्ट्रीमिंग

​समूह चैट इतिहास संदर्भ

​उत्तर-से मोड

​Markdown संकेत अंतःक्षेपण

​डीबग मोड

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

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

​समर्थित संदेश प्रकार

​संबंधित

त्वरित शुरुआत

इंटरैक्टिव सेटअप (वैकल्पिक)

अभिगम नियंत्रण

डायरेक्ट मैसेज

समूह चैट

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

सामान्य कमांड

समस्या निवारण

उन्नत कॉन्फ़िगरेशन

एकाधिक खाते

संदेश सीमाएँ

स्ट्रीमिंग

समूह चैट इतिहास संदर्भ

उत्तर-से मोड

Markdown संकेत अंतःक्षेपण

डीबग मोड

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

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

समर्थित संदेश प्रकार

संबंधित