​

بوت Feishu

​

الملحق المطلوب

openclaw plugins install @openclaw/feishu

openclaw plugins install ./extensions/feishu

​

البدء السريع

​

الطريقة 1: معالج التهيئة الأولية (موصى بها)

openclaw onboard

1. إنشاء تطبيق Feishu وجمع بيانات الاعتماد
2. تهيئة بيانات اعتماد التطبيق في OpenClaw
3. تشغيل Gateway

• openclaw gateway status
• openclaw logs --follow

​

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

openclaw channels add

• openclaw gateway status
• openclaw gateway restart
• openclaw logs --follow

​

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

​

1. فتح منصة Feishu Open Platform

​

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

1. انقر على Create enterprise app
2. أدخل اسم التطبيق + الوصف
3. اختر أيقونة للتطبيق

​

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

• App ID (الصيغة: cli_xxx)
• سرّ التطبيق

​

4. تهيئة الأذونات

{
  "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. تفعيل قدرة البوت

1. فعّل قدرة البوت
2. عيّن اسم البوت

​

6. تهيئة الاشتراك بالأحداث

1. أنك قد شغّلت بالفعل openclaw channels add لـ Feishu
2. أن Gateway يعمل (openclaw gateway status)

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

​

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

1. أنشئ إصدارًا في Version Management & Release
2. قدّمه للمراجعة وانشره
3. انتظر موافقة المسؤول (عادةً ما تتم الموافقة تلقائيًا على تطبيقات المؤسسات)

​

الخطوة 2: تهيئة OpenClaw

​

التهيئة باستخدام المعالج (موصى بها)

openclaw channels add

​

التهيئة عبر ملف التهيئة

{
  channels: {
    feishu: {
      enabled: true,
      dmPolicy: "pairing",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "My AI assistant",
        },
      },
    },
  },
}

​

التهيئة عبر متغيرات البيئة

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

​

نطاق Lark ‏(العالمي)

{
  channels: {
    feishu: {
      domain: "lark",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
        },
      },
    },
  },
}

​

الخطوة 3: التشغيل + الاختبار

​

1. تشغيل Gateway

openclaw gateway

​

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

​

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

openclaw pairing approve feishu <CODE>

​

نظرة عامة

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

​

التحكم في الوصول

​

الرسائل المباشرة

• الافتراضي: dmPolicy: "pairing" (يحصل المستخدمون غير المعروفين على رمز اقتران)
• الموافقة على الاقتران:
  openclaw pairing list feishu
  openclaw pairing approve feishu <CODE>
  
• وضع قائمة السماح: عيّن channels.feishu.allowFrom مع Open IDs المسموح بها

​

الدردشات الجماعية

• "open" = السماح للجميع في المجموعات (افتراضي)
• "allowlist" = السماح فقط لـ groupAllowFrom
• "disabled" = تعطيل رسائل المجموعات

• true = يتطلب @mention (افتراضي)
• false = الرد دون إشارات

​

أمثلة تهيئة المجموعات

​

السماح بجميع المجموعات، مع اشتراط @mention (افتراضي)

{
  channels: {
    feishu: {
      groupPolicy: "open",
      // Default requireMention: true
    },
  },
}

​

السماح بجميع المجموعات، دون اشتراط @mention

{
  channels: {
    feishu: {
      groups: {
        oc_xxx: { requireMention: false },
      },
    },
  },
}

​

السماح لمستخدمين محددين في المجموعات فقط

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["ou_xxx", "ou_yyy"],
    },
  },
}

​

الحصول على معرّفات المجموعات/المستخدمين

​

معرّفات المجموعات (chat_id)

1. شغّل Gateway وقم بعمل @mention للبوت في المجموعة
2. شغّل openclaw logs --follow وابحث عن chat_id

​

معرّفات المستخدمين (open_id)

1. بدء تشغيل البوابة و DM البوت
2. شغّل openclaw logs --follow وابحث عن open_id

openclaw pairing list feishu

​

الأوامر الشائعة

ملاحظة: لا يدعم Feishu حتى الآن قوائم الأوامر الأصلية، لذا يجب إرسال الأوامر كنص.

​

أوامر إدارة Gateway

​

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

​

البوت لا يستجيب في الدردشات الجماعية

1. تأكد من إضافة البوت إلى المجموعة
2. تأكد من عمل @mention للبوت (السلوك الافتراضي)
3. تحقّق من أن groupPolicy غير مضبوط على "disabled"
4. تحقّق من السجلات: openclaw logs --follow

​

البوت لا يستقبل الرسائل

1. تأكد من نشر التطبيق والموافقة عليه
2. تأكد من أن اشتراك الأحداث يتضمن im.message.receive_v1
3. تأكد من تفعيل الاتصال طويل الأمد
4. تأكد من اكتمال أذونات التطبيق
5. تأكد من أن Gateway يعمل: openclaw gateway status
6. تحقّق من السجلات: openclaw logs --follow

​

تسريب App Secret

1. أعد تعيين App Secret في Feishu Open Platform
2. حدّث App Secret في التهيئة
3. أعد تشغيل Gateway

​

فشل إرسال الرسائل

1. تأكد من أن التطبيق يمتلك إذن im:message:send_as_bot
2. تأكد من نشر التطبيق
3. تحقّق من السجلات لمعرفة الأخطاء التفصيلية

​

التهيئة المتقدمة

​

حسابات متعددة

{
  channels: {
    feishu: {
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "Primary bot",
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          botName: "Backup bot",
          enabled: false,
        },
      },
    },
  },
}

​

حدود الرسائل

• textChunkLimit: حجم مقطع النص الصادر (الافتراضي: 2000 حرف)
• mediaMaxMb: حد رفع/تنزيل الوسائط (الافتراضي: 30MB)

​

البث

{
  channels: {
    feishu: {
      streaming: true, // enable streaming card output (default true)
      blockStreaming: true, // enable block-level streaming (default true)
    },
  },
}

​

توجيه متعدد الوكلاء

{
  agents: {
    list: [
      { id: "main" },
      {
        id: "clawd-fan",
        workspace: "/home/user/clawd-fan",
        agentDir: "/home/user/.openclaw/agents/clawd-fan/agent",
      },
      {
        id: "clawd-xi",
        workspace: "/home/user/clawd-xi",
        agentDir: "/home/user/.openclaw/agents/clawd-xi/agent",
      },
    ],
  },
  bindings: [
    {
      agentId: "main",
      match: {
        channel: "feishu",
        peer: { kind: "direct", id: "ou_xxx" },
      },
    },
    {
      agentId: "clawd-fan",
      match: {
        channel: "feishu",
        peer: { kind: "direct", id: "ou_yyy" },
      },
    },
    {
      agentId: "clawd-xi",
      match: {
        channel: "feishu",
        peer: { kind: "group", id: "oc_zzz" },
      },
    },
  ],
}

• match.channel: "feishu"
• match.peer.kind: “direct” أو “group”
• match.peer.id: Open ID للمستخدم (ou_xxx) أو معرّف المجموعة (oc_xxx)

​

مرجع التهيئة

​

مرجع dmPolicy

​

أنواع الرسائل المدعومة

​

الاستقبال

• ✅ نص
• ✅ نص منسّق (post)
• ✅ صور
• ✅ ملفات
• ✅ صوت
• ✅ فيديو
• ✅ ملصقات

​

الإرسال

• ✅ نص
• ✅ صور
• ✅ ملفات
• ✅ صوت
• ⚠️ نص منسّق (دعم جزئي)