Feishu

OpenClaw เชื่อมต่อกับ Feishu/Lark (แพลตฟอร์มการทำงานร่วมกันแบบครบวงจร) ผ่าน Plugin อย่างเป็นทางการ @openclaw/feishu: DM ของบอต แชตกลุ่ม การตอบกลับด้วยการ์ดแบบสตรีม และเครื่องมือเอกสาร/วิกิ/ไดรฟ์/Bitable ของ Feishu

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

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

openclaw channels login --channel feishu

openclaw gateway restart

ความคงทนของข้อมูลขาเข้า

OpenClaw จะจัดคิวซองข้อมูล im.message.receive_v1 และ drive.notice.comment_add_v1 ที่ผ่านการยืนยันตัวตนอย่างคงทนก่อนส่งต่อไปยังเอเจนต์ เหตุการณ์ที่รอดำเนินการหรือสามารถลองใหม่ได้จะยังคงอยู่หลังรีสตาร์ต Gateway โดยยังประมวลผลตามลำดับต่อแชตหรือเอกสาร และใช้ ID เหตุการณ์ของ Feishu เพื่อระงับรายการคิวซ้ำตราบใดที่ยังมีระเบียนการเสร็จสิ้นที่กำลังใช้งานหรือเก็บรักษาไว้

หากไม่สามารถบันทึกเหตุการณ์ WebSocket อย่างถาวรได้หลังจากลองใหม่ตามจำนวนครั้งที่จำกัด OpenClaw จะปิดซ็อกเก็ตนั้นและบังคับให้สร้างการเชื่อมต่อใหม่ที่ผ่านการยืนยันตัวตน แทนที่จะดำเนินการต่อหลังเทิร์นที่ยังไม่ได้คอมมิต เหตุการณ์ Feishu ประเภทอื่น รวมถึงรีแอ็กชันและคำเชิญประชุม VC จะใช้เส้นทางเหตุการณ์ตามปกติและไม่ได้รับการรับประกันคิวแบบคงทนนี้

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

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

กำหนดค่า channels.feishu.dmPolicy (ค่าเริ่มต้น: pairing) เพื่อควบคุมว่าใครสามารถส่ง DM ถึงบอตได้:

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

openclaw pairing list feishuopenclaw pairing approve feishu <CODE>

แชตกลุ่ม

นโยบายกลุ่ม (channels.feishu.groupPolicy, ค่าเริ่มต้น: allowlist):

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

• ค่าเริ่มต้น: ต้อง @กล่าวถึง ยกเว้นเมื่อนโยบายกลุ่มที่มีผลคือ "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",      // ID กลุ่มมีลักษณะดังนี้: 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: {          // open_id ของผู้ใช้มีลักษณะดังนี้: ou_xxx          allowFrom: ["ou_user1", "ou_user2"],        },      },    },  },}

channels.feishu.groupSenderAllowFrom กำหนดรายการอนุญาตผู้ส่งเดียวกันสำหรับทุกกลุ่ม ส่วน allowFrom รายกลุ่มมีลำดับความสำคัญสูงกว่า

ข้อความที่เขียนโดยบอต

ตามค่าเริ่มต้น Feishu จะละเว้นข้อความที่เขียนโดยบอตอื่น หากต้องการอนุญาตการสนทนาระหว่างบอตในกลุ่ม ให้มอบขอบเขต im:message.group_at_msg.include_bot:readonly และ im:message:readonly แก่แอป จากนั้นตั้งค่า allowBots:

{  channels: {    feishu: {      allowBots: true,    },  },}

Feishu จะส่งเหตุการณ์กลุ่มที่เขียนโดยบอตต่อเมื่อบอตอื่นกล่าวถึงบอตนี้เท่านั้น นโยบายกลุ่ม รายการอนุญาตผู้ส่ง และข้อกำหนดการกล่าวถึงที่มีอยู่ยังคงมีผล OpenClaw จะทิ้งข้อความที่เขียนโดยตัวเอง กล่าวถึงบอตอีกฝ่ายในการตอบกลับด้วยข้อความหรือการ์ดทุกครั้ง และใช้กลไกป้องกัน channels.defaults.botLoopProtection ที่ใช้ร่วมกัน

