Feishu

Feishu/Lark เป็นแพลตฟอร์มการทำงานร่วมกันแบบครบวงจรที่ทีมใช้แชท แชร์เอกสาร จัดการปฏิทิน และทำงานร่วมกันให้เสร็จได้

สถานะ: พร้อมใช้งานจริงสำหรับ DM ของบอต + แชทกลุ่ม โหมด WebSocket เป็นโหมดเริ่มต้น ส่วนโหมด webhook เป็นทางเลือก

เริ่มต้นอย่างรวดเร็ว

openclaw channels login --channel feishu

openclaw gateway restart

การควบคุมการเข้าถึง

ข้อความโดยตรง

กำหนดค่า dmPolicy เพื่อควบคุมว่าใครสามารถ DM หาบอตได้:

• "pairing" - ผู้ใช้ที่ไม่รู้จักจะได้รับรหัสจับคู่ อนุมัติผ่าน CLI
• "allowlist" - เฉพาะผู้ใช้ที่อยู่ใน allowFrom เท่านั้นที่แชทได้
• "open" - อนุญาต DM สาธารณะเฉพาะเมื่อ allowFrom มี "*"; หากมีรายการแบบจำกัด เฉพาะผู้ใช้ที่ตรงกันเท่านั้นที่แชทได้

อนุมัติคำขอจับคู่:

openclaw pairing list feishuopenclaw pairing approve feishu <CODE>

แชทกลุ่ม

นโยบายกลุ่ม (channels.feishu.groupPolicy):

ค่าเริ่มต้น: allowlist

ข้อกำหนดการกล่าวถึง (channels.feishu.requireMention):

• 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"],    },  },}

ในโหมด allowlist คุณสามารถอนุญาตกลุ่มได้ด้วยการเพิ่มรายการ groups.<chat_id> อย่างชัดเจน รายการที่ระบุชัดเจนจะไม่แทนที่ groupPolicy: "disabled" ค่าเริ่มต้นแบบ wildcard ใต้ groups.* จะกำหนดค่ากลุ่มที่ตรงกัน แต่จะไม่อนุญาตกลุ่มด้วยตัวเอง

{  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)

เปิดกลุ่มใน Feishu/Lark คลิกไอคอนเมนูที่มุมขวาบน แล้วไปที่ การตั้งค่า ID กลุ่ม (chat_id) จะแสดงอยู่ในหน้าการตั้งค่า

ID ผู้ใช้ (open_id, รูปแบบ: ou_xxx)

เริ่ม gateway ส่ง DM ไปยังบอต จากนั้นตรวจสอบบันทึก:

openclaw logs --follow

มองหา open_id ในเอาต์พุตบันทึก คุณยังสามารถตรวจสอบคำขอจับคู่ที่รอดำเนินการได้:

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,        },      },    },  },}

defaultAccount ควบคุมว่าจะใช้บัญชีใดเมื่อ API ขาออกไม่ได้ระบุ accountId accounts.<id>.tts ใช้รูปแบบเดียวกับ messages.tts และ deep-merge ทับ config TTS ส่วนกลาง ดังนั้นการตั้งค่า Feishu แบบหลายบอตจึงสามารถเก็บข้อมูลรับรอง provider ที่ใช้ร่วมกันไว้ในส่วนกลางได้ ขณะเดียวกันแทนที่เฉพาะเสียง โมเดล persona หรือโหมดอัตโนมัติ เป็นรายบัญชี

ขีดจำกัดข้อความ

• textChunkLimit - ขนาดชิ้นข้อความขาออก (ค่าเริ่มต้น: 2000 อักขระ)
• mediaMaxMb - ขีดจำกัดการอัปโหลด/ดาวน์โหลดสื่อ (ค่าเริ่มต้น: 30 MB)

การสตรีม

Feishu/Lark รองรับการตอบกลับแบบสตรีมผ่านการ์ดแบบโต้ตอบ เมื่อเปิดใช้งาน บอตจะอัปเดตการ์ดแบบเรียลไทม์ขณะสร้างข้อความ

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

ตั้งค่า streaming: false เพื่อส่งคำตอบทั้งหมดในข้อความเดียว blockStreaming ปิดอยู่ตามค่าเริ่มต้น เปิดใช้เฉพาะเมื่อคุณต้องการให้บล็อกผู้ช่วยที่เสร็จแล้วถูก flush ก่อนคำตอบสุดท้าย

การปรับโควตาให้เหมาะสม

ลดจำนวนการเรียก API ของ Feishu/Lark ด้วยแฟล็กทางเลือกสองรายการ:

