Skip to content

ربط Feishu: الإضافة الرسمية، والمحادثات الجماعية، وأدوات المستندات ​

💡 خلاصة بسطر واحد: استخدم OpenClaw لإنشاء زميل ذكاء اصطناعي يعيش داخل Feishu — ربط عبر معالج الإضافة الرسمية، وردود بطاقات ببث مباشر في المحادثات الجماعية، وقراءة وكتابة مباشرة لمستندات Feishu والجداول متعددة الأبعاد.

الدرس الثاني في مسار العمل المكتبي. لقد اخترت هذا المسار في السيناريوهات التطبيقية. اعتمد درس WeCom السابق على إضافة خارجية من فريق Tencent WeCom، أما هذا الدرس فهو أكثر راحة — يعتمد ربط Feishu لـ OpenClaw على إضافة رسمية @openclaw/feishu (مدمجة في دليل القنوات الرسمي)، والمحادثات الخاصة + المحادثات الجماعية للروبوت جاهزة للإنتاج، والردود تُرسل كبطاقات ببث مباشر، وتأتي مع أدوات مستندات Feishu / wiki / Drive / Bitable. جميع الأمثلة مبنية على OpenClaw v2026.10.9.

ماذا ستستطيع أن تفعل بعد إتمام الدرس ​

  • تشغيل معالج openclaw channels login --channel feishu مرة واحدة، و15 دقيقة ليكون الروبوت على الإنترنت في Feishu (إنشاء تلقائي عبر مسح رمز الاستجابة السريعة، أو لصق App ID / App Secret يدويًا)
  • إشارته بـ @ في محادثات Feishu الفردية والجماعية، واستلام ردود كبطاقات ببث مباشر تتحدث أثناء التوليد
  • جعله ينشئ مستندات Feishu لكتابة محاضر الاجتماعات، ويسجّل المهام في جداول Bitable متعددة الأبعاد
  • استخدام القائمة البيضاء للمجموعات + القائمة البيضاء للمرسلين داخل المجموعة + شرط @الإشارة، للتحكم في من يستطيع الاستخدام وأي مجموعة يمكن الدخول إليها

لماذا تستخدم OpenClaw بدلًا من الذكاء الاصطناعي عبر الويب؟ ​

القدرةالذكاء الاصطناعي عبر الويبOpenClaw + إضافة Feishu الرسمية
مكان الظهور❌ فتح صفحة ويب منفصلة، لا يمكن استخدامه في المجموعات✅ موجود مباشرة في محادثات Feishu الفردية/الجماعية، تكفي إشارة @ واحدة
تجربة الردود❌ الانتظار حتى يكتمل توليد النص بالكامل قبل العرض✅ بطاقة تُحدَّث ببث مباشر، تشاهد أثناء التوليد
عمليات أعمال Feishu❌ لا يمكنه الوصول إلى المستندات/الجداول متعددة الأبعاد/قاعدة المعرفة✅ مجموعة أدوات doc / wiki / drive / Bitable مدمجة
تكلفة الربط❌ لا وجود لمفهوم الربط أصلًا✅ إضافة رسمية + معالج، وWebSocket لا يفتح الشبكة العامة افتراضيًا
البيانات والنماذج❌ المحادثات كلها بيد مزود الخدمة✅ يعمل Gateway على جهازك، ويمكن تبديل النماذج بحرية (بما فيها النماذج المحلية الصينية)

المأزق الذي أنت فيه الآن ​

  • الاحتياجات والاستنتاجات موزعة على عشرات المجموعات ومئات مستندات Feishu، وإذا سأل موظف جديد عن «الصياغة المعتمدة في المرة السابقة» فلا أحد يجيب إجابة كاملة
  • بعد الاجتماع لا أحد يرغب في تنظيم المحضر، والمهام تُنقل شفهيًا بالكامل، وبعد أسبوع لا أحد يتذكرها
  • تريد توفير مساعد ذكاء اصطناعي للمجموعة بأكملها، لكن البيانات الداخلية لا يمكن لصقها في نسخة الويب العامة

متى تستخدم هذه الطريقة ​

