> ## 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.

# Yuanbao

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

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

***

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

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

<Steps>
  <Step title="أضف قناة Yuanbao باستخدام بيانات اعتمادك">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw channels add --channel yuanbao --token "appKey:appSecret"
    ```

    تستخدم قيمة `--token` صيغة `appKey:appSecret` مفصولة بنقطتين رأسيتين. يمكنك الحصول عليهما من تطبيق Yuanbao عبر إنشاء روبوت في إعدادات تطبيقك.
  </Step>

  <Step title="بعد اكتمال الإعداد، أعد تشغيل Gateway لتطبيق التغييرات">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw gateway restart
    ```
  </Step>
</Steps>

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

يمكنك أيضًا استخدام المعالج التفاعلي:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw channels login --channel yuanbao
```

اتبع المطالبات لإدخال App ID و App Secret.

***

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

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

اضبط `dmPolicy` للتحكم في من يمكنه إرسال رسائل مباشرة إلى الروبوت:

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

**الموافقة على طلب إقران:**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>
```

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

**متطلب الإشارة** (`channels.yuanbao.requireMention`):

* `true` - تتطلب @mention (الافتراضي)
* `false` - الرد دون @mention

تُعامل الإجابة على رسالة الروبوت في محادثة مجموعة كإشارة ضمنية.

***

## أمثلة الإعداد

### إعداد أساسي بسياسة رسائل مباشرة مفتوحة

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    yuanbao: {
      appKey: "your_app_key",
      appSecret: "your_app_secret",
      dm: {
        policy: "open",
      },
    },
  },
}
```

### تقييد الرسائل المباشرة على مستخدمين محددين

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    yuanbao: {
      appKey: "your_app_key",
      appSecret: "your_app_secret",
      dm: {
        policy: "allowlist",
        allowFrom: ["user_id_1", "user_id_2"],
      },
    },
  },
}
```

### تعطيل متطلب @mention في المجموعات

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    yuanbao: {
      requireMention: false,
    },
  },
}
```

### تحسين تسليم الرسائل الصادرة

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    yuanbao: {
      // Send each chunk immediately without buffering
      outboundQueueStrategy: "immediate",
    },
  },
}
```

### ضبط استراتيجية دمج النص

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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)
    },
  },
}
```

***

## الأوامر الشائعة

| الأمر      | الوصف                |
| ---------- | -------------------- |
| `/help`    | عرض الأوامر المتاحة  |
| `/status`  | عرض حالة الروبوت     |
| `/new`     | بدء جلسة جديدة       |
| `/stop`    | إيقاف التشغيل الحالي |
| `/restart` | إعادة تشغيل OpenClaw |
| `/compact` | ضغط سياق الجلسة      |

> يدعم 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`

***

## الإعداد المتقدم

### حسابات متعددة

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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 إخراج البث على مستوى الكتلة. عند تمكينه، يرسل الروبوت النص في أجزاء أثناء إنشائه.

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    yuanbao: {
      disableBlockStreaming: false, // block streaming enabled (default)
    },
  },
}
```

عيّن `disableBlockStreaming: true` لإرسال الرد الكامل في رسالة واحدة.

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

تحكم في عدد الرسائل التاريخية المضمنة في سياق الذكاء الاصطناعي لمحادثات المجموعات:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    yuanbao: {
      historyLimit: 100, // default: 100, set 0 to disable
    },
  },
}
```

### وضع الرد على

تحكم في كيفية اقتباس الروبوت للرسائل عند الرد في محادثات المجموعات:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    yuanbao: {
      replyToMode: "first", // "off" | "first" | "all" (default: "first")
    },
  },
}
```

| القيمة    | السلوك                                            |
| --------- | ------------------------------------------------- |
| `"off"`   | لا يوجد رد مقتبس                                  |
| `"first"` | اقتباس الرد الأول فقط لكل رسالة واردة (الافتراضي) |
| `"all"`   | اقتباس كل رد                                      |

### حقن تلميح Markdown

افتراضيًا، يحقن الروبوت تعليمات في موجه النظام لمنع نموذج الذكاء الاصطناعي من تغليف الرد بالكامل في كتل كود markdown.

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    yuanbao: {
      markdownHintEnabled: true, // default: true
    },
  },
}
```

