Yuanbao

Tencent Yuanbao هي منصة مساعد الذكاء الاصطناعي من Tencent. يربط Plugin قناة OpenClaw روبوتات Yuanbao بـ OpenClaw عبر WebSocket حتى تتمكن من التفاعل مع المستخدمين من خلال الرسائل المباشرة ومحادثات المجموعات.

الحالة: جاهز للإنتاج للرسائل المباشرة للروبوت + محادثات المجموعات. WebSocket هو وضع الاتصال الوحيد المدعوم.

# البدء السريع

يتطلب 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 في الحساب المستخدم عندما لا تحدد واجهات برمجة التطبيقات الصادرة 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"],
    },
  },
}

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

استخدم 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)
• ❌ ردود السلاسل (غير مدعومة من المنصة)

# ذو صلة

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