عندما تحتاج إلى:

  • مساعد ذكاء اصطناعي يعيش مباشرة داخل Feishu، يستخدمه الزملاء بإشارة @ في نافذة المحادثة دون تثبيت أدوات جديدة
  • أن يقوم بإنشاء المستندات وكتابة المحاضر وتسجيل الجداول متعددة الأبعاد والبحث في قاعدة المعرفة بسهولة
  • ربط دون فتح الشبكة العامة على الخادم (اتصال WebSocket الطويل هو الوضع الافتراضي)

ولا تريد:

  • التبديل إلى المتصفح في كل مرة للنسخ واللصق في نسخة الويب
  • كتابة خدمة استدعاءات أحداث Feishu من الصفر بنفسك
  • إسناد المحادثات الداخلية إلى خدمة استضافة تابعة لطرف ثالث

🎒 التحضيرات قبل البدء ​

  • إتمام السيناريوهات التطبيقية: اختر مسارك: يعمل Gateway، وتم ربط نموذج واحد على الأقل
  • يعرض openclaw --version 2026.5.29 أو أحدث (الحد الأدنى لإصدار قناة Feishu؛ وإصدار هذا الدرس المرجعي v2026.10.9 يفي بالمتطلب)
  • حساب يمكنه تسجيل الدخول إلى منصة Feishu المفتوحة وإنشاء تطبيق ذاتي البناء (بالنسبة للنسخة الدولية Lark المقابل هو Lark Developer)
  • كوب من الماء ☕ — بعد 15 دقيقة سيكون لديك زميل ذكاء اصطناعي جديد في Feishu

اتبعني خطوة بخطوة ​

الخطوة 1: شغّل معالج قناة Feishu لـ OpenClaw وثبّت الإضافة الرسمية (@openclaw/feishu) ​

لماذا: قناة Feishu توفّرها الإضافة الرسمية @openclaw/feishu، فلا حاجة لبنائها يدويًا في الإعدادات الخام — سيقوم المعالج بتثبيت الإضافة وتكوين بيانات الاعتماد تلقائيًا في خطوة واحدة.

shell
openclaw channels login --channel feishu

يمنحك المعالج خيارين:

  • الطريقة A: إنشاء الروبوت بمسح رمز الاستجابة السريعة — امسح رمز الاستجابة السريعة في تطبيق Feishu، ويُنشأ الروبوت تلقائيًا؛ هذا الطريق يقصر المحادثات الخاصة على استخدامك أنت فقط (dmPolicy: "allowlist" + open_id الخاص بك)، وهو الأسهل
  • الطريقة B: لصق بيانات الاعتماد يدويًا — اذهب أولًا إلى منصة Feishu المفتوحة وأنشئ تطبيقًا مخصصًا، ثم الصق App ID وApp Secret في المعالج

سيسألك المعالج عن أمرين أيضًا: نطاق API (Feishu المحلي feishu / النسخة الدولية Lark) واستراتيجية المجموعات.

ينبغي أن ترى: اكتمال المعالج وكتابة الإعدادات دون أي أخطاء.

💡 مسح رمز الاستجابة السريعة بتطبيق Feishu المحلي كثيرًا ما لا يستجيب

صفحة استكشاف الأخطاء الرسمية تدرجها كحالة معروفة: تطبيق Feishu المحلي على الهاتف لا يستجيب دائمًا لمسح رمز QR لإنشاء bot. إذا واجهت ذلك أعد تشغيل openclaw channels login --channel feishu واختر الوضع اليدوي، فالصق App ID / App Secret يعمل بنفس الطريقة.

  • المعالج يكتمل دون أخطاء

الخطوة 2: تحقق من أن قناة Feishu متصلة ​

لماذا: تغييرات الإعدادات تعمل عبر التحميل الساخن، لكن عليك التأكد من أن القناة جاهزة فعلًا قبل أن تذهب للتحدث مع الروبوت.

shell
openclaw channels status --probe

ينبغي أن ترى: قناة feishu تظهر جاهزة. إذا كان Gateway غير متصل فابدأ تشغيله أولًا ثم اكتشف مرة أخرى.

  • في openclaw channels status --probe تظهر feishu جاهزة

الخطوة 3: أرسل أول رسالة في محادثة خاصة، واعتمد رمز الاقتران ​

لماذا: الافتراضي dmPolicy: "pairing" — المستخدم غير المعروف في أول محادثة خاصة لن يتلقى سوى رمز اقتران، وبعد موافقتك في CLI يُسمح له. هذا هو الخط الدفاعي الأول لمنع الغرباء خارج الشركة من استخدام الروبوت مجانًا.

