Create a DingTalk bot
Select or create an organization
Buka DingTalk Open Platform. Saat diminta memilih organisasi, pilih salah satu tempat Anda memiliki izin developer. Atau, pilih organisasi lalu get developer permissions.
Jika tidak ada organisasi yang tersedia, pindai kode QR di bawah ini menggunakan aplikasi seluler DingTalk untuk membuat organisasi.
Aplikasi seluler DingTalk Anda harus versi 6.5.45 atau lebih baru.
Create an OpenClaw bot with one click
Buka DingTalk Open Platform. Pada daftar aplikasi DingTalk di Konsol developer, temukan banner bertuliskan Automatically create an OpenClaw bot application with one click and start your intelligent collaboration journey, lalu klik Create Now.
Platform secara otomatis telah mengisi informasi bot OpenClaw. Anda dapat menyesuaikan konfigurasi sesuai kebutuhan bisnis, lalu klik OK untuk membuat aplikasi.
Jika Anda berencana membuat beberapa aplikasi, ubah nama atau ikon bot saat pembuatan agar mudah membedakannya nanti.
Setelah aplikasi dibuat, salin dan simpan Client ID (AppKey) serta Client Secret (AppSecret)-nya.
Jika Anda menutup dialog tersebut, Anda tetap dapat menemukan Client ID dan Client Secret dengan membuka aplikasi yang telah dibuat, lalu memilih credentials and basic information dari panel navigasi kiri.
Custom bot
Create an application: Di Konsol developer, klik Create App. Masukkan App Name dan App Description, unggah ikon aplikasi, lalu simpan.
Add a bot: Di halaman detail aplikasi, klik Add App Capability di panel navigasi kiri, lalu pilih Add bot.
Configure the bot: Di halaman detail bot, konfigurasikan informasinya seperti nama, ikon, profil, dan deskripsi. Pastikan mode penerimaan pesan diatur ke stream mode. Setelah selesai, klik Publish.
Configure permissions: Klik permission management di panel navigasi kiri. Aplikasi harus memiliki setidaknya izin berikut. Anda dapat menambahkan izin lain sesuai kebutuhan:
Izin dasar yang diperlukan untuk memanggil API SNS (snsapi_base)
Izin dasar yang diperlukan untuk memanggil API enterprise (qyapi_base)
Izin bagi bot dalam organisasi untuk mengirim pesan (qyapi_robot_sendmsg)
Izin menulis untuk instans kartu interaktif (Card.Instance.Write)
Izin pembaruan streaming untuk kartu AI (Card.Streaming.Write)
Configure the event subscription mode: Klik event subscription di panel navigasi kiri. Di manajemen langganan, atur Push Mode ke stream mode.
Publish the application: Klik version management and release di panel navigasi kiri, buat versi, lalu publikasikan aplikasi.
Configure DataClaw instance
Kembali ke DataWorks console untuk membuat instans layanan AI Assistant. Untuk petunjuk lengkap, lihat AI Assistant service configuration guide.
Test the bot
Anda dapat membuat grup chat baru atau menambahkan bot ke grup yang sudah ada. Di grup chat tersebut, @mention the bot untuk memulai percakapan. Atau, cari bot tersebut untuk memulai chat pribadi guna pengujian.
Group chat
Buka halaman Group Settings grup DingTalk, lalu klik kartu Bot. Di halaman Bot Management, klik Add Bot. Di dialog Add Bot, masukkan nama bot target Anda di kotak teks Search, lalu pilih bot tersebut. Klik Add , lalu klik Finish.
Di grup chat, @mention the bot untuk berinteraksi dengannya. Atau, temukan bot tersebut dengan memasukkan namanya di bilah pencarian DingTalk, lalu pilih dari hasil pencarian untuk memulai chat pribadi.
Private chat
Di bilah pencarian bagian atas DingTalk, cari nama bot yang telah Anda buat, lalu klik avatarnya untuk memulai chat pribadi.
Di halaman chat pribadi, mulailah mengobrol dengan bot tersebut.
Notes
Jika Anda menggunakan versi non-komersial DingTalk, periksa konfigurasi bot berikut untuk menghindari perilaku tak terduga:
Baik message receiving mode bot maupun Push Mode di bawah event subscription > General Subscription harus diatur ke stream mode.
Jangan mengonfigurasi allowlist di Security Settings aplikasi.
Pastikan aplikasi DingTalk memiliki Write permission for interactive card instances dan Streaming update permission for AI cards.