Feishu

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

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

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

openclaw channels login --channel feishu

openclaw gateway restart

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

ข้อความส่วนตัว

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

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

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

openclaw pairing list feishuopenclaw pairing approve feishu <CODE>

แชตกลุ่ม

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

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

ข้อกำหนดการ mention (channels.feishu.requireMention):

• true - ต้องมี @mention (ค่าเริ่มต้น)
• false - ตอบกลับโดยไม่ต้องมี @mention
• override ต่อกลุ่ม: channels.feishu.groups.<chat_id>.requireMention
• @all และ @_all แบบประกาศถึงทุกคนเท่านั้นจะไม่ถือว่าเป็นการ mention บอต ข้อความที่ mention ทั้ง @all และบอตโดยตรงยังคงนับว่าเป็นการ 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"],    },  },}

ในโหมด allowlist คุณยังสามารถอนุญาตกลุ่มได้โดยเพิ่มรายการ groups.<chat_id> อย่างชัดเจน รายการที่ระบุชัดเจนจะไม่แทนที่ groupPolicy: "disabled" ค่าเริ่มต้นแบบไวลด์การ์ดภายใต้ 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 คลิกไอคอนเมนูที่มุมขวาบน แล้วไปที่ Settings 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. ตรวจสอบว่าได้รับ permission scope ที่จำเป็นทั้งหมดแล้ว
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 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 ที่ใช้ร่วมกันไว้ในระดับส่วนกลาง ขณะ override เฉพาะเสียง โมเดล 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 เพื่อข้ามการเรียก reaction ระหว่างพิมพ์
• resolveSenderNames (ค่าเริ่มต้น true): ตั้งค่า false เพื่อข้ามการค้นหาโปรไฟล์ผู้ส่ง

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

เซสชัน ACP

Feishu/Lark รองรับ ACP สำหรับ DM และข้อความเธรดกลุ่ม ACP ของ Feishu/Lark ขับเคลื่อนด้วยคำสั่งข้อความ - ไม่มีเมนูคำสั่ง slash-command แบบเนทีฟ ดังนั้นให้ใช้ข้อความ /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 ข้อความติดตามผลในบทสนทนาที่ผูกไว้จะถูก route ไปยังเซสชัน ACP นั้นโดยตรง

การ route แบบหลายเอเจนต์

ใช้ bindings เพื่อ route 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" },      },    },  ],}

ฟิลด์การ route:

• 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 และ state ที่แยกกัน

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

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

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

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

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

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

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

{  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

แสดงรายการ workspace ทั้งหมดที่สร้างแล้ว:

ls -la ~/.openclaw/workspace-*

หมายเหตุ

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

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

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

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

รับ

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

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

ส่ง

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

บับเบิลเสียงเนทีฟของ Feishu/Lark ใช้ชนิดข้อความ audio ของ Feishu และต้องมี สื่ออัปโหลด 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 และโฟลว์การจับคู่
• กลุ่ม - พฤติกรรมแชตกลุ่มและการ gating การกล่าวถึง
• การกำหนดเส้นทางช่องทาง - การกำหนดเส้นทางเซสชันสำหรับข้อความ
• ความปลอดภัย - โมเดลการเข้าถึงและการเสริมความแข็งแกร่ง