Feishu

​

त्वरित शुरुआत

openclaw channels login --channel feishu

openclaw gateway restart

​

पहुँच नियंत्रण

​

डायरेक्ट संदेश

• "pairing" - अज्ञात उपयोगकर्ताओं को pairing कोड मिलता है; CLI के माध्यम से स्वीकृत करें
• "allowlist" - केवल allowFrom में सूचीबद्ध उपयोगकर्ता चैट कर सकते हैं
• "open" - सार्वजनिक DM केवल तब अनुमति दें जब allowFrom में "*" शामिल हो; प्रतिबंधात्मक प्रविष्टियों के साथ, केवल मेल खाने वाले उपयोगकर्ता चैट कर सकते हैं
• "disabled" - सभी DM अक्षम करें

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

समूह चैट

• true - @mention आवश्यक है (डिफ़ॉल्ट)
• false - @mention के बिना उत्तर दें
• प्रति-समूह ओवरराइड: channels.feishu.groups.<chat_id>.requireMention
• केवल-ब्रॉडकास्ट @all और @_all को bot mention नहीं माना जाता। ऐसा संदेश जिसमें @all और सीधे bot, दोनों का mention हो, फिर भी bot mention के रूप में गिना जाता है।

​

समूह कॉन्फ़िगरेशन उदाहरण

​

सभी समूहों को अनुमति दें, @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"],
        },
      },
    },
  },
}

​

समूह/उपयोगकर्ता ID प्राप्त करें

​

समूह ID (chat_id, प्रारूप: oc_xxx)

​

उपयोगकर्ता ID (open_id, प्रारूप: ou_xxx)

openclaw logs --follow

openclaw pairing list feishu

​

सामान्य कमांड

​

समस्या निवारण

​

bot समूह चैट में उत्तर नहीं देता

1. सुनिश्चित करें कि bot समूह में जोड़ा गया है
2. सुनिश्चित करें कि आप bot को @mention करते हैं (डिफ़ॉल्ट रूप से आवश्यक)
3. सत्यापित करें कि groupPolicy "disabled" नहीं है
4. लॉग जाँचें: openclaw logs --follow

​

bot संदेश प्राप्त नहीं करता

1. सुनिश्चित करें कि bot Feishu Open Platform / Lark Developer में प्रकाशित और स्वीकृत है
2. सुनिश्चित करें कि event subscription में im.message.receive_v1 शामिल है
3. सुनिश्चित करें कि persistent connection (WebSocket) चुना गया है
4. सुनिश्चित करें कि सभी आवश्यक permission scopes दिए गए हैं
5. सुनिश्चित करें कि gateway चल रहा है: openclaw gateway status
6. लॉग जाँचें: openclaw logs --follow

​

QR सेटअप Feishu मोबाइल ऐप में प्रतिक्रिया नहीं देता

1. सेटअप फिर से चलाएँ: openclaw channels login --channel feishu
2. मैनुअल सेटअप चुनें
3. Feishu Open Platform में, self-built app बनाएँ और उसका App ID और App Secret कॉपी करें
4. वे credentials सेटअप विज़ार्ड में चिपकाएँ

​

App Secret लीक हो गया

1. Feishu Open Platform / Lark Developer में App Secret रीसेट करें
2. अपनी config में value अपडेट करें
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 - outbound text chunk आकार (डिफ़ॉल्ट: 2000 अक्षर)
• mediaMaxMb - media upload/download सीमा (डिफ़ॉल्ट: 30 MB)

​

Streaming

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

​

Quota optimization

• typingIndicator (डिफ़ॉल्ट true): typing reaction calls छोड़ने के लिए false सेट करें
• resolveSenderNames (डिफ़ॉल्ट true): sender profile lookups छोड़ने के लिए false सेट करें

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

​

ACP sessions

​

Persistent ACP binding

