Documentation Index

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

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

​

Yuanbao

​

البدء السريع

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

​

ذات صلة

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