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 से अपग्रेड करें।

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

openclaw gateway restart

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

openclaw channels login --channel yuanbao

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

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

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

channels.yuanbao.dm.policy:

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

openclaw pairing list yuanbaoopenclaw 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" सेट करें।

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

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

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

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

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

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

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

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

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

App Secret लीक हो गया:

1. Yuanbao ऐप में App Secret रीसेट करें
2. अपने कॉन्फ़िगरेशन में मान अपडेट करें
3. 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")    },  },}

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 कॉन्फ़िगरेशन

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

प्राप्त करें: टेक्स्ट, चित्र, फ़ाइलें, ऑडियो/वॉइस, वीडियो, स्टिकर/कस्टम इमोजी, कस्टम एलिमेंट (लिंक कार्ड)।

भेजें: टेक्स्ट (markdown), चित्र, फ़ाइलें, ऑडियो, वीडियो, स्टिकर।

थ्रेड और उत्तर: उद्धृत उत्तर (replyToMode के माध्यम से कॉन्फ़िगर करने योग्य); प्लेटफ़ॉर्म थ्रेड उत्तरों का समर्थन नहीं करता।

संबंधित

• चैनलों का अवलोकन - सभी समर्थित चैनल
• पेयरिंग - DM प्रमाणीकरण और पेयरिंग प्रवाह
• समूह - समूह चैट का व्यवहार और उल्लेख गेटिंग
• चैनल रूटिंग - संदेशों के लिए सत्र रूटिंग
• सुरक्षा - अभिगम मॉडल और सुदृढ़ीकरण