Yuanbao

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

البدء السريع

يتطلب OpenClaw 2026.4.10 أو أعلى. شغّل openclaw --version للتحقق. قم بالترقية باستخدام openclaw update.

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

openclaw gateway restart

​

الإعداد التفاعلي (بديل)

openclaw channels login --channel yuanbao

​

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

​

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

• "pairing" - يتلقى المستخدمون غير المعروفين رمز إقران؛ وافق عليه عبر CLI
• "allowlist" - لا يمكن الدردشة إلا للمستخدمين المدرجين في allowFrom
• "open" - السماح لجميع المستخدمين (الافتراضي)
• "disabled" - تعطيل جميع الرسائل المباشرة

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

​

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

• 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,
        },
      },
    },
  },
}

​

حدود الرسائل

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

​

البث

{
  channels: {
    yuanbao: {
      disableBlockStreaming: false, // block streaming enabled (default)
    },
  },
}

​

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

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

​

وضع الرد على

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

​

حقن تلميح Markdown

{
  channels: {
    yuanbao: {
      markdownHintEnabled: true, // default: true
    },
  },
}

​

وضع التصحيح

{
  channels: {
    yuanbao: {
      debugBotIds: ["bot_user_id_1", "bot_user_id_2"],
    },
  },
}

​

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

{
  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: معرف المستخدم أو رمز المجموعة

​

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

​

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

​

الاستلام

• ✅ النص
• ✅ الصور
• ✅ الملفات
• ✅ الصوت / الصوتيات
• ✅ الفيديو
• ✅ الملصقات / الرموز التعبيرية المخصصة
• ✅ العناصر المخصصة (بطاقات الروابط، إلخ)

​

الإرسال

• ✅ النص (مع دعم markdown)
• ✅ الصور
• ✅ الملفات
• ✅ الصوت
• ✅ الفيديو
• ✅ الملصقات

​

السلاسل والردود

• ✅ الردود المقتبسة (قابلة للتكوين عبر replyToMode)
• ❌ ردود السلاسل (غير مدعومة من المنصة)

​

ذو صلة

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