Yuanbao

Tencent Yuanbao پلتفرم دستیار هوش مصنوعی Tencent است. Plugin نگه‌داری‌شده توسط جامعه، openclaw-plugin-yuanbao، ربات‌های Yuanbao را از طریق WebSocket برای پیام‌های مستقیم و گفت‌وگوهای گروهی به OpenClaw متصل می‌کند.

وضعیت: آماده استفاده در محیط عملیاتی برای پیام‌های مستقیم ربات و گفت‌وگوهای گروهی. WebSocket تنها حالت اتصال پشتیبانی‌شده است. این Plugin را تیم Tencent Yuanbao به‌عنوان یک ورودی کاتالوگ خارجی نگه‌داری می‌کند، نه هسته 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

برای وارد کردن App ID و App Secret، اعلان‌ها را دنبال کنید.

کنترل دسترسی

پیام‌های مستقیم

channels.yuanbao.dm.policy:

یک درخواست جفت‌سازی را تأیید کنید:

openclaw pairing list yuanbaoopenclaw pairing approve yuanbao <CODE>

گفت‌وگوهای گروهی

channels.yuanbao.requireMention (پیش‌فرض true): پیش از پاسخ‌دادن ربات در گروه، به @mention نیاز است. پاسخ‌دادن به پیام خود ربات، اشاره ضمنی تلقی می‌شود.

نمونه‌های پیکربندی

راه‌اندازی پایه، سیاست باز پیام مستقیم:

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

غیرفعال‌کردن الزام @mention در گروه‌ها:

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

تنظیم تحویل خروجی:

{  channels: {    yuanbao: {      outboundQueueStrategy: "merge-text",      minChars: 2800, // تا رسیدن به این تعداد نویسه در بافر نگه دارید      maxChars: 3000, // بالاتر از این حد، تقسیم را اجباری کنید      idleMs: 5000, // پس از پایان مهلت بی‌کاری، به‌طور خودکار تخلیه کنید (میلی‌ثانیه)    },  },}

برای ارسال هر قطعه بدون بافرکردن، 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. بررسی کنید آیا مدل هوش مصنوعی محتوای معتبری برمی‌گرداند
2. پاسخ جایگزین پیش‌فرض: "فعلاً نمی‌توانم پاسخ دهم؛ می‌توانید سؤال دیگری از من بپرسید"
3. با channels.yuanbao.fallbackReply سفارشی‌سازی کنید

App Secret افشا شده است:

1. App Secret را در برنامه Yuanbao بازنشانی کنید
2. مقدار را در پیکربندی خود به‌روزرسانی کنید
3. Gateway را دوباره راه‌اندازی کنید: openclaw gateway restart

پیکربندی پیشرفته

چند حساب

{  channels: {    yuanbao: {      defaultAccount: "main",      accounts: {        main: {          appKey: "key_xxx",          appSecret: "secret_xxx",          name: "ربات اصلی",        },        backup: {          appKey: "key_yyy",          appSecret: "secret_yyy",          name: "ربات پشتیبان",          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"],    },  },}

خروجی گزارش پالایش‌نشده را برای شناسه‌های ربات فهرست‌شده فعال می‌کند.

مسیریابی چندعاملی

برای مسیریابی پیام‌های مستقیم یا گروه‌های Yuanbao به عامل‌های مختلف، از 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" (پیام مستقیم) یا "group" (گفت‌وگوی گروهی)
• match.peer.id: شناسه کاربر یا کد گروه

مرجع پیکربندی

پیکربندی کامل: پیکربندی Gateway

انواع پیام پشتیبانی‌شده

دریافت: متن، تصویر، فایل، صدا/پیام صوتی، ویدئو، برچسب/ایموجی سفارشی، عناصر سفارشی (کارت‌های پیوند).

ارسال: متن (Markdown)، تصویر، فایل، صدا، ویدئو، برچسب.

رشته‌ها و پاسخ‌ها: پاسخ‌های نقل‌قولی (قابل پیکربندی از طریق replyToMode)؛ پاسخ‌های رشته‌ای توسط پلتفرم پشتیبانی نمی‌شوند.

مرتبط

• نمای کلی کانال‌ها - همه کانال‌های پشتیبانی‌شده
• جفت‌سازی - احراز هویت پیام مستقیم و جریان جفت‌سازی
• گروه‌ها - رفتار گفت‌وگوی گروهی و محدودسازی بر اساس اشاره
• مسیریابی کانال - مسیریابی نشست برای پیام‌ها
• امنیت - مدل دسترسی و مقاوم‌سازی