الانتقال إلى المحتوى الرئيسي
قم بتوصيل Feishu (飞书) أو Lark بمثيل Claw الخاص بك. يستخدم وضع WebSocket — لا حاجة لعنوان callback URL عام.

​
المتطلبات الأساسية

​
دليل الإعداد

1

إنشاء تطبيق Feishu

  1. انتقل إلى Feishu Open Platform (أو Lark Developer)
  2. انقر فوق Create Custom App
  3. أدخل اسماً ووصفاً للتطبيق
  4. انقر فوق Create
2

إضافة إمكانية Bot

  1. في إعدادات تطبيقك، انتقل إلى Features ← Bot
  2. قم بتمكين إمكانية bot
  3. يسمح هذا لتطبيقك باستقبال وإرسال الرسائل
3

الحصول على بيانات الاعتماد

  1. انتقل إلى Credentials & Basic Info
  2. قم بنسخ App ID (يبدأ بـ cli_)
  3. قم بنسخ App Secret
4

تكوين اشتراك الأحداث

  1. انتقل إلى Event Subscriptions
  2. اختر وضع WebSocket (موصى به — لا حاجة لعنوان URL عام)
  3. إذا طُلب منك ذلك، قم بتعيين Encrypt Key و Verification Token
عند تكوين Feishu في لوحة تحكم LemonData، يتم إنشاء تلقائي لـ Encrypt Key و Verification Token لك. قم بنسخ هذه القيم إلى وحدة تحكم مطوري Feishu.
5

إضافة أذونات الأحداث

  1. ضمن Event Subscriptions، أضف هذه الأحداث:
    • im.message.receive_v1 — استقبال الرسائل
  2. انتقل إلى Permissions & Scopes وأضف:
    • im:message — إرسال واستقبال الرسائل
    • im:message.group_at_msg — استقبال إشارات المجموعة (@mentions)
  3. انقر فوق Save
6

نشر التطبيق

  1. انتقل إلى App Release ← Version Management
  2. أنشئ إصداراً جديداً
  3. أرسل للمراجعة (بالنسبة للتطبيقات الداخلية، يكون هذا فورياً عادةً)
  4. بمجرد الموافقة، يصبح التطبيق متاحاً
7

التكوين في لوحة تحكم LemonData

  1. انتقل إلى لوحة تحكم Claw
  2. انقر فوق أيقونة الإعدادات في المثيل الخاص بك
  3. افتح علامة تبويب IM Integrations
  4. قم بتوسيع قسم Feishu
  5. قم بلصق App ID و App Secret الخاصين بك
  6. قم بنسخ Encrypt Key و Verification Token المنشأة تلقائياً مرة أخرى إلى وحدة تحكم مطوري Feishu
  7. انقر فوق Save
8

بدء الدردشة

  1. في Feishu، ابحث عن bot الخاص بك بالاسم
  2. أرسل له رسالة
  3. يتم إقران المستخدم الأول تلقائياً كمالك — لا حاجة لأي كود!
  4. ابدأ الدردشة مع الذكاء الاصطناعي!

​
إعدادات المجموعة

قم بتكوين سلوك دردشة المجموعة في علامة تبويب IM Integrations في لوحة التحكم الخاصة بك:
الإعدادالخياراتالوصف
Group Policyمفتوح (افتراضي) / القائمة البيضاء / معطليتحكم في من يمكنه تفعيل bot في المجموعات
Require @mentionتشغيل / إيقافيستجيب bot فقط عند الإشارة إليه (@mentioned)
Group IDsقائمة بمعرفات الدردشةالتقييد بمجموعات محددة (فارغ = جميع المجموعات)
Group Allowed Usersقائمة بـ Open IDsيمكن لهؤلاء المستخدمين فقط تفعيل bot (وضع القائمة البيضاء)

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

  • تحقق من نشر التطبيق والموافقة عليه
  • تحقق من الاشتراك في حدث im.message.receive_v1
  • تأكد من اختيار وضع WebSocket (وليس HTTP)
  • تحقق من تطابق Encrypt Key و Verification Token بين وحدة تحكم Feishu وتكوين Claw
  • يعني هذا عادةً أن App ID أو App Secret غير صحيح
  • تحقق جيداً من بيانات الاعتماد في لوحة التحكم الخاصة بك