Feishu

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

البدء السريع

openclaw channels login --channel feishu

openclaw gateway restart

​

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

​

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

• "pairing" - يتلقى المستخدمون غير المعروفين رمز اقتران؛ وافق عليه عبر CLI
• "allowlist" - يمكن فقط للمستخدمين المدرجين في allowFrom الدردشة (الافتراضي: مالك البوت فقط)
• "open" - اسمح بالرسائل المباشرة العامة فقط عندما يتضمن allowFrom القيمة "*"؛ مع الإدخالات المقيّدة، يمكن فقط للمستخدمين المطابقين الدردشة
• "disabled" - عطّل كل الرسائل المباشرة

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

محادثات المجموعات

• true - يتطلب @mention (الافتراضي)
• false - الرد دون @mention
• تجاوز لكل مجموعة: channels.feishu.groups.<chat_id>.requireMention
• لا تُعامل إشارات البث فقط @all و@_all كإشارات إلى البوت. الرسالة التي تشير إلى كل من @all والبوت مباشرة لا تزال تُحتسب كإشارة إلى البوت.

​

أمثلة تكوين المجموعات

​

السماح لكل المجموعات، دون الحاجة إلى @mention

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

​

السماح لكل المجموعات، مع استمرار اشتراط @mention

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

​

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

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // Group IDs look like: oc_xxx
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
    },
  },
}

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groups: {
        oc_xxx: {
          requireMention: false,
        },
      },
    },
  },
}

​

تقييد المرسلين داخل مجموعة

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx"],
      groups: {
        oc_xxx: {
          // User open_ids look like: ou_xxx
          allowFrom: ["ou_user1", "ou_user2"],
        },
      },
    },
  },
}

​

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

​

معرّفات المجموعات (chat_id، التنسيق: oc_xxx)

​

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

openclaw logs --follow

openclaw pairing list feishu

​

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

​

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

​

البوت لا يرد في محادثات المجموعات

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

​

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

1. تأكد من نشر البوت والموافقة عليه في Feishu Open Platform / Lark Developer
2. تأكد من أن اشتراك الأحداث يتضمن im.message.receive_v1
3. تأكد من اختيار الاتصال المستمر (WebSocket)
4. تأكد من منح كل نطاقات الأذونات المطلوبة
5. تأكد من أن Gateway قيد التشغيل: openclaw gateway status
6. تحقق من السجلات: openclaw logs --follow

​

إعداد QR لا يتفاعل في تطبيق Feishu للهاتف

1. أعد تشغيل الإعداد: openclaw channels login --channel feishu
2. اختر الإعداد اليدوي
3. في Feishu Open Platform، أنشئ تطبيقا ذاتي البناء وانسخ App ID وApp Secret الخاصين به
4. الصق بيانات الاعتماد هذه في معالج الإعداد

​

تسرّب App Secret

1. أعد ضبط App Secret في Feishu Open Platform / Lark Developer
2. حدّث القيمة في تكوينك
3. أعد تشغيل Gateway: openclaw gateway restart

​

التكوين المتقدم

​

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

{
  channels: {
    feishu: {
      defaultAccount: "main",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          name: "Primary bot",
          tts: {
            providers: {
              openai: { voice: "shimmer" },
            },
          },
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          name: "Backup bot",
          enabled: false,
        },
      },
    },
  },
}

​

حدود الرسائل

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

​

البث

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

​

تحسين الحصة

• typingIndicator (الافتراضي true): اضبطه على false لتجاوز استدعاءات تفاعل الكتابة
• resolveSenderNames (الافتراضي true): اضبطه على false لتجاوز عمليات البحث عن ملف تعريف المرسل

{
  channels: {
    feishu: {
      typingIndicator: false,
      resolveSenderNames: false,
    },
  },
}

​

جلسات 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

​

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

{
  agents: {
    list: [
      { id: "main" },
      { id: "agent-a", workspace: "/home/user/agent-a" },
      { id: "agent-b", workspace: "/home/user/agent-b" },
    ],
  },
  bindings: [
    {
      agentId: "agent-a",
      match: {
        channel: "feishu",
        peer: { kind: "direct", id: "ou_xxx" },
      },
    },
    {
      agentId: "agent-b",
      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)

​

مرجع التكوين

​

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

​

الاستقبال

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

​

الإرسال

• ✅ نص
• ✅ صور
• ✅ ملفات
• ✅ صوت
• ✅ فيديو/وسائط
• ✅ بطاقات تفاعلية (بما في ذلك تحديثات البث)
• ⚠️ نص منسق (تنسيق بنمط المنشورات؛ لا يدعم قدرات التأليف الكاملة في Feishu/Lark)

​

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

• ✅ ردود مضمنة
• ✅ ردود ضمن المحادثة
• ✅ تظل ردود الوسائط مدركة للمحادثة عند الرد على رسالة ضمن محادثة

​

ذات صلة

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