الانتقال إلى المحتوى الرئيسي
قم بتوصيل 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 في LemonClaw WebUI، يتم إنشاء تلقائي لـ 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

افتح LemonClaw WebUI

  1. إذا كنت تستخدم Claw المستضاف، فانتقل إلى Claw Dashboard واضغط Open WebUI
  2. إذا كنت تستضيف LemonClaw بنفسك، فافتح WebUI الخاص بك (مثلاً http://your-ip:18789) وسجّل الدخول باستخدام الـ token
  3. في WebUI، انتقل إلى Settings → Channels
  4. قم بتوسيع قسم Feishu
  5. قم بلصق App ID و App Secret الخاصين بك
  6. قم بنسخ Encrypt Key و Verification Token المنشأة تلقائياً مرة أخرى إلى وحدة تحكم مطوري Feishu
  7. انقر فوق Save
8

بدء الدردشة

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

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

قم بتكوين سلوك دردشة المجموعة في علامة تبويب Channels في WebUI الخاصة بك:
الإعدادالخياراتالوصف
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 غير صحيح
  • تحقق جيداً من بيانات الاعتماد في لوحة التحكم الخاصة بك