​

Bot Feishu

​

Plugin bawaan

openclaw plugins install @openclaw/feishu

​

Mulai cepat

​

Metode 1: onboarding (direkomendasikan)

openclaw onboard

1. Membuat aplikasi Feishu dan mengumpulkan kredensial
2. Mengonfigurasi kredensial aplikasi di OpenClaw
3. Menjalankan gateway

• openclaw gateway status
• openclaw logs --follow

​

Metode 2: penyiapan CLI

openclaw channels add

• openclaw gateway status
• openclaw gateway restart
• openclaw logs --follow

​

Langkah 1: Buat aplikasi Feishu

​

1. Buka Feishu Open Platform

​

2. Buat aplikasi

1. Klik Create enterprise app
2. Isi nama + deskripsi aplikasi
3. Pilih ikon aplikasi

​

3. Salin kredensial

• App ID (format: cli_xxx)
• App Secret

​

4. Konfigurasikan izin

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

​

5. Aktifkan kemampuan bot

1. Aktifkan kemampuan bot
2. Tetapkan nama bot

​

6. Konfigurasikan langganan peristiwa

1. Anda sudah menjalankan openclaw channels add untuk Feishu
2. Gateway sedang berjalan (openclaw gateway status)

1. Pilih Use long connection to receive events (WebSocket)
2. Tambahkan peristiwa: im.message.receive_v1
3. (Opsional) Untuk alur kerja komentar Drive, tambahkan juga: drive.notice.comment_add_v1

​

7. Publikasikan aplikasi

1. Buat versi di Version Management & Release
2. Kirim untuk peninjauan dan publikasikan
3. Tunggu persetujuan admin (aplikasi enterprise biasanya disetujui otomatis)

​

Langkah 2: Konfigurasikan OpenClaw

​

Konfigurasikan dengan wizard (direkomendasikan)

openclaw channels add

​

Konfigurasikan melalui file konfigurasi

{
  channels: {
    feishu: {
      enabled: true,
      dmPolicy: "pairing",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          name: "My AI assistant",
        },
      },
    },
  },
}

​

Verification Token dan Encrypt Key (mode webhook)

1. Di Feishu Open Platform, buka aplikasi Anda
2. Buka Development → Events & Callbacks (开发配置 → 事件与回调)
3. Buka tab Encryption (加密策略)
4. Salin Verification Token dan Encrypt Key

​

Konfigurasikan melalui variabel lingkungan

export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"

​

Domain Lark (global)

{
  channels: {
    feishu: {
      domain: "lark",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
        },
      },
    },
  },
}

​

Flag optimasi kuota

• typingIndicator (default true): saat false, lewati panggilan reaksi mengetik.
• resolveSenderNames (default true): saat false, lewati panggilan pencarian profil pengirim.

{
  channels: {
    feishu: {
      typingIndicator: false,
      resolveSenderNames: false,
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          typingIndicator: true,
          resolveSenderNames: false,
        },
      },
    },
  },
}

​

Langkah 3: Jalankan + uji

​

1. Jalankan gateway

openclaw gateway

​

2. Kirim pesan uji

​

3. Setujui pairing

openclaw pairing approve feishu <CODE>

​

Ikhtisar

• Channel bot Feishu: bot Feishu yang dikelola oleh gateway
• Routing deterministik: balasan selalu kembali ke Feishu
• Isolasi sesi: DM berbagi satu sesi utama; grup diisolasi
• Koneksi WebSocket: long connection melalui SDK Feishu, tidak memerlukan URL publik

​

Kontrol akses

​

Pesan langsung

• Default: dmPolicy: "pairing" (pengguna yang tidak dikenal mendapatkan kode pairing)
• Setujui pairing:
  openclaw pairing list feishu
  openclaw pairing approve feishu <CODE>
  
• Mode allowlist: tetapkan channels.feishu.allowFrom dengan Open ID yang diizinkan

​

Obrolan grup

• "open" = izinkan semua orang di grup
• "allowlist" = hanya izinkan groupAllowFrom
• "disabled" = nonaktifkan pesan grup

• true eksplisit = memerlukan @mention
• false eksplisit = merespons tanpa mention
• jika tidak ditetapkan dan groupPolicy: "open" = default ke false
• jika tidak ditetapkan dan groupPolicy bukan "open" = default ke true

​

Contoh konfigurasi grup

​

Izinkan semua grup, tanpa @mention wajib (default untuk grup terbuka)

{
  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",
      // Feishu group IDs (chat_id) look like: oc_xxx
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
    },
  },
}

​

Batasi pengirim mana yang dapat mengirim pesan dalam grup (allowlist pengirim)

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx"],
      groups: {
        oc_xxx: {
          // Feishu user IDs (open_id) look like: ou_xxx
          allowFrom: ["ou_user1", "ou_user2"],
        },
      },
    },
  },
}

​

Dapatkan ID grup/pengguna

​

ID grup (chat_id)

1. Jalankan gateway dan lakukan @mention pada bot di grup
2. Jalankan openclaw logs --follow dan cari chat_id

