Prasyarat
- Akun Feishu atau Lark dengan akses pengembang
- Instans Claw (buat di sini)
Panduan Penyiapan
Buat Aplikasi Feishu
- Buka Feishu Open Platform (atau Lark Developer)
- Klik Create Custom App
- Masukkan nama dan deskripsi aplikasi
- Klik Create
Tambahkan Kemampuan Bot
- Di pengaturan aplikasi Anda, buka Features → Bot
- Aktifkan kemampuan bot
- Ini memungkinkan aplikasi Anda untuk menerima dan mengirim pesan
Dapatkan Kredensial
- Buka Credentials & Basic Info
- Salin App ID (dimulai dengan
cli_) - Salin App Secret
Konfigurasi Langganan Event
- Buka Event Subscriptions
- Pilih mode WebSocket (direkomendasikan — tidak memerlukan URL publik)
- Jika diminta, atur Encrypt Key dan Verification Token
Tambahkan Izin Event
- Di bawah Event Subscriptions, tambahkan event ini:
im.message.receive_v1— Menerima pesan
- Buka Permissions & Scopes dan tambahkan:
im:message— Mengirim dan menerima pesanim:message.group_at_msg— Menerima @mentions grup
- Klik Save
Publikasikan Aplikasi
- Buka App Release → Version Management
- Buat versi baru
- Kirim untuk ditinjau (untuk aplikasi internal, ini biasanya instan)
- Setelah disetujui, aplikasi akan aktif
Konfigurasi di Dashboard LemonData
- Buka Dashboard Claw Anda
- Klik ikon pengaturan pada instans Anda
- Buka tab IM Integrations
- Perluas bagian Feishu
- Tempel App ID dan App Secret Anda
- Salin kembali Encrypt Key dan Verification Token yang dihasilkan secara otomatis ke konsol pengembang Feishu
- Klik Save
Pengaturan Grup
Konfigurasikan perilaku obrolan grup di tab IM Integrations pada Dashboard Anda:| Pengaturan | Opsi | Deskripsi |
|---|---|---|
| Group Policy | Terbuka (default) / Allowlist / Dinonaktifkan | Mengontrol siapa yang dapat memicu bot dalam grup |
| Require @mention | Aktif / Nonaktif | Bot hanya merespons saat di-@mention |
| Group IDs | Daftar ID obrolan | Batasi ke grup tertentu (kosong = semua grup) |
| Group Allowed Users | Daftar Open ID | Hanya pengguna ini yang dapat memicu bot (mode allowlist) |
Pemecahan Masalah
Bot tidak menerima pesan
Bot tidak menerima pesan
- Verifikasi bahwa aplikasi telah dipublikasikan dan disetujui
- Pastikan event
im.message.receive_v1telah dilanggan - Pastikan mode WebSocket dipilih (bukan HTTP)
- Verifikasi bahwa Encrypt Key dan Verification Token cocok antara konsol Feishu dan konfigurasi Claw
Kesalahan 'app_ticket'
Kesalahan 'app_ticket'
- Ini biasanya berarti App ID atau App Secret salah
- Periksa kembali kredensial di dashboard Anda