Feishu

​

البدء السريع

openclaw channels login --channel feishu

openclaw gateway restart

​

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

​

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

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

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

• الافتراضي: يلزم توجيه @إشارة، إلا عندما تكون سياسة المجموعة الفعلية هي "open"؛ إذ تكون القيمة الافتراضية هناك false كي تظل الرسائل التي لا يمكن أن تتضمن إشارات (مثل الصور) تصل إلى الوكيل.
• اضبط true أو false صراحةً للتجاوز؛ والتجاوز لكل مجموعة هو: channels.feishu.groups.<chat_id>.requireMention.
• لا تُعامل إشارتا البث فقط @all و@_all على أنهما إشارتان إلى البوت. وتظل الرسالة التي تشير إلى كل من @all والبوت مباشرةً محسوبةً كإشارة إلى البوت.

​

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

​

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

{
  channels: {
    feishu: {
      groupPolicy: "open", // القيمة الافتراضية لـ requireMention هي false ضمن "open"
    },
  },
}

​

السماح بجميع المجموعات، مع استمرار اشتراط @إشارة

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

​

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

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // تبدو معرّفات المجموعات على النحو التالي: 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: {
          // تبدو قيم open_id للمستخدمين على النحو التالي: ou_xxx
          allowFrom: ["ou_user1", "ou_user2"],
        },
      },
    },
  },
}

​

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

​

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

​

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

openclaw logs --follow

openclaw pairing list feishu

​

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

​

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

​

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

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

​

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

1. تأكد من نشر البوت والموافقة عليه في Feishu Open Platform / Lark Developer
2. تأكد من أن اشتراك الأحداث يتضمن im.message.receive_v1
3. تأكد من تحديد persistent connection ‏(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: "البوت الأساسي",
          tts: {
            providers: {
              openai: { voice: "shimmer" },
            },
          },
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          name: "البوت الاحتياطي",
          enabled: false,
        },
      },
    },
  },
}

​

حدود الرسائل

• textChunkLimit - حجم جزء النص الصادر (الافتراضي: 4000 حرفًا)
• streaming.chunkMode - يقسم "length" (الافتراضي) عند الحد؛ ويفضل "newline" حدود الأسطر الجديدة
• mediaMaxMb - حد رفع الوسائط وتنزيلها (الافتراضي: 30 ميغابايت)

​

التدفق

{
  channels: {
    feishu: {
      streaming: {
        mode: "partial", // مخرجات بطاقة متدفقة (الافتراضي: "partial")
        block: { enabled: true }, // الاشتراك في تدفق الكتل المكتملة
      },
    },
  },
}

​

تحسين الحصة

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

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

​

نطاق جلسة المجموعة وسلاسل المواضيع

​

أدوات مساحة عمل Feishu

​

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

​

عزل الوكيل لكل مستخدم (إنشاء الوكيل الديناميكي)

• دليل مساحة عمل مستقل
• USER.md / SOUL.md / MEMORY.md منفصلة
• سجل محادثات خاص
• Skills وحالة معزولتان

​

الإعداد السريع

{
  channels: {
    feishu: {
      dmPolicy: "open",
      allowFrom: ["*"],
      dynamicAgentCreation: {
        enabled: true,
        workspaceTemplate: "~/.openclaw/workspace-{agentId}",
        agentDirTemplate: "~/.openclaw/agents/{agentId}/agent",
      },
    },
  },
  session: {
    // مهم: يجعل الرسائل المباشرة لكل مستخدم «جلسته الرئيسية»
    // يحمّل USER.md / SOUL.md / MEMORY.md تلقائيًا
    // لعزل أقوى، استخدم "per-channel-peer" بدلًا منه
    dmScope: "main",
  },
}

​

آلية العمل

1. تُنشئ القناة agentId فريدًا: feishu-{user_open_id} للحساب الافتراضي، أو ملخص هوية محدودًا مسبوقًا بالحساب لحساب مُسمّى
2. تُنشئ مساحة عمل جديدة في مسار workspaceTemplate
3. تُسجّل الوكيل وتُنشئ ارتباطًا لهذا المستخدم
4. يضمن مساعد مساحة العمل وجود ملفات التمهيد (AGENTS.md وSOUL.md وUSER.md وغيرها) عند الوصول الأول
5. تُوجّه جميع الرسائل المستقبلية من هذا المستخدم إلى وكيله المخصص

​

خيارات الإعداد

• {agentId} - معرّف الوكيل المُنشأ (مثل feishu-ou_xxxxxx أو feishu-support-<identity_digest>)
• {userId} - معرّف Feishu المفتوح للمرسل (مثل ou_xxxxxx)

​

نطاق الجلسة

​

نشر نموذجي متعدد المستخدمين

{
  channels: {
    feishu: {
      appId: "cli_xxx",
      appSecret: "xxx",
      dmPolicy: "open",
      allowFrom: ["*"],
      groupPolicy: "open",
      requireMention: true,
      dynamicAgentCreation: {
        enabled: true,
        workspaceTemplate: "~/.openclaw/workspace-{agentId}",
        agentDirTemplate: "~/.openclaw/agents/{agentId}/agent",
      },
    },
  },
  session: {
    // اختر dmScope بناءً على احتياجات العزل لديك:
    // "main" للتحميل التلقائي للتهيئة الأولية، و"per-channel-peer" لعزل أقوى
    dmScope: "main",
  },
  bindings: [], // فارغة - ترتبط الوكلاء الديناميكيون تلقائيًا
}

​

التحقق

feishu: جارٍ إنشاء الوكيل الديناميكي "feishu-ou_xxxxxx" للمستخدم ou_xxxxxx
  مساحة العمل: /home/user/.openclaw/workspace-feishu-ou_xxxxxx
  دليل الوكيل: /home/user/.openclaw/agents/feishu-ou_xxxxxx/agent

ls -la ~/.openclaw/workspace-*

​

ملاحظات

• عزل مساحة العمل: يحصل كل مستخدم على دليل مساحة عمل ومثيل وكيل خاصين به. لا يمكن للمستخدمين رؤية سجل محادثات بعضهم أو ملفاتهم ضمن تدفق المراسلة المعتاد.
• حدود الأمان: هذه آلية لعزل سياق المراسلة، وليست حدود أمان بين مستأجرين مشتركين عدائيين. تشترك الحسابات في عملية الوكيل وبيئة المضيف.
• يجب إبقاء الكتابة إلى الإعدادات مفعّلة: يكتب إنشاء الوكلاء الديناميكيين الوكلاء والارتباطات في الإعدادات؛ ويُتخطى عندما تكون channels.feishu.configWrites بالقيمة false (الافتراضي: مفعّل).
• يجب أن يكون bindings فارغًا: تسجّل الوكلاء الديناميكية ارتباطاتها تلقائيًا
• مسار الترقية: تستمر الارتباطات اليدوية الحالية في العمل إلى جانب الوكلاء الديناميكيين
• session.dmScope عام: يؤثر هذا في جميع القنوات، وليس Feishu فقط

​

مرجع الإعدادات

​

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

​

الاستقبال

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

​

الإرسال

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

​

سلاسل المواضيع والردود

• ✅ الردود المضمنة
• ✅ الردود ضمن سلاسل المواضيع
• ✅ تظل ردود الوسائط مرتبطة بسلسلة الموضوع عند الرد على رسالة ضمن سلسلة

​

ذو صلة

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