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" - อนุญาต 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 สำหรับประกาศถึงทุกคนเท่านั้น จะไม่ถือเป็นการกล่าวถึงบอต ข้อความที่กล่าวถึงทั้ง @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"],
        },
      },
    },
  },
}

​

รับ ID ของกลุ่ม/ผู้ใช้

​

ID ของกลุ่ม (chat_id, รูปแบบ: oc_xxx)

​

ID ของผู้ใช้ (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. ตรวจสอบให้แน่ใจว่าเลือก 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. อัปเดตค่าใน config ของคุณ
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 MB)

​

การสตรีม

{
  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" (DM) หรือ "group" (แชตกลุ่ม)
• match.peer.id: Open ID ของผู้ใช้ (ou_xxx) หรือ ID ของกลุ่ม (oc_xxx)

​

อ้างอิงการกำหนดค่า

​

ประเภทข้อความที่รองรับ

​

รับ

• ✅ ข้อความ
• ✅ ข้อความแบบ Rich text (post)
• ✅ รูปภาพ
• ✅ ไฟล์
• ✅ เสียง
• ✅ วิดีโอ/สื่อ
• ✅ สติกเกอร์

​

ส่ง

• ✅ ข้อความ
• ✅ รูปภาพ
• ✅ ไฟล์
• ✅ เสียง
• ✅ วิดีโอ/สื่อ
• ✅ การ์ดแบบอินเทอร์แอกทีฟ (รวมถึงการอัปเดตแบบสตรีม)
• ⚠️ ข้อความแบบ Rich text (การจัดรูปแบบสไตล์ post; ไม่รองรับความสามารถการสร้างเนื้อหา Feishu/Lark แบบเต็ม)

​

เธรดและการตอบกลับ

• ✅ การตอบกลับแบบอินไลน์
• ✅ การตอบกลับในเธรด
• ✅ การตอบกลับด้วยสื่อยังคงรับรู้เธรดเมื่อกำลังตอบกลับข้อความในเธรด

​

ที่เกี่ยวข้อง

• ภาพรวมช่องทาง - ช่องทางที่รองรับทั้งหมด
• การจับคู่ - การยืนยันตัวตนและโฟลว์การจับคู่ผ่าน DM
• กลุ่ม - พฤติกรรมแชตกลุ่มและการกั้นด้วยการกล่าวถึง
• การกำหนดเส้นทางช่องทาง - การกำหนดเส้นทางเซสชันสำหรับข้อความ
• ความปลอดภัย - โมเดลการเข้าถึงและการเสริมความแข็งแกร่ง