الإجراء: ابحث عن الروبوت في Feishu وأرسل له في محادثة خاصة عبارة «مرحبًا».

إذا كنت قد أنشأت الـ bot بلصق بيانات الاعتماد يدويًا، فستتلقى رمز اقتران في أول محادثة، عد إلى الطرفية لاعتماده:

shell
openclaw pairing list feishu
openclaw pairing approve feishu <配对码>

ينبغي أن ترى: الروبوت يبدأ بالرد، والرد داخل بطاقة يُحدَّث بالتدفق — يُحدَّث أثناء التوليد، وهي بطاقة التدفق من Feishu Card Kit (الافتراضي في streaming.mode هو partial). الـ bot المُنشأ بمسح رمز QR مقفل على محادثاتك الخاصة فقط ولن يُفعّل الاقتران.

💡 لا يوجد في Feishu قائمة أوامر بالشرطة المائلة

/status(عرض الحالة) و/reset(إعادة تعيين الجلسة) و/model(عرض/تغيير النموذج) و/followup <消息>(إضافة رسالة إلى الطابور) يجب إرسالها كلها كـنص عادي مباشرة. أوامر التحكم لا تدخل طابور الرسائل العادية — فيمكنك استخدام /status للاطلاع على التقدم حتى وهو منشغل بالعمل.

الخطوة 4: أضفه إلى المجموعة، واضبط القائمة البيضاء للمجموعات و@ للإشارة ​

لماذا: الافتراضي groupPolicy: "allowlist" (أي مجموعة غير مدرجة تُتجاهل) وفي المجموعات يجب @ الروبوت حتى يرد — احصل على المعرّف أولًا ثم أضف مجموعتك إلى القائمة البيضاء.

احصل أولًا على معرّفين:

  • معرّف المجموعة(chat_id، يبدأ بـ oc_): افتح المجموعة → قائمة الزاوية العلوية اليمنى → الإعدادات، ستجده مكتوبًا في صفحة الإعدادات
  • open_id الخاص بالمستخدم(يبدأ بـ ou_): أرسل للروبوت رسالة خاصة، وابحث عن open_id في openclaw logs --follow؛ أو راجع openclaw pairing list feishu

اسمح لمجموعتك في openclaw.json (مثال: السماح لمجموعتين، إحداهما معفاة من @):

json
{
  "channels": {
    "feishu": {
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["oc_xxx", "oc_yyy"],
      "groups": {
        "oc_xxx": { "requireMention": false }
      }
    }
  }
}

بعد التعديل انتظر حتى يسري التحميل الساخن (لا حاجة لإعادة تشغيل Gateway)، ثم أضف الروبوت إلى المجموعة وقل شيئًا.

ينبغي أن ترى: الرسائل في مجموعات القائمة البيضاء تحظى برد؛ المجموعات ذات requireMention: false ترد حتى دون @؛ والكلام في المجموعات غير المدرجة يذهب أدراج الرياح.

ثلاث طبقات من التحكم، كل واحدة تدير جزءًا:

الطبقةالحقلماذا يدير
المجموعةgroupAllowFrom / groups.<群ID>أي المجموعات يمكن الدخول إليها
الإشارةrequireMentionهل يلزم @ في المجموعة (افتراضيًا يلزم؛ وعند groupPolicy: "open" يكون الإعفاء افتراضيًا)
الأشخاصgroups.<群ID>.allowFromأي الأعضاء يُعتد بكلامهم في المجموعة (يمكن ضبط groupSenderAllowFrom عالميًا بشكل موحد)

⚠️ @ للجميع لا يُعتبر @ للروبوت

الإشارات البثية مثل @all / @_all لا تُعد إشارة إلى الروبوت؛ لتشغيل الرد يجب @ له هو مباشرة.

الخطوة 5: اجعله يعمل على مستندات Feishu وBitable ​

لماذا: هذا هو الجزء الأثمن في قناة Feishu — الإضافات تأتي مع مجموعة كاملة من أدوات عمل Feishu، مفعّلة افتراضيًا، وعليك فقط أن تطلب.

الإجراء: قل له «أنشئ مستند Feishu بعنوان «محضر الاجتماع الأسبوعي لشهر 11»».