รับ 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. ตรวจสอบว่าคุณ @กล่าวถึงบอต (จำเป็นตามค่าเริ่มต้น)
3. ตรวจสอบว่า groupPolicy ไม่ใช่ "disabled"
4. ตรวจสอบบันทึก: openclaw logs --follow

บอตไม่ได้รับข้อความ

1. ตรวจสอบว่าบอตได้รับการเผยแพร่และอนุมัติใน Feishu Open Platform / Lark Developer แล้ว
2. ตรวจสอบว่าการสมัครรับเหตุการณ์มี im.message.receive_v1
3. สำหรับการเข้าร่วมคำเชิญประชุมโดยอัตโนมัติ ให้สมัครรับ vc.bot.meeting_invited_v1 ด้วย
4. ตรวจสอบว่าเลือก persistent connection (WebSocket) แล้ว
5. ตรวจสอบว่าได้รับขอบเขตสิทธิ์ที่จำเป็นทั้งหมดแล้ว
6. ตรวจสอบว่า Gateway กำลังทำงาน: openclaw gateway status
7. ตรวจสอบบันทึก: openclaw logs --follow

การสมัครรับ vc.bot.meeting_invited_v1 มีไว้เพื่อส่งเหตุการณ์เท่านั้น การเข้าร่วมอัตโนมัติจะ ปิดใช้งานตามค่าเริ่มต้น หากต้องการเปิดใช้ทั่วทั้งระบบ:

{  channels: {    feishu: {      vcAutoJoin: true,    },  },}

หากต้องการเปิดใช้เพียงบัญชีเดียว ให้ละเว้นสวิตช์ระดับบนสุดและตั้งค่าลบล้างสำหรับบัญชี:

{  channels: {    feishu: {      accounts: {        meetings: { vcAutoJoin: true },      },    },  },}

ผู้เชิญยังคงต้องผ่านนโยบาย DM ของ Feishu ตามปกติ รายการอนุญาต/การจับคู่ เซสชัน และการกำหนดเส้นทาง การตอบกลับ ก่อนที่เอเจนต์จะได้รับเทิร์นการเข้าร่วม การเข้าร่วมยังกำหนดให้มีเครื่องมือเข้าร่วม Feishu VC ที่พร้อมใช้งาน ซึ่งกำหนดค่าสำหรับข้อมูลประจำตัวของแอปพร้อมขอบเขต vc:meeting.bot.join:write ตัวอย่างเช่น Skills เอเจนต์ VC อย่างเป็นทางการ lark-cli มี vc +meeting-join

การตั้งค่าด้วย 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,        },      },    },  },}

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

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

• textChunkLimit - ขนาดส่วนข้อความขาออก (ค่าเริ่มต้น: 4000 อักขระ)
• streaming.chunkMode - "length" (ค่าเริ่มต้น) จะแบ่งเมื่อถึงขีดจำกัด ส่วน "newline" จะให้ความสำคัญกับขอบเขตบรรทัดใหม่
• mediaMaxMb - ขีดจำกัดการอัปโหลด/ดาวน์โหลดสื่อ (ค่าเริ่มต้น: 30 MB)

การสตรีม

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