• typingIndicator (ค่าเริ่มต้น true): ตั้งค่า false เพื่อข้ามการเรียกปฏิกิริยาการพิมพ์
• resolveSenderNames (ค่าเริ่มต้น true): ตั้งค่า false เพื่อข้ามการค้นหาโปรไฟล์ผู้ส่ง

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

เซสชัน ACP

Feishu/Lark รองรับ ACP สำหรับ DM และข้อความเธรดกลุ่ม ACP ของ Feishu/Lark ขับเคลื่อนด้วยคำสั่งข้อความ ไม่มีเมนูคำสั่ง slash แบบเนทีฟ ดังนั้นให้ใช้ข้อความ /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" },    },  ],}

Spawn ACP จากแชท

ใน DM หรือเธรดของ Feishu/Lark:

/acp spawn codex --thread here

--thread here ใช้ได้กับ DM และข้อความเธรดของ Feishu/Lark ข้อความติดตามผลในการสนทนาที่ผูกไว้จะถูกส่งไปยังเซสชัน ACP นั้นโดยตรง

การกำหนดเส้นทางหลายเอเจนต์

ใช้ bindings เพื่อกำหนดเส้นทาง DM หรือกลุ่มของ Feishu/Lark ไปยังเอเจนต์ต่างกัน

{  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)

ดู รับ ID ของกลุ่ม/ผู้ใช้ สำหรับเคล็ดลับการค้นหา

การแยกเอเจนต์รายผู้ใช้ (การสร้างเอเจนต์แบบไดนามิก)

เปิดใช้ dynamicAgentCreation เพื่อสร้าง อินสแตนซ์เอเจนต์ที่แยกจากกัน โดยอัตโนมัติสำหรับผู้ใช้ DM แต่ละคน ผู้ใช้แต่ละคนจะมีของตนเอง:

• ไดเรกทอรี workspace อิสระ
• USER.md / SOUL.md / MEMORY.md แยกต่างหาก
• ประวัติการสนทนาส่วนตัว
• Skills และสถานะแยกจากกัน

สิ่งนี้จำเป็นสำหรับบอตสาธารณะที่คุณต้องการให้ผู้ใช้แต่ละคนมีประสบการณ์ผู้ช่วย AI ส่วนตัวของตนเอง

การตั้งค่าอย่างรวดเร็ว