ينبغي أن ترى: أنه ينشئ المستند ويرسل الرابط في المحادثة.

ضع في ذهنك سلوك أداتين:

  • feishu_doc إنشاء المستند بالعنوان فقط — أما المحتوى فيجب أن يطلبه كتابته مرة أخرى باستخدام document_id الذي أعاده. لذا قل مباشرة «أنشئ مستندًا واكتب فيه المحتوى التالي» واتركه يقسمها إلى خطوتين بنفسه، ولا تكتفِ بقول «أنشئ مستندًا»
  • يعترف Bitable بـ application token الموجود في روابط /base/ (أو بالـ app_token الذي يعيده)، ولا يعترف بـ node token في روابط /wiki/ — لذا عند إعطائه جدولًا متعدد الأبعاد الصق رابط /base/ فهو الأكثر أمانًا

مفاتيح مجموعات الأدوات (كلها تحت channels.feishu.tools.*):

مجموعة الأدواتماذا تفعلالافتراضي
tools.docقراءة وكتابة مستندات Feishu✅ مفعّل
tools.wikiقاعدة المعرفة (تعتمد على doc)✅ مفعّل
tools.driveالسحابة (Drive)✅ مفعّل
tools.bitableالجداول متعددة الأبعاد✅ مفعّل
tools.chatاستعلام معلومات المجموعات/الأعضاء✅ مفعّل
tools.scopesتشخيص نطاقات صلاحيات التطبيق✅ مفعّل
tools.permإدارة الصلاحيات⚠️ معطّل (حساس، فعّله عند الحاجة)

💡 هذه هي القيمة الفريدة لـ OpenClaw

نسخة الويب من الذكاء الاصطناعي لا تستطيع حتى الدخول إلى Feishu الخاص بك؛ أما هذا الـ Claw فيحمل أصالةً أدوات المستندات وقاعدة المعرفة والسحابة والجداول متعددة الأبعاد — مهام مثل «اكتب المهام التي ناقشناها للتو في الجدول متعدد الأبعاد» تصبح مسألة جملة واحدة، دون تصدير أو استيراد منك.

الخطوة 6: قبل الإطلاق شدّد المحادثات الخاصة أيضًا ​

لماذا: التطبيق المُنشأ يدويًا افتراضه dmPolicy: "pairing" (اعتماد رموز الاقتران واحدًا واحدًا)، وللاستخدام داخل الفريق يمكن التحويل إلى القائمة البيضاء لسهولة أكبر؛ الـ bot المُنشأ بمسح رمز QR مقفل تلقائيًا عليك فقط، ويمكن تخطي هذه الخطوة.

json
{
  "channels": {
    "feishu": {
      "dmPolicy": "allowlist",
      "allowFrom": ["ou_user1", "ou_user2"]
    }
  }
}

ينبغي أن ترى: المستخدمون خارج القائمة البيضاء لا يحصلون على أي رد في المحادثات الخاصة. للنظام الكامل لضبط الوصول والتحصين الأمني راجع التحصين الأمني (1): ضبط الوصول والهوية.

📋 Prompt السحري ​

الـ Prompt التالية الصقها مباشرة في نافذة محادثة Feishu وأرسلها للروبوت. كلها تستخدم مجموعات أدوات Feishu التي فُتحت في الخطوة 5.

📝 تحويل محضر الاجتماع إلى مستند بنقرة واحدة ​

النتيجة المتوقعة: يستدعي الروبوت أداة feishu_doc، فينشئ أولًا مستندًا بعنوان ثم يكتب النص فيه، ويعيد رابط المستند إلى المجموعة.

