Feishu

​

Mulai cepat

openclaw channels login --channel feishu

openclaw gateway restart

​

Kontrol akses

​

Pesan langsung

• "pairing" - pengguna tidak dikenal menerima kode pairing; setujui melalui CLI
• "allowlist" - hanya pengguna yang tercantum di allowFrom yang dapat mengobrol
• "open" - izinkan DM publik hanya ketika allowFrom menyertakan "*"; dengan entri yang membatasi, hanya pengguna yang cocok yang dapat mengobrol

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

Obrolan grup

• true - mewajibkan @mention (default)
• false - merespons tanpa @mention
• Override per grup: channels.feishu.groups.<chat_id>.requireMention
• @all dan @_all yang hanya untuk siaran tidak diperlakukan sebagai mention bot. Pesan yang menyebut @all dan bot secara langsung tetap dihitung sebagai mention bot.

​

Contoh konfigurasi grup

​

Izinkan semua grup, tidak perlu @mention

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

​

Izinkan semua grup, tetap wajibkan @mention

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

​

Izinkan hanya grup tertentu

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // Group IDs look like: oc_xxx
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
    },
  },
}

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groups: {
        oc_xxx: {
          requireMention: false,
        },
      },
    },
  },
}

​

Batasi pengirim dalam grup

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx"],
      groups: {
        oc_xxx: {
          // User open_ids look like: ou_xxx
          allowFrom: ["ou_user1", "ou_user2"],
        },
      },
    },
  },
}

​

Dapatkan ID grup/pengguna

​

ID grup (chat_id, format: oc_xxx)

​

ID pengguna (open_id, format: ou_xxx)

openclaw logs --follow

openclaw pairing list feishu

​

Perintah umum

​

Pemecahan masalah

​

Bot tidak merespons dalam obrolan grup

1. Pastikan bot ditambahkan ke grup
2. Pastikan Anda @mention bot (wajib secara default)
3. Verifikasi groupPolicy bukan "disabled"
4. Periksa log: openclaw logs --follow

​

Bot tidak menerima pesan

1. Pastikan bot dipublikasikan dan disetujui di Feishu Open Platform / Lark Developer
2. Pastikan langganan event menyertakan im.message.receive_v1
3. Pastikan persistent connection (WebSocket) dipilih
4. Pastikan semua cakupan izin yang diperlukan diberikan
5. Pastikan gateway berjalan: openclaw gateway status
6. Periksa log: openclaw logs --follow

​

Penyiapan QR tidak bereaksi di aplikasi seluler Feishu

1. Jalankan ulang penyiapan: openclaw channels login --channel feishu
2. Pilih penyiapan manual
3. Di Feishu Open Platform, buat aplikasi self-built dan salin App ID serta App Secret-nya
4. Tempelkan kredensial tersebut ke wizard penyiapan

​

App Secret bocor

1. Reset App Secret di Feishu Open Platform / Lark Developer
2. Perbarui nilai dalam config Anda
3. Mulai ulang gateway: openclaw gateway restart

​

Konfigurasi lanjutan

​

Beberapa akun

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

​

Batas pesan

• textChunkLimit - ukuran chunk teks keluar (default: 2000 karakter)
• mediaMaxMb - batas unggah/unduh media (default: 30 MB)

​

Streaming

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

​

Optimisasi kuota

• typingIndicator (default true): tetapkan false untuk melewati panggilan reaksi mengetik
• resolveSenderNames (default true): tetapkan false untuk melewati pencarian profil pengirim

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

​

Sesi ACP

​

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

/acp spawn codex --thread here

​

Routing multi-agen

{
  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) atau "group" (obrolan grup)
• match.peer.id: Open ID pengguna (ou_xxx) atau ID grup (oc_xxx)

​

Isolasi agen per pengguna (Pembuatan Agen Dinamis)

• Direktori workspace independen
• USER.md / SOUL.md / MEMORY.md terpisah
• Riwayat percakapan pribadi
• Skills dan state terisolasi

​

Penyiapan cepat

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

​

Cara kerjanya

1. Channel menghasilkan agentId unik: feishu-{user_open_id} untuk akun default, atau digest identitas dengan awalan akun dan berbatas untuk akun bernama
2. Membuat workspace baru di jalur workspaceTemplate
3. Mendaftarkan agen dan membuat binding untuk pengguna ini
4. Helper workspace memastikan file bootstrap (AGENTS.md, SOUL.md, USER.md, dll.) pada akses pertama
5. Merutekan semua pesan mendatang dari pengguna ini ke agen khusus mereka

​

Opsi konfigurasi

• {agentId} - ID agen yang dibuat (misalnya, feishu-ou_xxxxxx atau feishu-support-<identity_digest>)
• {userId} - open_id Feishu pengirim (misalnya, ou_xxxxxx)

​

Cakupan sesi

{
  session: {
    // For single-user personal bots: enables auto bootstrap loading
    dmScope: "main",

    // For public multi-user bots: stronger isolation
    // dmScope: "per-channel-peer",
  },
}

​

Deployment multi-pengguna umum

{
  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
}

​

Verifikasi

feishu: creating dynamic agent "feishu-ou_xxxxxx" for user ou_xxxxxx
workspace: /Users/you/.openclaw/workspace-feishu-ou_xxxxxx
feishu: dynamic agent created, new route: agent:feishu-ou_xxxxxx:main

ls -la ~/.openclaw/workspace-*

​

Catatan

• Isolasi workspace: Setiap pengguna mendapatkan direktori workspace dan instans agen sendiri. Pengguna tidak dapat melihat riwayat percakapan atau file pengguna lain dalam alur perpesanan normal.
• Batas keamanan: Ini adalah mekanisme isolasi konteks perpesanan, bukan batas keamanan untuk penyewa bersama yang bermusuhan. Proses agen dan lingkungan host digunakan bersama.
• bindings harus kosong: Agen dinamis mendaftarkan binding mereka sendiri secara otomatis
• Jalur upgrade: Binding manual yang ada tetap berfungsi bersama agen dinamis
• session.dmScope bersifat global: Ini memengaruhi semua channel, bukan hanya Feishu

​

Referensi konfigurasi

​

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 posting; tidak mendukung kemampuan penulisan Feishu/Lark penuh)

​

Utas dan balasan

• ✅ Balasan inline
• ✅ Balasan utas
• ✅ Balasan media tetap sadar utas saat membalas pesan utas

​

Terkait

• Ringkasan Channel - semua channel yang didukung
• Penyandingan - autentikasi DM dan alur penyandingan
• Grup - perilaku obrolan grup dan gating penyebutan
• Perutean Channel - perutean sesi untuk pesan
• Keamanan - model akses dan pengerasan