Feishu / Lark

Feishu/Lark adalah platform kolaborasi all-in-one tempat tim mengobrol, berbagi dokumen, mengelola kalender, dan menyelesaikan pekerjaan bersama. Status: siap produksi untuk DM bot + obrolan grup. WebSocket adalah mode default; mode webhook bersifat opsional.

Mulai cepat

Memerlukan OpenClaw 2026.4.10 atau yang lebih baru. Jalankan openclaw --version untuk memeriksa. Tingkatkan dengan openclaw update.

Jalankan wizard penyiapan saluran

openclaw channels login --channel feishu

Pindai kode QR dengan aplikasi seluler Feishu/Lark Anda untuk membuat bot Feishu/Lark secara otomatis.

Setelah penyiapan selesai, mulai ulang Gateway untuk menerapkan perubahan

openclaw gateway restart

Kontrol akses

Pesan langsung

Konfigurasikan dmPolicy untuk mengontrol siapa yang dapat mengirim DM ke bot:

"pairing" — pengguna yang tidak dikenal menerima kode pairing; setujui melalui CLI
"allowlist" — hanya pengguna yang tercantum dalam allowFrom yang dapat mengobrol (default: hanya pemilik bot)
"open" — izinkan semua pengguna
"disabled" — nonaktifkan semua DM

Setujui permintaan pairing:

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

Obrolan grup

Kebijakan grup (channels.feishu.groupPolicy):

Value	Perilaku
`"open"`	Merespons semua pesan di grup
`"allowlist"`	Hanya merespons grup dalam `groupAllowFrom`
`"disabled"`	Nonaktifkan semua pesan grup

Default: allowlist Persyaratan mention (channels.feishu.requireMention):

true — memerlukan @mention (default)
false — merespons tanpa @mention
Override per grup: channels.feishu.groups.<chat_id>.requireMention

Contoh konfigurasi grup

Izinkan semua grup, tidak memerlukan @mention

{
  channels: {
    feishu: {
      groupPolicy: "open",
    },
  },
}

Izinkan semua grup, tetapi tetap memerlukan @mention

{
  channels: {
    feishu: {
      groupPolicy: "open",
      requireMention: true,
    },
  },
}

Hanya izinkan grup tertentu

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // ID grup terlihat seperti: oc_xxx
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
    },
  },
}

Batasi pengirim dalam grup

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx"],
      groups: {
        oc_xxx: {
          // open_id pengguna terlihat seperti: ou_xxx
          allowFrom: ["ou_user1", "ou_user2"],
        },
      },
    },
  },
}

Dapatkan ID grup/pengguna

ID grup (`chat_id`, format: `oc_xxx`)

Buka grup di Feishu/Lark, klik ikon menu di sudut kanan atas, lalu buka Settings. ID grup (chat_id) tercantum di halaman pengaturan.

ID pengguna (`open_id`, format: `ou_xxx`)

Mulai Gateway, kirim DM ke bot, lalu periksa log:

openclaw logs --follow

Cari open_id pada output log. Anda juga dapat memeriksa permintaan pairing yang tertunda:

openclaw pairing list feishu

Perintah umum

Command	Deskripsi
`/status`	Tampilkan status bot
`/reset`	Reset sesi saat ini
`/model`	Tampilkan atau ganti model AI

Feishu/Lark tidak mendukung menu slash-command bawaan, jadi kirim ini sebagai pesan teks biasa.

Pemecahan masalah

Bot tidak merespons di obrolan grup

Pastikan bot telah ditambahkan ke grup
Pastikan Anda @mention bot (diperlukan secara default)
Verifikasi groupPolicy bukan "disabled"
Periksa log: openclaw logs --follow

Bot tidak menerima pesan

Pastikan bot telah dipublikasikan dan disetujui di Feishu Open Platform / Lark Developer
Pastikan langganan event mencakup im.message.receive_v1
Pastikan persistent connection (WebSocket) dipilih
Pastikan semua cakupan izin yang diperlukan telah diberikan
Pastikan Gateway sedang berjalan: openclaw gateway status
Periksa log: openclaw logs --follow

App Secret bocor

Reset App Secret di Feishu Open Platform / Lark Developer
Perbarui nilainya di konfigurasi Anda
Mulai ulang Gateway: openclaw gateway restart