​

ID pengguna (open_id)

1. Jalankan gateway dan kirim DM ke bot
2. Jalankan openclaw logs --follow dan cari open_id

openclaw pairing list feishu

​

Perintah umum

Catatan: Feishu belum mendukung menu perintah native, jadi perintah harus dikirim sebagai teks.

​

Perintah manajemen gateway

​

Pemecahan masalah

​

Bot tidak merespons di obrolan grup

1. Pastikan bot sudah ditambahkan ke grup
2. Pastikan Anda melakukan @mention pada bot (perilaku default)
3. Periksa groupPolicy tidak disetel ke "disabled"
4. Periksa log: openclaw logs --follow

​

Bot tidak menerima pesan

1. Pastikan aplikasi sudah dipublikasikan dan disetujui
2. Pastikan langganan peristiwa menyertakan im.message.receive_v1
3. Pastikan long connection diaktifkan
4. Pastikan izin aplikasi sudah lengkap
5. Pastikan gateway sedang berjalan: openclaw gateway status
6. Periksa log: openclaw logs --follow

​

Kebocoran App Secret

1. Reset App Secret di Feishu Open Platform
2. Perbarui App Secret di konfigurasi Anda
3. Mulai ulang gateway

​

Kegagalan pengiriman pesan

1. Pastikan aplikasi memiliki izin im:message:send_as_bot
2. Pastikan aplikasi sudah dipublikasikan
3. Periksa log untuk error yang lebih rinci

​

Konfigurasi lanjutan

​

Banyak akun

{
  channels: {
    feishu: {
      defaultAccount: "main",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          name: "Primary bot",
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          name: "Backup bot",
          enabled: false,
        },
      },
    },
  },
}

​

Batas pesan

• textChunkLimit: ukuran potongan teks outbound (default: 2000 karakter)
• mediaMaxMb: batas upload/download media (default: 30MB)

​

Streaming

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

​

Sesi ACP

• DM
• percakapan topik grup

​

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 terikat thread dari obrolan

/acp spawn codex --thread here

• --thread here berfungsi untuk DM dan topik Feishu.
• Pesan lanjutan dalam DM/topik yang terikat dirutekan langsung ke sesi ACP tersebut.
• v1 tidak menargetkan obrolan grup umum tanpa topik.

​

Routing multi-agent

{
  agents: {
    list: [
      { id: "main" },
      {
        id: "clawd-fan",
        workspace: "/home/user/clawd-fan",
        agentDir: "/home/user/.openclaw/agents/clawd-fan/agent",
      },
      {
        id: "clawd-xi",
        workspace: "/home/user/clawd-xi",
        agentDir: "/home/user/.openclaw/agents/clawd-xi/agent",
      },
    ],
  },
  bindings: [
    {
      agentId: "main",
      match: {
        channel: "feishu",
        peer: { kind: "direct", id: "ou_xxx" },
      },
    },
    {
      agentId: "clawd-fan",
      match: {
        channel: "feishu",
        peer: { kind: "direct", id: "ou_yyy" },
      },
    },
    {
      agentId: "clawd-xi",
      match: {
        channel: "feishu",
        peer: { kind: "group", id: "oc_zzz" },
      },
    },
  ],
}

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

​

Referensi konfigurasi

​

Referensi dmPolicy

​

Jenis pesan yang didukung

​

Menerima

• ✅ Teks
• ✅ Rich text (post)
• ✅ Gambar
• ✅ File
• ✅ Audio
• ✅ Video/media
• ✅ Stiker

​

Mengirim

• ✅ Teks
• ✅ Gambar
• ✅ File
• ✅ Audio
• ✅ Video/media
• ✅ Kartu interaktif
• ⚠️ Rich text (pemformatan gaya post dan kartu, bukan fitur authoring Feishu yang sewenang-wenang)

​

Thread dan balasan

• ✅ Balasan inline
• ✅ Balasan topic-thread saat Feishu mengekspos reply_in_thread
• ✅ Balasan media tetap sadar thread saat membalas pesan thread/topik

​

Komentar Drive

• Berlangganan ke drive.notice.comment_add_v1 di pengaturan langganan peristiwa aplikasi Feishu Anda (bersama im.message.receive_v1 yang sudah ada)
• Tool Drive aktif secara default; nonaktifkan dengan channels.feishu.tools.drive: false

• teks komentar dan pengirim
• metadata dokumen (judul, jenis, URL)
• konteks thread komentar untuk balasan dalam thread

​

Permukaan tindakan runtime

• send
• read
• edit
• thread-reply
• pin
• list-pins
• unpin
• member-info
• channel-info
• channel-list
• react dan reactions saat reaksi diaktifkan dalam konfigurasi
• tindakan komentar feishu_drive: list_comments, list_comment_replies, add_comment, reply_comment

​

Terkait

• Channels Overview — semua channel yang didukung
• Pairing — autentikasi DM dan alur pairing
• Groups — perilaku obrolan grup dan pembatasan mention
• Channel Routing — routing sesi untuk pesan
• Security — model akses dan penguatan