​

بوت Feishu

​

الـ plugin المضمّن

openclaw plugins install @openclaw/feishu

​

البدء السريع

​

الطريقة 1: الإعداد الأولي (مستحسن)

openclaw onboard

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

• 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)
• App Secret

​

4. إعداد الأذونات

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card: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. أن البوابة قيد التشغيل (openclaw gateway status)

1. اختر Use long connection to receive events ‏(WebSocket)
2. أضف الحدث: im.message.receive_v1
3. (اختياري) لمهام تعليقات Drive، أضف أيضًا: drive.notice.comment_add_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",
          name: "My AI assistant",
        },
      },
    },
  },
}

​

Verification Token وEncrypt Key ‏(وضع webhook)

1. في Feishu Open Platform، افتح تطبيقك
2. انتقل إلى Development → Events & Callbacks ‏(开发配置 → 事件与回调)
3. افتح تبويب Encryption ‏(加密策略)
4. انسخ Verification Token وEncrypt Key

​

الإعداد عبر متغيرات البيئة

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

​

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

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

​

علامات تحسين الحصة

• typingIndicator (الافتراضي true): عند ضبطه على false، يتم تخطي استدعاءات تفاعل الكتابة.
• resolveSenderNames (الافتراضي true): عند ضبطه على false، يتم تخطي استدعاءات البحث عن ملف المُرسِل الشخصي.

{
  channels: {
    feishu: {
      typingIndicator: false,
      resolveSenderNames: false,
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          typingIndicator: true,
          resolveSenderNames: false,
        },
      },
    },
  },
}

​

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

​

1. شغّل البوابة

openclaw gateway

​

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

​

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

openclaw pairing approve feishu <CODE>

​

نظرة عامة

• قناة بوت Feishu: بوت Feishu تديره البوابة
• توجيه حتمي: تعود الردود دائمًا إلى 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 صراحةً = يرد من دون إشارات
• عند عدم ضبطه ووجود groupPolicy: "open" = الافتراضي false
• عند عدم ضبطه وكون groupPolicy ليس "open" = الافتراضي true

​

أمثلة على إعداد المجموعات

​

السماح لجميع المجموعات، من دون الحاجة إلى @mention ‏(الافتراضي للمجموعات المفتوحة)

{
  channels: {
    feishu: {
      groupPolicy: "open",
    },
  },
}

​

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

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

​

السماح بمجموعات محددة فقط

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // Feishu group IDs (chat_id) look like: oc_xxx
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
    },
  },
}

​

تقييد المرسلين المسموح لهم بالمراسلة داخل مجموعة (قائمة سماح للمرسلين)

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx"],
      groups: {
        oc_xxx: {
          // Feishu user IDs (open_id) look like: ou_xxx
          allowFrom: ["ou_user1", "ou_user2"],
        },
      },
    },
  },
}

​

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

​

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

1. شغّل البوابة واذكر البوت باستخدام @mention داخل المجموعة
2. شغّل openclaw logs --follow وابحث عن chat_id

​

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

1. شغّل البوابة وأرسل رسالة مباشرة إلى البوت
2. شغّل openclaw logs --follow وابحث عن open_id

openclaw pairing list feishu

​

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

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

​

أوامر إدارة البوابة

​

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

​

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

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

​

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

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

​

تسرّب App Secret

1. أعد تعيين App Secret في Feishu Open Platform
2. حدّث App Secret في إعداداتك
3. أعد تشغيل البوابة

​

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

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

​

الإعداد المتقدم

​

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

{
  channels: {
    feishu: {
      defaultAccount: "main",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          name: "Primary bot",
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          name: "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)
    },
  },
}

​

جلسات ACP

• الرسائل المباشرة
• محادثات موضوعات المجموعات

​

ارتباطات ACP الدائمة

{
  agents: {
    list: [
      {
        id: "codex",
        runtime: {
          type: "acp",
          acp: {
            agent: "codex",
            backend: "acpx",
            mode: "persistent",
            cwd: "/workspace/openclaw",
          },
        },
      },
    ],
  },
  bindings: [
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "feishu",
        accountId: "default",
        peer: { kind: "direct", id: "ou_1234567890" },
      },
    },
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "feishu",
        accountId: "default",
        peer: { kind: "group", id: "oc_group_chat:topic:om_topic_root" },
      },
      acp: { label: "codex-feishu-topic" },
    },
  ],
}

​

إنشاء ACP مرتبط بسلسلة محادثة من الدردشة

/acp spawn codex --thread here

• يعمل --thread here مع الرسائل المباشرة وموضوعات Feishu.
• يتم توجيه الرسائل اللاحقة في الرسالة المباشرة/الموضوع المرتبط مباشرة إلى جلسة ACP تلك.
• لا يستهدف الإصدار v1 دردشات المجموعات العامة غير المرتبطة بموضوع.

​

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

{
  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 للمستخدم (ou_xxx) أو معرّف المجموعة (oc_xxx)

​

مرجع الإعداد

​

مرجع dmPolicy

​

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

​

الاستقبال

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

​

الإرسال

• ✅ نص
• ✅ صور
• ✅ ملفات
• ✅ صوت
• ✅ فيديو/وسائط
• ✅ بطاقات تفاعلية
• ⚠️ نص منسق (تنسيق بنمط post وبطاقات، وليس ميزات التأليف العشوائية في Feishu)

​

سلاسل المحادثات والردود

• ✅ ردود مضمّنة
• ✅ ردود سلسلة الموضوع عندما يوفّر Feishu ‏reply_in_thread
• ✅ تظل ردود الوسائط مدركة للسلسلة عند الرد على رسالة سلسلة/موضوع

​

تعليقات Drive

• الاشتراك في drive.notice.comment_add_v1 ضمن إعدادات اشتراك أحداث تطبيق Feishu (إلى جانب im.message.receive_v1 الموجود)
• أداة Drive مفعلة افتراضيًا؛ عطّلها باستخدام channels.feishu.tools.drive: false

• نص التعليق والمرسل
• بيانات المستند الوصفية (العنوان والنوع وURL)
• سياق سلسلة التعليق للردود داخل السلسلة

​

سطح إجراءات وقت التشغيل

• send
• read
• edit
• thread-reply
• pin
• list-pins
• unpin
• member-info
• channel-info
• channel-list
• react وreactions عندما تكون التفاعلات مفعّلة في الإعدادات
• إجراءات تعليقات feishu_drive: ‏list_comments وlist_comment_replies وadd_comment وreply_comment

​

ذو صلة

• نظرة عامة على القنوات — جميع القنوات المدعومة
• الاقتران — مصادقة الرسائل المباشرة وتدفق الاقتران
• المجموعات — سلوك دردشات المجموعات وضبط الإشارات
• توجيه القنوات — توجيه الجلسات للرسائل
• الأمان — نموذج الوصول والتحصين