Konfigurasi lanjutan

Beberapa akun

{
  channels: {
    feishu: {
      defaultAccount: "main",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          name: "Bot utama",
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          name: "Bot cadangan",
          enabled: false,
        },
      },
    },
  },
}

defaultAccount mengontrol akun mana yang digunakan saat API keluar tidak menentukan accountId.

Batas pesan

textChunkLimit — ukuran potongan teks keluar (default: 2000 karakter)
mediaMaxMb — batas unggah/unduh media (default: 30 MB)

Streaming

Feishu/Lark mendukung balasan streaming melalui kartu interaktif. Saat diaktifkan, bot memperbarui kartu secara real time saat menghasilkan teks.

{
  channels: {
    feishu: {
      streaming: true, // aktifkan output kartu streaming (default: true)
      blockStreaming: true, // aktifkan streaming tingkat blok (default: true)
    },
  },
}

Setel streaming: false untuk mengirim balasan lengkap dalam satu pesan.

Optimasi kuota

Kurangi jumlah panggilan API Feishu/Lark dengan dua flag opsional:

typingIndicator (default true): setel ke false untuk melewati panggilan reaksi mengetik
resolveSenderNames (default true): setel ke false untuk melewati lookup profil pengirim

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

Sesi ACP

Feishu/Lark mendukung ACP untuk DM dan pesan thread grup. ACP Feishu/Lark digerakkan oleh perintah teks — tidak ada menu slash-command bawaan, jadi gunakan pesan /acp ... langsung di percakapan.

Binding ACP persisten