{  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",  },}

วิธีทำงาน

เมื่อผู้ใช้ใหม่ส่ง DM ครั้งแรก:

1. ช่องทางจะสร้าง agentId ที่ไม่ซ้ำกัน: feishu-{user_open_id} สำหรับบัญชีเริ่มต้น หรือ digest ตัวตนแบบมีขอบเขตและนำหน้าด้วยบัญชีสำหรับบัญชีที่มีชื่อ
2. สร้าง workspace ใหม่ที่พาธ workspaceTemplate
3. ลงทะเบียนเอเจนต์และสร้างการผูกสำหรับผู้ใช้นี้
4. ตัวช่วย workspace จะทำให้แน่ใจว่ามีไฟล์ bootstrap (AGENTS.md, SOUL.md, USER.md ฯลฯ) เมื่อเข้าถึงครั้งแรก
5. กำหนดเส้นทางข้อความในอนาคตทั้งหมดจากผู้ใช้นี้ไปยังเอเจนต์เฉพาะของผู้ใช้นั้น

ตัวเลือกการกำหนดค่า

ตัวแปรเทมเพลต:

• {agentId} - ID เอเจนต์ที่สร้างขึ้น (เช่น feishu-ou_xxxxxx หรือ feishu-support-<identity_digest>)
• {userId} - Feishu open_id ของผู้ส่ง (เช่น ou_xxxxxx)

ขอบเขตเซสชัน

session.dmScope ควบคุมวิธีแมปข้อความโดยตรงกับเซสชันของเอเจนต์ นี่คือ การตั้งค่าส่วนกลาง ที่มีผลกับทุกช่องทาง

ข้อแลกเปลี่ยน: การใช้ "main" เปิดใช้การโหลดไฟล์บูตสแตรปอัตโนมัติ (USER.md, SOUL.md, MEMORY.md) แต่หมายความว่า DM ทั้งหมดจากทุกช่องทางจะแชร์รูปแบบคีย์เซสชันเดียวกัน สำหรับบอตสาธารณะแบบหลายผู้ใช้ที่การแยกขอบเขตสำคัญกว่าการโหลดบูตสแตรปอัตโนมัติ ให้พิจารณา "per-channel-peer" และจัดการไฟล์บูตสแตรปด้วยตนเอง

{  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}

การตรวจสอบยืนยัน

ตรวจสอบบันทึก Gateway เพื่อยืนยันว่าการสร้างแบบไดนามิกทำงานอยู่:

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

แสดงรายการเวิร์กสเปซทั้งหมดที่สร้างแล้ว:

ls -la ~/.openclaw/workspace-*

หมายเหตุ

• การแยกเวิร์กสเปซ: ผู้ใช้แต่ละคนจะได้รับไดเรกทอรีเวิร์กสเปซและอินสแตนซ์เอเจนต์ของตนเอง ผู้ใช้จะไม่เห็นประวัติการสนทนาหรือไฟล์ของกันและกันภายในโฟลว์การส่งข้อความปกติ
• ขอบเขตความปลอดภัย: นี่คือกลไกการแยกขอบเขตตามบริบทการส่งข้อความ ไม่ใช่ขอบเขตความปลอดภัยสำหรับผู้เช่าร่วมที่เป็นศัตรู โปรเซสเอเจนต์และสภาพแวดล้อมโฮสต์ยังคงแชร์กัน
• bindings ควรว่าง: เอเจนต์แบบไดนามิกจะลงทะเบียนการผูกของตนเองโดยอัตโนมัติ
• เส้นทางการอัปเกรด: การผูกแบบกำหนดเองที่มีอยู่ยังคงทำงานร่วมกับเอเจนต์แบบไดนามิกได้
• session.dmScope เป็นส่วนกลาง: สิ่งนี้มีผลกับทุกช่องทาง ไม่ใช่เฉพาะ Feishu

ข้อมูลอ้างอิงการกำหนดค่า

การกำหนดค่าแบบเต็ม: การกำหนดค่า Gateway

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

รับ

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

ข้อความเสียงขาเข้า Feishu/Lark จะถูกทำให้เป็นปกติเป็นตัวยึดตำแหน่งสื่อแทน JSON file_key ดิบ เมื่อกำหนดค่า tools.media.audio แล้ว OpenClaw จะดาวน์โหลดทรัพยากรบันทึกเสียงและเรียกใช้การถอดเสียงร่วมก่อน เทิร์นของเอเจนต์ เพื่อให้เอเจนต์ได้รับข้อความถอดเสียงจากคำพูด หาก Feishu รวม ข้อความถอดเสียงไว้โดยตรงในเพย์โหลดเสียง ข้อความนั้นจะถูกใช้โดยไม่ต้องเรียก ASR อีกครั้ง หากไม่มีผู้ให้บริการถอดเสียง เอเจนต์ยังคงได้รับ ตัวยึดตำแหน่ง <media:audio> พร้อมไฟล์แนบที่บันทึกไว้ ไม่ใช่เพย์โหลด ทรัพยากร Feishu ดิบ

ส่ง

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

บับเบิลเสียงแบบเนทีฟของ Feishu/Lark ใช้ชนิดข้อความ Feishu audio และต้องใช้ สื่ออัปโหลด Ogg/Opus (file_type: "opus") สื่อ .opus และ .ogg ที่มีอยู่ จะถูกส่งโดยตรงเป็นเสียงแบบเนทีฟ MP3/WAV/M4A และรูปแบบอื่นที่น่าจะเป็นเสียง จะถูกแปลงเป็น Ogg/Opus 48kHz ด้วย ffmpeg เฉพาะเมื่อการตอบกลับร้องขอการส่งแบบเสียงพูด (audioAsVoice / เครื่องมือข้อความ asVoice รวมถึงการตอบกลับโน้ตเสียง TTS) ไฟล์แนบ MP3 ทั่วไปจะยังคงเป็นไฟล์ปกติ หากไม่มี ffmpeg หรือการแปลงล้มเหลว OpenClaw จะย้อนกลับไปใช้ไฟล์แนบและบันทึกเหตุผลลงล็อก

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

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

สำหรับ groupSessionScope: "group_topic" และ "group_topic_sender" กลุ่มหัวข้อ Feishu/Lark แบบเนทีฟใช้ thread_id (omt_*) ของเหตุการณ์เป็นคีย์เซสชันหัวข้อ ตามรูปแบบบัญญัติ หากเหตุการณ์เริ่มหัวข้อแบบเนทีฟละเว้น thread_id OpenClaw จะเติมข้อมูลจาก Feishu ก่อนกำหนดเส้นทางเทิร์น การตอบกลับกลุ่มปกติที่ OpenClaw แปลงเป็นเธรดจะยังคงใช้ ID ข้อความรากของการตอบกลับ (om_*) เพื่อให้ เทิร์นแรกและเทิร์นติดตามยังอยู่ในเซสชันเดียวกัน

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

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