يوانباو

Tencent Yuanbao هي منصة مساعد الذكاء الاصطناعي من Tencent. يربط Plugin ‏openclaw-plugin-yuanbao، الذي يديره المجتمع، روبوتات Yuanbao بـ OpenClaw عبر WebSocket للرسائل المباشرة ومحادثات المجموعات.

الحالة: جاهز للاستخدام في بيئة الإنتاج للرسائل المباشرة مع الروبوت ومحادثات المجموعات. WebSocket هو وضع الاتصال الوحيد المدعوم. يدير فريق Tencent Yuanbao هذا الـ Plugin بصفته إدخالًا خارجيًا في الكتالوج، وليس فريق OpenClaw الأساسي؛ وتأتي تفاصيل الإعدادات والسلوك أدناه (باستثناء التثبيت وواجهة 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

اتبع المطالبات لإدخال معرّف التطبيق والسر الخاص بالتطبيق.

التحكم في الوصول

الرسائل المباشرة

channels.yuanbao.dm.policy:

للموافقة على طلب إقران:

openclaw pairing list yuanbaoopenclaw pairing approve yuanbao <CODE>

محادثات المجموعات

channels.yuanbao.requireMention (القيمة الافتراضية true): يتطلب إشارة @ قبل أن يرد الروبوت في مجموعة. يُعامل الرد على رسالة الروبوت نفسه باعتباره إشارة ضمنية.

أمثلة الإعدادات

إعداد أساسي مع سياسة رسائل مباشرة مفتوحة:

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

تقييد الرسائل المباشرة على مستخدمين محددين:

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

تعطيل متطلب الإشارة @ في المجموعات:

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

ضبط تسليم الرسائل الصادرة:

{  channels: {    yuanbao: {      outboundQueueStrategy: "merge-text",      minChars: 2800, // التخزين المؤقت حتى بلوغ هذا العدد من المحارف      maxChars: 3000, // فرض التقسيم عند تجاوز هذا الحد      idleMs: 5000, // الإرسال التلقائي بعد مهلة الخمول (مللي ثانية)    },  },}

عيّن outboundQueueStrategy: "immediate" لإرسال كل جزء دون تخزين مؤقت.

الأوامر الشائعة

يدعم Yuanbao قوائم أوامر الشرطة المائلة الأصلية؛ وتُزامَن الأوامر تلقائيًا مع المنصة عند بدء تشغيل Gateway.

استكشاف الأخطاء وإصلاحها

لا يستجيب الروبوت في محادثات المجموعات:

1. تأكد من إضافة الروبوت إلى المجموعة
2. تأكد من الإشارة إلى الروبوت باستخدام @ (مطلوبة افتراضيًا)
3. تحقق من السجلات: openclaw logs --follow

لا يستقبل الروبوت الرسائل:

1. تأكد من إنشاء الروبوت والموافقة عليه في تطبيق Yuanbao
2. تأكد من إعداد appKey وappSecret بصورة صحيحة
3. تأكد من تشغيل Gateway: ‏openclaw gateway status
4. تحقق من السجلات: openclaw logs --follow

يرسل الروبوت ردودًا فارغة أو احتياطية:

1. تحقق مما إذا كان نموذج الذكاء الاصطناعي يُرجع محتوى صالحًا
2. الرد الاحتياطي الافتراضي: "暂时无法解答，你可以换个问题问问我哦"
3. خصّصه باستخدام channels.yuanbao.fallbackReply

تسرّب السر الخاص بالتطبيق:

1. أعد تعيين السر الخاص بالتطبيق في تطبيق Yuanbao
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,        },      },    },  },}

يتحكم defaultAccount في الحساب المستخدم عندما لا تحدد واجهات API الصادرة قيمة accountId.

حدود الرسائل

• maxChars: الحد الأقصى لعدد المحارف في الرسالة الواحدة (الافتراضي 3000)
• mediaMaxMb: حد رفع/تنزيل الوسائط (الافتراضي 20 ميغابايت)
• overflowPolicy: السلوك عندما تتجاوز الرسالة الحد، إما "split" (الافتراضي) أو "stop"

البث

يدعم Yuanbao إخراج البث على مستوى الكتل؛ يرسل الروبوت النص في أجزاء أثناء إنشائه.

{  channels: {    yuanbao: {      disableBlockStreaming: false, // بث الكتل مفعّل (افتراضيًا)    },  },}

عيّن disableBlockStreaming: true لإرسال الرد الكامل في رسالة واحدة.

سياق سجل محادثة المجموعة

{  channels: {    yuanbao: {      historyLimit: 100, // الافتراضي: 100، عيّن 0 للتعطيل    },  },}

يتحكم في عدد الرسائل السابقة المضمّنة في سياق الذكاء الاصطناعي لمحادثات المجموعات.

وضع الرد على

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

يُمكّن إخراج سجلات غير منقّح لمعرّفات الروبوتات المدرجة.

توجيه الوكلاء المتعددين

استخدم bindings لتوجيه الرسائل المباشرة أو مجموعات Yuanbao إلى وكلاء مختلفين:

{  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" (رسالة مباشرة) أو "group" (محادثة مجموعة)
• match.peer.id: معرّف المستخدم أو رمز المجموعة

مرجع الإعدادات

الإعدادات الكاملة: إعدادات Gateway

أنواع الرسائل المدعومة

الاستقبال: النصوص والصور والملفات والصوت/الرسائل الصوتية والفيديو والملصقات/الرموز التعبيرية المخصصة والعناصر المخصصة (بطاقات الروابط).

الإرسال: النصوص (Markdown) والصور والملفات والصوت والفيديو والملصقات.

سلاسل المحادثات والردود: الردود المقتبسة (قابلة للإعداد عبر replyToMode)؛ لا تدعم المنصة الردود ضمن سلاسل المحادثات.

ذو صلة

• نظرة عامة على القنوات - جميع القنوات المدعومة
• الإقران - مصادقة الرسائل المباشرة ومسار الإقران
• المجموعات - سلوك محادثات المجموعات والتحكم بشرط الإشارة
• توجيه القنوات - توجيه جلسات الرسائل
• الأمان - نموذج الوصول والتحصين