## الدور
أنت سكرتير اجتماعات، بارع في تحويل المناقشات الطويلة إلى محاضر قابلة للتنفيذ.
## المهمة
نظّم محضر الاجتماع التالي: أنشئ أولًا في Feishu مستندًا بعنوان 【عنوان المستند】، ثم اكتب نص المحضر في هذا المستند، وأخيرًا أرسل رابط المستند إلى هذه المجموعة.
## معلومات الإدخال
### الحقول المطلوبة
- عنوان المستند:【اسم الاجتماع + التاريخ】
- سجل الاجتماع:【الصق نص التفريغ أو ملاحظاتك العفوية】
### حقول اختيارية
- المواضيع الرئيسية:【المواضيع التي تحتاج إلى تفصيل؟】
## مواصفات الإخراج
يُقسَّم المحضر إلى ثلاثة أقسام: «القرارات / المهام / المسائل المعلقة»؛ وتُعرض المهام في جدول: البند | المسؤول | الموعد النهائي. في المجموعة يُرد فقط برابط المستند وملخص من سطر واحد.
## القيود
- ✅ كل مهمة تُسند إلى شخص محدد
- ✅ المهام التي لم يُحدَّد لها مسؤول تُدرج على حدة بانتظار التطوع
- ❌ لا تُغرَق المجموعة بالنص الكامل للمحضر

📋 تسجيل المهام المناقشة في المجموعة إلى Bitable ​

النتيجة المتوقعة: يستدعي الروبوت أداة feishu_bitable_*، فيكتب المهام الواردة في محادثة المجموعة بندًا بندًا في الجدول متعدد الأبعاد.

## الدور
أنت مساعد مشروع، مسؤول عن تحويل خلاصات محادثة المجموعة إلى سجلات قابلة للتتبع.
## المهمة
اكتب كل المهام التي ظهرت في نقاشات هذه المجموعة اليوم، بندًا بندًا، في الجدول متعدد الأبعاد 【الصق رابط الجدول الذي يبدأ بـ /base/】.
## معلومات الإدخال
### الحقول المطلوبة
- الجدول المستهدف:【رابط جدول متعدد الأبعاد يبدأ بـ /base/】
### حقول اختيارية
- القيمة الافتراضية للموعد النهائي:【ما اليوم الذي تُملأ به المهام التي بلا موعد صريح؟】
## مواصفات الإخراج
كل مهمة في سطر: البند | المسؤول | الموعد النهائي. بعد الانتهاء من الكتابة كلها، أرسل في المجموعة ملخصًا من سطر: كم العدد ومَن عُيِّن لكل منها.
## القيود
- ✅ سجِّل فقط المهام التي ظهرت فعلًا في المجموعة
- ❌ لا تختلق مهام من عندك
- ❌ إذا لم يكن رابط الجدول يبدأ بـ /base/ فاسألني أولًا، ولا تكتبه قسرًا

📚 الإجابة من قاعدة المعرفة مع ذكر المصدر ​

النتيجة المتوقعة: يجيب الروبوت بعد البحث في قاعدة المعرفة بأداة feishu_wiki، مع إرفاق روابط العقد المرجعية.

## الدور
أنت أمين معرفة الفريق، ولا بد أن تذكر المصدر عند الإجابة.
## المهمة
ابحث في قاعدة معرفة Feishu عن المواد المتعلقة بـ【موضوع السؤال】، وأجب عن سؤالي، وأرفق روابط عقد قاعدة المعرفة التي رجعت إليها.
## معلومات الإدخال
### الحقول المطلوبة
- السؤال:【سؤالك】
### حقول اختيارية
- تحديد النطاق:【أأبحث في مساحة أو عقدة معينة فقط؟】
## مواصفات الإخراج
قدّم أولًا إجابة من سطر واحد، ثم ما لا يزيد عن 3 من الأدلة، مع رابط قاعدة معرفة لكل دليل.
## القيود
- ✅ إذا لم تجد فقل ذلك صراحة، وأدرج المواضع التي بحثت فيها
- ❌ لا تختلق إجابة من عدم

نقاط التحقق ✅ ​

  • openclaw channels status --probe يُظهر أن قناة feishu جاهزة
  • أرسل رسالة في محادثة خاصة، ويأتي الرد داخل بطاقة يتحدث تحديثها تدفقيًا
  • في المجموعة يرد الروبوت عند مناداته بـ @؛ ومجموعات requireMention: false يرد فيها حتى دون @
  • اطلب منه إنشاء مستند Feishu، فيكون الرابط قابلًا للفتح والعنوان صحيحًا
  • ضُبِط كلٌّ من dmPolicy و groupPolicy وفق احتياجك (أو قررت صراحة الإبقاء على الافتراضي)

تنبيهات للمزالق ​

❌ دخل الروبوت المجموعة لكنه لا يستجيب للكلام ​

