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 feishu
openclaw 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. ตรวจสอบว่าเลือก การเชื่อมต่อแบบถาวร (WebSocket)
4. ตรวจสอบว่าได้มอบขอบเขตสิทธิ์ที่จำเป็นทั้งหมดแล้ว
5. ตรวจสอบว่า Gateway กำลังทำงานอยู่: openclaw gateway status
6. ตรวจสอบบันทึก: openclaw logs --follow

# 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 แบบหลายบอตสามารถเก็บข้อมูลประจำตัว ของผู้ให้บริการร่วมไว้ที่ส่วนกลาง ในขณะที่เขียนทับเฉพาะเสียง โมเดล 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 ปิดอยู่ตามค่าเริ่มต้น เปิดใช้เฉพาะเมื่อคุณต้องการส่งบล็อกของผู้ช่วยที่เสร็จแล้วออกไปก่อนคำตอบสุดท้าย

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

ลดจำนวนการเรียก 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 แบบเนทีฟ ดังนั้นให้ใช้ข้อความ /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 กลุ่ม/ผู้ใช้ สำหรับเคล็ดลับการค้นหา

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

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

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

# รับ

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

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

# ส่ง

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