Yuanbao

Tencent Yuanbao پلتفرم دستیار هوش مصنوعی Tencent است. Plugin کانال OpenClaw ربات‌های Yuanbao را از طریق وب‌سوکت به 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 خود، فرمان‌ها را دنبال کنید.

# کنترل دسترسی

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

برای کنترل اینکه چه کسی می‌تواند به ربات پیام مستقیم بدهد، dmPolicy را پیکربندی کنید:

• "pairing" - کاربران ناشناخته یک کد جفت‌سازی دریافت می‌کنند؛ از طریق CLI تأیید کنید
• "allowlist" - فقط کاربرانی که در allowFrom فهرست شده‌اند می‌توانند گفت‌وگو کنند
• "open" - اجازه به همهٔ کاربران (پیش‌فرض)
• "disabled" - غیرفعال کردن همهٔ پیام‌های مستقیم

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

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

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

الزام منشن (channels.yuanbao.requireMention):

• true - نیاز به @mention دارد (پیش‌فرض)
• false - بدون @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: {
      // Send each chunk immediately without buffering
      outboundQueueStrategy: "immediate",
    },
  },
}

# تنظیم راهبرد ادغام متن

{
  channels: {
    yuanbao: {
      outboundQueueStrategy: "merge-text",
      minChars: 2800, // buffer until this many chars
      maxChars: 3000, // force split above this limit
      idleMs: 5000, // auto-flush after idle timeout (ms)
    },
  },
}

# فرمان‌های رایج

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 APP بازنشانی کنید
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, // block streaming enabled (default)
    },
  },
}

برای ارسال پاسخ کامل در یک پیام، disableBlockStreaming: true را تنظیم کنید.

# زمینهٔ تاریخچهٔ گفت‌وگوی گروهی

کنترل کنید چند پیام تاریخی در زمینهٔ هوش مصنوعی برای گفت‌وگوهای گروهی گنجانده شود:

{
  channels: {
    yuanbao: {
      historyLimit: 100, // default: 100, set 0 to disable
    },
  },
}

# حالت پاسخ به پیام

کنترل کنید ربات هنگام پاسخ دادن در گفت‌وگوهای گروهی چگونه پیام‌ها را نقل‌قول کند:

{
  channels: {
    yuanbao: {
      replyToMode: "first", // "off" | "first" | "all" (default: "first")
    },
  },
}

# تزریق راهنمای Markdown

به‌طور پیش‌فرض، ربات دستورالعمل‌هایی را در پرامپت سیستم تزریق می‌کند تا از پیچیده شدن کل پاسخ مدل هوش مصنوعی در بلوک‌های کد markdown جلوگیری کند.

{
  channels: {
    yuanbao: {
      markdownHintEnabled: true, // default: 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)
• ❌ پاسخ‌های رشته‌ای (توسط پلتفرم پشتیبانی نمی‌شود)

# مرتبط

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