السبب: في المجموعات يُشترط افتراضيًا مناداة الروبوت بـ @؛ أو أن المجموعة ليست في القائمة البيضاء (الافتراضي لـ groupPolicy هو allowlist)، أو أنها ضُبطت على disabled.

الحل الصحيح: وفق الخطوة 4 أضف معرّف المجموعة (يبدأ بـ oc_) إلى groupAllowFrom، ونادِه بـ @ عند الكلام؛ وإن لم ينجح فاستخدم openclaw logs --follow للاطلاع على السجلات.

❌ المحادثة الخاصة أيضًا لا تستجيب، ولا تصل أي رسالة ​

السبب: الإعداد في منصة Feishu المفتوحة غير مكتمل — التطبيق لم يُنشر أو يُعتمد، أو نقص اشتراك الأحداث im.message.receive_v1، أو لم يُختر في استقبال الأحداث وضعالاتصال الطويل (WebSocket)، أو أن أذونات scope غير مكتملة.

الحل الصحيح: راجع البنود واحدًا واحدًا: التطبيق منشور ومعتمد → اشتراك الأحداث يتضمن im.message.receive_v1 → وضع الاستقبال هو الاتصال الطويل → استكمل الـ scope المطلوبة → openclaw gateway status للتأكد من أن Gateway يعمل.

❌ إنشاء الروبوت بمسح رمز QR في تطبيق Feishu الصيني لا يستجيب ​

السبب: تطبيق Feishu الصيني على الهاتف لا يستجيب دائمًا لعملية مسح الرمز (حالة معروفة في صفحة استكشاف الأخطاء الرسمية).

الحل الصحيح: أعد تشغيل openclaw channels login --channel feishu واختر الوضع اليدوي — أنشئ تطبيقًا ذاتي البناء في المنصة المفتوحة، وانسخ App ID / App Secret والصقهما في المعالج.

❌ سرَّب App Secret ​

الحل الصحيح: فورًا أعد تعيين Secret في منصة Feishu المفتوحة → حدِّث القيمة في الإعدادات → openclaw channels status --probe للتأكد من أن الإعادة التحميل الساخنة سارية. الإعدادات تُحمَّل ساخنة، فلا حاجة لإعادة تشغيل Gateway.

تقنيات متقدمة (اختياري) ​

تعدد الحسابات: Gateway واحد يحمل عدة روبوتات Feishu ​

ضُبْط عدة بوتات في accounts (مثل main / backup)، وحدِّد defaultAccount الحساب الافتراضي للإرسال الصادر. الحقول على مستوى الحساب تتخطى الحقول العليا، وTTS يدعم أيضًا الدمج العميق حسب الحساب — مشاركة واحدة لبيانات اعتماد الصوت، ونغمة صوت مختلفة لكل بوت.

دقة جلسات المجموعات وسلاسل المواضيع ​

يتحكم groupSessionScope في كيفية ربط رسائل المجموعة بالجلسات: group (الافتراضي، جلسة واحدة لكل مجموعة)، group_sender (تقسيم حسب الشخص)، group_topic (تقسيم حسب الموضوع)، group_topic_sender (موضوع + شخص). إذا أردت أن يفتح رد الروبوت تلقائيًا سلسلة موضوع، فاضبط replyInThread: "enabled".

Agent ديناميكي: عزل المستخدمين في الروبوت العام ​

عند فتح الروبوت للعموم (dmPolicy: "open" + allowFrom: ["*"])، فعِّل dynamicAgentCreation.enabled: true — يُنشأ لكل مستخدم في المحادثة الخاصة agent مستقل تلقائيًا (بمعرّف مثل feishu-<open_id>)، مع عزل كامل لمساحة العمل والذاكرة وسجل الجلسات. انتبه لأمرين: هذا عزل لسياق الرسائل وليس حدًا أمنيًا ضد الاستئجار الخبيث المشترك؛ ويتطلب بقاء configWrites مفعّلًا (مفعّل افتراضيًا).

الرد بحزم الملصقات ​

بعد actions.sticker: true، يستطيع الروبوت إعادة إرسال حزم الملصقات التيسبق أن تلقاها كما هي؛ وبتفعيل stickerSets يستطيع أيضًا البحث عن الملصقات بالكلمات المفتاحية (مثل «إعجاب» → 👍). الحدود: 32 مجموعة ملصقات لكل بوت، و256 ملصقًا لكل مجموعة، و1–8 كلمة مفتاحية لكل ملصق. انتبه: لا يمكنه إرسال إلا الملصقات التي تلقاها؛ رفع ملصقات جديدة أو البحث في متجر الملصقات غير مدعوم.