### وضع التصحيح

فعّل إخراج السجلات غير المنقح لمعرفات روبوت محددة:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    yuanbao: {
      debugBotIds: ["bot_user_id_1", "bot_user_id_2"],
    },
  },
}
```

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

استخدم `bindings` لتوجيه الرسائل المباشرة أو المجموعات في Yuanbao إلى وكلاء مختلفين.

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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](/ar/gateway/configuration)

| الإعداد                                    | الوصف                                                    | الافتراضي            |
| ------------------------------------------ | -------------------------------------------------------- | -------------------- |
| `channels.yuanbao.enabled`                 | تمكين/تعطيل القناة                                       | `true`               |
| `channels.yuanbao.defaultAccount`          | الحساب الافتراضي للتوجيه الصادر                          | `default`            |
| `channels.yuanbao.accounts.<id>.appKey`    | App Key (يُستخدم للتوقيع وإنشاء التذكرة)                 | -                    |
| `channels.yuanbao.accounts.<id>.appSecret` | App Secret (يُستخدم للتوقيع)                             | -                    |
| `channels.yuanbao.accounts.<id>.token`     | رمز موقّع مسبقًا (يتجاوز توقيع التذكرة تلقائيًا)         | -                    |
| `channels.yuanbao.accounts.<id>.name`      | اسم عرض الحساب                                           | -                    |
| `channels.yuanbao.accounts.<id>.enabled`   | تمكين/تعطيل حساب محدد                                    | `true`               |
| `channels.yuanbao.dm.policy`               | سياسة الرسائل المباشرة                                   | `open`               |
| `channels.yuanbao.dm.allowFrom`            | قائمة السماح للرسائل المباشرة (قائمة معرفات المستخدمين)  | -                    |
| `channels.yuanbao.requireMention`          | طلب @mention في المجموعات                                | `true`               |
| `channels.yuanbao.overflowPolicy`          | معالجة الرسائل الطويلة (`split` أو `stop`)               | `split`              |
| `channels.yuanbao.replyToMode`             | استراتيجية الرد على في المجموعات (`off`، `first`، `all`) | `first`              |
| `channels.yuanbao.outboundQueueStrategy`   | الاستراتيجية الصادرة (`merge-text` أو `immediate`)       | `merge-text`         |
| `channels.yuanbao.minChars`                | دمج النص: الحد الأدنى للأحرف لتشغيل الإرسال              | `2800`               |
| `channels.yuanbao.maxChars`                | دمج النص: الحد الأقصى للأحرف لكل رسالة                   | `3000`               |
| `channels.yuanbao.idleMs`                  | دمج النص: مهلة الخمول قبل التفريغ التلقائي (مللي ثانية)  | `5000`               |
| `channels.yuanbao.mediaMaxMb`              | حد حجم الوسائط (ميغابايت)                                | `20`                 |
| `channels.yuanbao.historyLimit`            | إدخالات سياق سجل محادثة المجموعة                         | `100`                |
| `channels.yuanbao.disableBlockStreaming`   | تعطيل إخراج البث على مستوى الكتلة                        | `false`              |
| `channels.yuanbao.fallbackReply`           | رد احتياطي عندما لا يعيد الذكاء الاصطناعي أي محتوى       | `暂时无法解答，你可以换个问题问问我哦` |
| `channels.yuanbao.markdownHintEnabled`     | حقن تعليمات منع تغليف markdown                           | `true`               |
| `channels.yuanbao.debugBotIds`             | معرفات الروبوت في قائمة السماح للتصحيح (سجلات غير منقحة) | `[]`                 |

***

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

### الاستلام

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

### الإرسال

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

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

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

***

## ذو صلة

* [نظرة عامة على القنوات](/ar/channels) - كل القنوات المدعومة
* [الإقران](/ar/channels/pairing) - مصادقة الرسائل المباشرة وتدفق الإقران
* [المجموعات](/ar/channels/groups) - سلوك محادثة المجموعة وبوابة الإشارة
* [توجيه القنوات](/ar/channels/channel-routing) - توجيه الجلسات للرسائل
* [الأمان](/ar/gateway/security) - نموذج الوصول والتحصين