Langsung ke konten utama

​
Discord (Bot API)

Status: Siap digunakan untuk DM dan saluran server (guild) melalui gateway resmi Discord.

Pairing

DM Discord menggunakan mode pairing secara default.

Slash Commands

Perilaku perintah asli dan katalog perintah.

Troubleshooting

Panduan diagnosa dan perbaikan saluran.

​
Penyiapan Cepat

Anda perlu membuat aplikasi baru dengan bot, menambahkannya ke server, dan menghubungkannya ke OpenClaw.
1

Buat aplikasi dan bot di Discord Developer Portal

Buka Developer Portal, buat New Application, dan atur bot pada bagian Bot.
2

Aktifkan Privileged Intents

Pada halaman Bot, aktifkan:
  • Message Content Intent (Wajib)
  • Server Members Intent (Disarankan)
3

Salin Token Bot

Klik Reset Token untuk mendapatkan token pertama Anda. Simpan token ini dengan aman.
4

Undang bot ke server

Gunakan OAuth2 URL Generator dengan cakupan bot dan applications.commands, serta izin dasar (Send Messages, View Channels, Read History). Buka URL yang dihasilkan di browser untuk mengundang bot.
5

Atur Konfigurasi OpenClaw

openclaw config set channels.discord.token "TOKEN_ANDA"
openclaw config set channels.discord.enabled true
openclaw gateway restart
6

Setujui pairing pertama

Kirim pesan DM ke bot di Discord, lalu ambil kode pairing yang muncul dan setujui melalui CLI:
openclaw pairing approve discord <KODE>

​
Kebijakan Akses

  • dmPolicy: Mengontrol akses pesan langsung (pairing, allowlist, open, disabled).
  • groupPolicy: Mengontrol akses bot di dalam server (guild). Defaultnya adalah allowlist demi keamanan.
  • guilds: Anda harus mendaftarkan ID Server Anda di dalam konfigurasi agar bot dapat merespons di luar DM.
{
  channels: {
    discord: {
      groupPolicy: "allowlist",
      guilds: {
        "ID_SERVER_ANDA": {
          requireMention: true,
          users: ["ID_USER_ANDA"]
        }
      }
    }
  }
}

​
Sebutan (Mentions)

Di dalam server, bot biasanya hanya merespons jika disebut (@bot). Anda dapat mengubah ini dengan menyetel requireMention: false pada konfigurasi server tertentu.

​
Komponen Interaktif

OpenClaw mendukung komponen Discord seperti tombol dan menu pilihan. Ini digunakan untuk berbagai hal, termasuk persetujuan eksekusi perintah (exec approvals) secara langsung dari chat.

​
Pemecahan Masalah

  • Bot Tidak Melihat Pesan: Pastikan Message Content Intent sudah diaktifkan di Developer Portal.
  • Pesan Server Diabaikan: Periksa kebijakan groupPolicy dan pastikan ID Server sudah terdaftar di guilds.
  • Error Pairing: Pastikan Anda sudah mengaktifkan pengaturan “Allow Direct Messages from server members” di Discord.

​
Terkait