{
  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 dari obrolan

Di DM atau thread Feishu/Lark:

/acp spawn codex --thread here

--thread here berfungsi untuk DM dan pesan thread Feishu/Lark. Pesan lanjutan dalam percakapan yang dibinding akan diarahkan langsung ke sesi ACP tersebut.

Perutean multi-agent

Gunakan bindings untuk merutekan DM atau grup Feishu/Lark ke agent yang berbeda.

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

Bidang perutean:

match.channel: "feishu"
match.peer.kind: "direct" (DM) atau "group" (obrolan grup)
match.peer.id: Open ID pengguna (ou_xxx) atau ID grup (oc_xxx)

Lihat Dapatkan ID grup/pengguna untuk tips pencarian.

Referensi konfigurasi

Konfigurasi lengkap: Konfigurasi Gateway

Setting	Deskripsi	Default
`channels.feishu.enabled`	Aktifkan/nonaktifkan saluran	`true`
`channels.feishu.domain`	Domain API (`feishu` atau `lark`)	`feishu`
`channels.feishu.connectionMode`	Transport event (`websocket` atau `webhook`)	`websocket`
`channels.feishu.defaultAccount`	Akun default untuk perutean keluar	`default`
`channels.feishu.verificationToken`	Diperlukan untuk mode webhook	—
`channels.feishu.encryptKey`	Diperlukan untuk mode webhook	—
`channels.feishu.webhookPath`	Jalur rute webhook	`/feishu/events`
`channels.feishu.webhookHost`	Host bind webhook	`127.0.0.1`
`channels.feishu.webhookPort`	Port bind webhook	`3000`
`channels.feishu.accounts.<id>.appId`	App ID	—
`channels.feishu.accounts.<id>.appSecret`	App Secret	—
`channels.feishu.accounts.<id>.domain`	Override domain per akun	`feishu`
`channels.feishu.dmPolicy`	Kebijakan DM	`allowlist`
`channels.feishu.allowFrom`	Allowlist DM (daftar `open_id`)	[BotOwnerId]
`channels.feishu.groupPolicy`	Kebijakan grup	`allowlist`
`channels.feishu.groupAllowFrom`	Allowlist grup	—
`channels.feishu.requireMention`	Memerlukan @mention di grup	`true`
`channels.feishu.groups.<chat_id>.requireMention`	Override @mention per grup	inherited
`channels.feishu.groups.<chat_id>.enabled`	Aktifkan/nonaktifkan grup tertentu	`true`
`channels.feishu.textChunkLimit`	Ukuran potongan pesan	`2000`
`channels.feishu.mediaMaxMb`	Batas ukuran media	`30`
`channels.feishu.streaming`	Output kartu streaming	`true`
`channels.feishu.blockStreaming`	Streaming tingkat blok	`true`
`channels.feishu.typingIndicator`	Kirim reaksi mengetik	`true`
`channels.feishu.resolveSenderNames`	Resolve nama tampilan pengirim	`true`

Jenis pesan yang didukung

Terima

✅ Teks
✅ Teks kaya (post)
✅ Gambar
✅ File
✅ Audio
✅ Video/media
✅ Stiker

Kirim

✅ Teks
✅ Gambar
✅ File
✅ Audio
✅ Video/media
✅ Kartu interaktif (termasuk pembaruan streaming)
⚠️ Teks kaya (pemformatan gaya post; tidak mendukung seluruh kemampuan authoring Feishu/Lark)

Thread dan balasan

✅ Balasan inline
✅ Balasan thread
✅ Balasan media tetap sadar-thread saat membalas pesan thread

Terkait

Ikhtisar Saluran — semua saluran yang didukung
Pairing — autentikasi DM dan alur pairing
Grup — perilaku obrolan grup dan pembatasan mention
Perutean Saluran — perutean sesi untuk pesan
Keamanan — model akses dan hardening

Overview

Messaging platforms

Configuration

Feishu

Feishu / Lark

Mulai cepat

Kontrol akses

Pesan langsung

Obrolan grup

Contoh konfigurasi grup

Izinkan semua grup, tidak memerlukan @mention

Izinkan semua grup, tetapi tetap memerlukan @mention

Hanya izinkan grup tertentu

Batasi pengirim dalam grup

Dapatkan ID grup/pengguna

ID grup (`chat_id`, format: `oc_xxx`)

ID pengguna (`open_id`, format: `ou_xxx`)

Perintah umum

Pemecahan masalah

Bot tidak merespons di obrolan grup

Bot tidak menerima pesan

App Secret bocor

Konfigurasi lanjutan

Beberapa akun

Batas pesan

Streaming

Optimasi kuota

Sesi ACP

Binding ACP persisten

Spawn ACP dari obrolan

Perutean multi-agent

Referensi konfigurasi

Jenis pesan yang didukung

Terima

Kirim

Thread dan balasan

Terkait

Overview

Messaging platforms

Configuration

​Feishu / Lark

​Mulai cepat

​Kontrol akses

​Pesan langsung

​Obrolan grup

​Contoh konfigurasi grup

​Izinkan semua grup, tidak memerlukan @mention

​Izinkan semua grup, tetapi tetap memerlukan @mention

​Hanya izinkan grup tertentu

​Batasi pengirim dalam grup

​Dapatkan ID grup/pengguna

​ID grup (chat_id, format: oc_xxx)

​ID pengguna (open_id, format: ou_xxx)

​Perintah umum

​Pemecahan masalah

​Bot tidak merespons di obrolan grup

​Bot tidak menerima pesan

​App Secret bocor

​Konfigurasi lanjutan

​Beberapa akun

​Batas pesan

​Streaming

​Optimasi kuota

​Sesi ACP

​Binding ACP persisten

​Spawn ACP dari obrolan

​Perutean multi-agent

​Referensi konfigurasi

​Jenis pesan yang didukung

​Terima

​Kirim

​Thread dan balasan

​Terkait

Feishu / Lark

Mulai cepat

Kontrol akses

Pesan langsung

Obrolan grup

Contoh konfigurasi grup

Izinkan semua grup, tidak memerlukan @mention

Izinkan semua grup, tetapi tetap memerlukan @mention

Hanya izinkan grup tertentu

Batasi pengirim dalam grup

Dapatkan ID grup/pengguna

ID grup (`chat_id`, format: `oc_xxx`)

ID pengguna (`open_id`, format: `ou_xxx`)

Perintah umum

Pemecahan masalah

Bot tidak merespons di obrolan grup

Bot tidak menerima pesan

App Secret bocor

Konfigurasi lanjutan

Beberapa akun

Batas pesan

Streaming

Optimasi kuota

Sesi ACP

Binding ACP persisten

Spawn ACP dari obrolan

Perutean multi-agent

Referensi konfigurasi

Jenis pesan yang didukung

Terima

Kirim

Thread dan balasan

Terkait