Feishu (Lark) - قناة دردشة

استخدم OpenClaw عبر Feishu (Lark) - منصة محادثة فريق العمل المستخدمة من قبل الشركات للمراسلة والتعاون. يتصل هذا المكون الإضافي بـ OpenClaw عبر WebSocket للاشتراك في الأحداث، لذا يمكن استقبال الرسائل بدون الحاجة لعنوان URL عام!

openclaw plugins install @openclaw/feishu

openclaw plugins install ./extensions/feishu

البدء السريع

هناك طريقتان لإضافة قناة Feishu:

الطريقة 1: معالج الإعداد (موصى به)

إذا قمت للتو بتثبيت OpenClaw، قم بتشغيل المعالج:

openclaw onboard

يرشدك المعالج خلال:

• إنشاء تطبيق Feishu وجمع بيانات الاعتماد
• تكوين بيانات اعتماد التطبيق في OpenClaw
• بدء تشغيل Gateway

openclaw gateway status
openclaw logs --follow

الطريقة 2: إعداد CLI

إذا كنت قد أكملت التثبيت الأولي بالفعل، أضف القناة عبر CLI:

openclaw channels add

اختر Feishu، ثم أدخل App ID و App Secret.

الخطوة 1: إنشاء تطبيق Feishu

1. افتح منصة Feishu المفتوحة

قم بزيارة منصة Feishu المفتوحة وقم بتسجيل الدخول.

مستأجرو Lark (العالميون) يجب أن يستخدموا https://open.larksuite.com/app وتعيين domain: "lark" في تكوين Feishu.

2. إنشاء تطبيق

• انقر على "إنشاء تطبيق مؤسسة"
• املأ اسم التطبيق + الوصف
• اختر أيقونة التطبيق

3. نسخ بيانات الاعتماد

من "Credentials & Basic Info"، انسخ:

• App ID (تنسيق: cli_xxx)
• App Secret

4. تكوين الأذونات

في "Permissions"، انقر على "Batch import" والصق:

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

5. تمكين قدرة البوت

في "App Capability" → "Bot":

• تمكين قدرة البوت
• تعيين اسم البوت

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

في "Event Subscription":

• اختر "Use long connection to receive events" (WebSocket)
• أضف الحدث: im.message.receive_v1

7. نشر التطبيق

• إنشاء نسخة في "Version Management & Release"
• إرسال للمراجعة والنشر
• انتظر موافقة المسؤول (تطبيقات المؤسسة عادة تتم الموافقة عليها تلقائياً)

الخطوة 2: تكوين OpenClaw

التكوين مع المعالج (موصى به)

openclaw channels add

اختر Feishu والصق App ID + App Secret الخاص بك.

التكوين عبر ملف التكوين

قم بتحرير ~/.openclaw/openclaw.json:

{
  channels: {
    feishu: {
      enabled: true,
      dmPolicy: "pairing",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "مساعدي الذكاء الاصطناعي",
        },
      },
    },
  },
}

التكوين عبر متغيرات البيئة

export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"

الخطوة 3: البدء + الاختبار

1. ابدأ Gateway

openclaw gateway

2. إرسال رسالة اختبار

في Feishu، ابحث عن البوت الخاص بك وأرسل رسالة.

3. الموافقة على الاقتران

افتراضياً، يرد البوت برمز اقتران. قم بالموافقة عليه:

openclaw pairing approve feishu <CODE>

بعد الموافقة، يمكنك الدردشة بشكل طبيعي.

نظرة عامة

• قناة بوت Feishu: بوت Feishu تديره Gateway
• التوجيه الحتمي: الردود تعود دائماً إلى Feishu
• عزل الجلسة: الرسائل المباشرة تشارك جلسة رئيسية؛ المجموعات معزولة
• اتصال WebSocket: اتصال طويل عبر Feishu SDK، لا حاجة لعنوان URL عام