الانتقال إلى المحتوى الرئيسي

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.

تثبيت القناة هو تحويل مكالمات لجلسة OpenClaw واحدة. يحافظ على سياق المحادثة نفسه، لكنه يغيّر المكان الذي ستُسلَّم إليه الردود المستقبلية لتلك الجلسة.

​
مثال

يمكن لأليس مراسلة OpenClaw على Telegram وDiscord: 
{
  session: {
    identityLinks: {
      alice: ["telegram:123", "discord:456"],
    },
  },
}
إذا أرسلت أليس هذا من Telegram: 
/dock_discord
يحافظ OpenClaw على سياق الجلسة الحالي ويغيّر مسار الرد:
قبل التثبيتبعد /dock_discord
تذهب الردود إلى Telegram 123تذهب الردود إلى Discord 456
لا يُعاد إنشاء الجلسة. يبقى سجل المحادثة مرتبطًا بالجلسة نفسها.

​
لماذا تستخدمه

استخدم التثبيت عندما تبدأ مهمة في تطبيق محادثة واحد لكن يجب أن تصل الردود التالية إلى مكان آخر. التدفق الشائع:
  1. ابدأ مهمة وكيل من Telegram.
  2. انتقل إلى Discord حيث تنسّق العمل.
  3. أرسل /dock_discord من جلسة Telegram.
  4. احتفظ بجلسة OpenClaw نفسها، لكن استقبل الردود المستقبلية في Discord.

​
الإعداد المطلوب

يتطلب التثبيت session.identityLinks. يجب أن يكون المرسل المصدر والنظير الهدف ضمن مجموعة الهوية نفسها: 
{
  session: {
    identityLinks: {
      alice: ["telegram:123", "discord:456", "slack:U123"],
    },
  },
}
القيم هي معرّفات نظراء مسبوقة بالقناة:
القيمةالمعنى
telegram:123معرّف مرسل Telegram 123
discord:456معرّف النظير المباشر في Discord 456
slack:U123معرّف مستخدم Slack U123
المفتاح القانوني (alice أعلاه) هو فقط اسم مجموعة الهوية المشتركة. تستخدم أوامر التثبيت القيم المسبوقة بالقناة لإثبات أن المرسل المصدر والنظير الهدف هما الشخص نفسه.

​
الأوامر

تُنشأ أوامر التثبيت من Plugins القنوات المحمّلة التي تدعم الأوامر الأصلية. الأوامر المضمّنة الحالية:
القناة الهدفالأمرالاسم البديل
Discord/dock-discord/dock_discord
Mattermost/dock-mattermost/dock_mattermost
Slack/dock-slack/dock_slack
Telegram/dock-telegram/dock_telegram
الأسماء البديلة بشرطة سفلية مفيدة على أسطح الأوامر الأصلية مثل Telegram.

​
ما الذي يتغير

يحدّث التثبيت حقول تسليم الجلسة النشطة:
حقل الجلسةمثال بعد /dock_discord
lastChanneldiscord
lastTo456
lastAccountIdحساب القناة الهدف، أو default
تُحفَظ هذه الحقول في مخزن الجلسات وتُستخدم لتسليم الردود اللاحقة لتلك الجلسة.

​
ما الذي لا يتغير

لا يقوم التثبيت بما يلي:
  • إنشاء حسابات قنوات
  • توصيل بوت Discord أو Telegram أو Slack أو Mattermost جديد
  • منح الوصول إلى مستخدم
  • تجاوز قوائم السماح للقنوات أو سياسات الرسائل المباشرة
  • نقل سجل المحادثة إلى جلسة أخرى
  • جعل مستخدمين غير مرتبطين يشاركون جلسة واحدة
إنه يغيّر فقط مسار التسليم للجلسة الحالية.

​
استكشاف الأخطاء وإصلاحها

يقول الأمر إن المرسل غير مرتبط. أضف كلًا من المرسل الحالي والنظير الهدف إلى مجموعة session.identityLinks نفسها. على سبيل المثال، إذا كان يجب تثبيت مرسل Telegram 123 إلى نظير Discord 456، فأدرج كلًا من telegram:123 وdiscord:456. يقول الأمر إنه لا توجد جلسة نشطة. ثبّت من جلسة محادثة مباشرة موجودة. يحتاج الأمر إلى إدخال جلسة نشط كي يتمكن من حفظ المسار الجديد. ما زالت الردود تذهب إلى القناة القديمة. تحقق من أن الأمر ردّ برسالة نجاح، وتأكد من أن معرّف النظير الهدف يطابق المعرّف الذي تستخدمه تلك القناة. يغيّر التثبيت مسار الجلسة النشطة فقط؛ قد تظل جلسة أخرى توجّه الردود إلى مكان آخر. أحتاج إلى التبديل مرة أخرى. أرسل الأمر المطابق للقناة الأصلية، مثل /dock_telegram أو /dock-telegram، من مرسل مرتبط.