وضع webhook (لا يُحتاج إليه عادةً) ​

WebSocket هو الافتراضي، ويعمل دون فتح الشبكة العامة. لا تتحول إلى connectionMode: "webhook" إلا عند وجود حاجة فعلية للاستدعاء الراجع: مسار /feishu/events على منفذ HTTP المشترك لـ Gateway (الافتراضي 18789)، ويتطلب verificationToken + encryptKey، على أن يقل فرق ساعة مضيف Gateway عن ساعة Feishu عن 1 ساعة (مع الحفاظ على مزامنة NTP)، وإلا فشل التحقق من التوقيع برمز 401.

حدَّان لتوفير الحصة ​

حد إرسال الوسائط 30 ميغابايت (mediaMaxMb)، والنصوص الطويلة تُقسَّم إلى أجزاء كل جزء 4000 حرفًا (textChunkLimit). لتوفير حصة Feishu API: typingIndicator: false لإيقاف تفاعل «يكتب الآن»، وresolveSenderNames: false لإيقاف الاستعلام عن أسماء المرسلين.

توجيه الـ Agents المتعددة (توزيع الرسائل على agents مختلفة حسب المستخدم/المجموعة) انظر C3 تعاون الـ Agents المتعددة.

خلاصة هذا الدرس ​

✅ أصبحت الآن قادرًا على:

  • إتمام ربط OpenClaw بـ Feishu: مساعد ذكي يرد ببطاقات تتحدث تدفقيًا في المحادثات الفردية والجماعية (تثبيت المكون الإضافي عبر المعالج → الاقتران ودخول المجموعة → فتح أدوات المستندات)
  • إرسال أوامر التحكم مثل /status و /model كنص عادي، مع إمكانية الاطلاع على التقدم في أي لحظة أثناء عمله
  • تكليفه بإنشاء مستندات Feishu وكتابة المحاضر وتسجيل Bitable والبحث في قاعدة المعرفة
  • التحكم في الوصول بالقائمة البيضاء (محادثة خاصة / مجموعة / مرسل داخل المجموعة) + شرط المنادة بـ @

مراجعة حقول الإعدادات الرئيسية:

الحقلالقيمة الموصى بهاالشرح
channels.feishu.connectionModewebsocket (الافتراضي)نقل الأحداث دون حاجة إلى URL عام
channels.feishu.dmPolicypairing (افتراضي) / allowlistسياسة المحادثة الخاصة؛ البوت الذي تم إنشاؤه عبر مسح رمز الاستجابة السريعة يُقفل تلقائيًا على صاحبه
channels.feishu.groupPolicyallowlist (افتراضي)سياسة المجموعة، تُستخدم مع groupAllowFrom
channels.feishu.requireMentiontrue (افتراضي)الرد فقط عند الإشارة بـ @ في المجموعة؛ ضمن استراتيجية open يكون الإعفاء افتراضيًا من
channels.feishu.groups.<群ID>.allowFromاملأ open_id لكل مجموعةقائمة بيضاء للمرسلين داخل المجموعة
channels.feishu.tools.permfalse (افتراضي)أداة إدارة الصلاحيات، تُفعّل عند الحاجة للعمليات الحساسة

إعلان الدرس التالي ​

الدرس التالي A3 WeChat و QQ و Yuanbao: ربط قنوات منظومة Tencent، ستتعلم:

  • حدود قدرات ربط WeChat الشخصي (المحادثات الخاصة فقط، دون دعم المحادثات الجماعية)
  • بوت QQ الرسمي: إنشاء البوت عبر منصة q.qq.com المفتوحة، والربط بأمر واحد
  • قناة Tencent Yuanbao: كيفية إعداد وضع WebSocket
  • الاختلافات في الإعداد بين قنوات منظومة Tencent و Feishu/WeCom

لا تزال شركتك تستخدم WeChat/QQ للتواصل؟ في الدرس التالي سنربطها أيضًا — القنوات لا تتداخل مع بعضها، وGateway واحد يأخذها جميعًا.

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.