{  channels: {    feishu: {      streaming: {        mode: "partial", // ผลลัพธ์การ์ดแบบสตรีม (ค่าเริ่มต้น: "partial")        block: { enabled: true }, // เลือกใช้การสตรีมบล็อกที่เสร็จสมบูรณ์      },    },  },}

ตั้งค่า streaming.mode: "off" เพื่อส่งคำตอบฉบับสมบูรณ์ในข้อความเดียว ส่วน renderMode: "raw" (ข้อความธรรมดาแทนการ์ด) จะปิดใช้การ์ดแบบสตรีมด้วยเช่นกัน โดยค่าเริ่มต้น streaming.block.enabled จะปิดอยู่ ให้เปิดใช้เฉพาะเมื่อต้องการส่งบล็อกคำตอบของผู้ช่วยที่เสร็จแล้วออกไปก่อนคำตอบสุดท้าย ค่าแบบบูลีนเดิม streaming และคีย์แบบแบน blockStreaming / blockStreamingCoalesce / chunkMode จะย้ายไปเป็นโครงสร้างแบบซ้อนนี้ผ่าน openclaw doctor --fix

การเพิ่มประสิทธิภาพโควตา

ลดจำนวนการเรียก Feishu/Lark API ด้วยแฟล็กเสริม 2 รายการ:

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

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

ขอบเขตเซสชันกลุ่มและเธรดหัวข้อ

channels.feishu.groupSessionScope (ระดับบนสุด ต่อบัญชี หรือต่อกลุ่ม) ควบคุมวิธีแมปข้อความกลุ่มกับเซสชันของเอเจนต์:

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

ตั้งค่า replyInThread: "enabled" (ระดับบนสุดหรือต่อกลุ่ม) เพื่อให้คำตอบของบอตสร้างหรือดำเนินเธรดหัวข้อ Feishu ต่อ แทนการตอบแบบอินไลน์ topicSessionMode เป็นรุ่นก่อนหน้าที่เลิกใช้แล้วของ groupSessionScope ให้เลือกใช้ groupSessionScope

เครื่องมือพื้นที่ทำงาน Feishu

Plugin มาพร้อมเครื่องมือเอเจนต์สำหรับเอกสาร แชต ฐานความรู้ พื้นที่จัดเก็บบนคลาวด์ สิทธิ์ และ Bitable ของ Feishu พร้อม Skills ที่สอดคล้องกัน (feishu-doc, feishu-drive, feishu-perm, feishu-wiki) กลุ่มเครื่องมือควบคุมด้วย channels.feishu.tools:

tools.base เป็นนามแฝงของ tools.bitable โดยค่า bitable ที่ระบุชัดเจนจะมีผลเหนือกว่าเมื่อตั้งค่าทั้งคู่ การควบคุมต่อบัญชีอยู่ภายใต้ accounts.<id>.tools

ให้สิทธิ์ drive:drive.metadata:readonly สำหรับการค้นหา feishu_drive info โดยตรงนอกไดเรกทอรีราก เว้นแต่แอปจะมีขอบเขต drive:drive แบบเต็มอยู่แล้ว หากไม่มีขอบเขตใดเลย info จะคงการค้นหาไดเรกทอรีรากแบบเดิมที่ใช้งานผ่าน drive:drive:readonly ไว้

เซสชัน ACP

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

ใน 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 แต่ละราย ผู้ใช้แต่ละรายจะได้รับ:

• ไดเรกทอรีพื้นที่ทำงานอิสระ
• 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: {    // สำคัญ: ทำให้ DM ของผู้ใช้แต่ละรายเป็น "เซสชันหลัก"    // โหลด USER.md / SOUL.md / MEMORY.md โดยอัตโนมัติ    // หากต้องการการแยกที่เข้มงวดยิ่งขึ้น ให้ใช้ "per-channel-peer" แทน    dmScope: "main",  },}

วิธีการทำงาน

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

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

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

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

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

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

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

ข้อแลกเปลี่ยน: การใช้ "main" จะเปิดใช้การโหลดไฟล์บูตสแตรปโดยอัตโนมัติ (USER.md, SOUL.md, MEMORY.md) แต่หมายความว่า DM ทั้งหมดในทุกช่องทางจะใช้รูปแบบคีย์เซสชันเดียวกัน สำหรับบอตสาธารณะแบบหลายผู้ใช้ที่การแยกสำคัญกว่าการโหลดบูตสแตรปอัตโนมัติ ให้พิจารณา "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: {    // เลือก dmScope ตามความต้องการด้านการแยก:    // "main" สำหรับการโหลดบูตสแตรปอัตโนมัติ และ "per-channel-peer" สำหรับการแยกที่เข้มงวดยิ่งขึ้น    dmScope: "main",  },  bindings: [], // ว่างไว้ - เอเจนต์แบบไดนามิกจะผูกโดยอัตโนมัติ}

การตรวจสอบ

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

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

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

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

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

รับ

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

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

ส่ง

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

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

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

การกำหนดเส้นทางเซสชันตามกลุ่มหัวข้ออธิบายไว้ใน ขอบเขตเซสชันกลุ่มและเธรดหัวข้อ

เนื้อหาที่เกี่ยวข้อง

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