{
  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 spawn करें

/acp spawn codex --thread here

​

Multi-agent routing

{
  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" (DM) या "group" (समूह चैट)
• match.peer.id: उपयोगकर्ता Open ID (ou_xxx) या समूह ID (oc_xxx)

​

प्रति-उपयोगकर्ता agent isolation (Dynamic Agent Creation)

• स्वतंत्र workspace directory
• अलग USER.md / SOUL.md / MEMORY.md
• निजी conversation history
• isolated skills और state

​

त्वरित सेटअप

{
  channels: {
    feishu: {
      dmPolicy: "open",
      allowFrom: ["*"],
      dynamicAgentCreation: {
        enabled: true,
        workspaceTemplate: "~/.openclaw/workspace-{agentId}",
        agentDirTemplate: "~/.openclaw/agents/{agentId}/agent",
      },
    },
  },
  session: {
    // Critical: makes each user's DM their "main session"
    // Automatically loads USER.md / SOUL.md / MEMORY.md
    // For stronger isolation, use "per-channel-peer" instead
    dmScope: "main",
  },
}

​

यह कैसे काम करता है

1. चैनल एक unique agentId जनरेट करता है: default account के लिए feishu-{user_open_id}, या named account के लिए bounded account-prefixed identity digest
2. workspaceTemplate path पर नया workspace बनाता है
3. agent को register करता है और इस उपयोगकर्ता के लिए binding बनाता है
4. workspace helper पहली access पर bootstrap files (AGENTS.md, SOUL.md, USER.md, आदि) सुनिश्चित करता है
5. इस उपयोगकर्ता के सभी भविष्य के messages को उनके dedicated agent पर route करता है

​

कॉन्फ़िगरेशन विकल्प

• {agentId} - जनरेट की गई एजेंट आईडी (उदा., feishu-ou_xxxxxx या feishu-support-<identity_digest>)
• {userId} - भेजने वाले का Feishu open_id (उदा., ou_xxxxxx)

​

सत्र दायरा

{
  session: {
    // For single-user personal bots: enables auto bootstrap loading
    dmScope: "main",

    // For public multi-user bots: stronger isolation
    // dmScope: "per-channel-peer",
  },
}

​

सामान्य बहु-उपयोगकर्ता डिप्लॉयमेंट

{
  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: {
    // Choose dmScope based on your isolation needs:
    // "main" for bootstrap auto-loading, "per-channel-peer" for stronger isolation
    dmScope: "main",
  },
  bindings: [], // Empty - dynamic agents auto-bind
}

​

सत्यापन

feishu: creating dynamic agent "feishu-ou_xxxxxx" for user ou_xxxxxx
workspace: /Users/you/.openclaw/workspace-feishu-ou_xxxxxx
feishu: dynamic agent created, new route: agent:feishu-ou_xxxxxx:main

ls -la ~/.openclaw/workspace-*

​

नोट्स

• वर्कस्पेस अलगाव: हर उपयोगकर्ता को अपनी वर्कस्पेस डायरेक्टरी और एजेंट इंस्टेंस मिलता है। सामान्य मैसेजिंग फ्लो के भीतर उपयोगकर्ता एक-दूसरे का बातचीत इतिहास या फ़ाइलें नहीं देख सकते।
• सुरक्षा सीमा: यह मैसेजिंग-संदर्भ अलगाव तंत्र है, शत्रुतापूर्ण सह-किरायेदार सुरक्षा सीमा नहीं। एजेंट प्रक्रिया और होस्ट वातावरण साझा हैं।
• bindings खाली होना चाहिए: डायनेमिक एजेंट अपनी बाइंडिंग अपने-आप रजिस्टर करते हैं
• अपग्रेड पाथ: मौजूदा मैन्युअल बाइंडिंग डायनेमिक एजेंटों के साथ काम करती रहती हैं
• session.dmScope वैश्विक है: यह केवल Feishu ही नहीं, सभी चैनलों को प्रभावित करता है

​

कॉन्फ़िगरेशन संदर्भ

​

समर्थित संदेश प्रकार

​

प्राप्त करें

• ✅ टेक्स्ट
• ✅ रिच टेक्स्ट (post)
• ✅ इमेज
• ✅ फ़ाइलें
• ✅ ऑडियो
• ✅ वीडियो/मीडिया
• ✅ स्टिकर

​

भेजें

• ✅ पाठ
• ✅ छवियां
• ✅ फ़ाइलें
• ✅ ऑडियो
• ✅ वीडियो/मीडिया
• ✅ इंटरैक्टिव कार्ड (स्ट्रीमिंग अपडेट सहित)
• ⚠️ रिच टेक्स्ट (पोस्ट-शैली फ़ॉर्मैटिंग; पूर्ण Feishu/Lark लेखन क्षमताओं का समर्थन नहीं करता)

​

थ्रेड और उत्तर

• ✅ इनलाइन उत्तर
• ✅ थ्रेड उत्तर
• ✅ किसी थ्रेड संदेश का उत्तर देते समय मीडिया उत्तर थ्रेड-अवेयर रहते हैं

​

संबंधित

• चैनल अवलोकन - सभी समर्थित चैनल
• पेयरिंग - DM प्रमाणीकरण और पेयरिंग फ़्लो
• समूह - समूह चैट व्यवहार और मेंशन गेटिंग
• चैनल रूटिंग - संदेशों के लिए सत्र रूटिंग
• सुरक्षा - एक्सेस मॉडल और हार्डनिंग