Discord

Discord mendukung tag balasan dalam output agen:

• [[reply_to_current]]
• [[reply_to:<id>]]

Dikendalikan oleh channels.discord.replyToMode:

• off (bawaan)
• first
• all
• batched

Catatan: off menonaktifkan utas balasan implisit. Tag eksplisit [[reply_to_*]] tetap dipatuhi. first selalu melampirkan referensi balasan bawaan implisit ke pesan Discord keluar pertama untuk giliran tersebut. batched hanya melampirkan referensi balasan bawaan implisit Discord ketika giliran masuk merupakan batch beberapa pesan yang digabung setelah jeda singkat. Ini berguna ketika Anda menginginkan balasan bawaan terutama untuk percakapan beruntun yang ambigu, bukan setiap giliran satu pesan.

ID pesan ditampilkan dalam konteks/riwayat sehingga agen dapat menargetkan pesan tertentu.

OpenClaw dapat melakukan streaming draf balasan dengan mengirim pesan sementara dan mengeditnya saat teks masuk. channels.discord.streaming menerima off | partial | block | progress (bawaan). progress mempertahankan satu draf status yang dapat diedit dan memperbaruinya dengan progres alat hingga pengiriman final; streamMode adalah alias runtime lama. Jalankan openclaw doctor --fix untuk menulis ulang konfigurasi tersimpan ke kunci kanonis.

Atur channels.discord.streaming.mode ke off untuk menonaktifkan edit pratinjau Discord. Jika streaming blok Discord diaktifkan secara eksplisit, OpenClaw melewati aliran pratinjau untuk menghindari streaming ganda.

{
channels: {
discord: {
  streaming: {
    mode: "progress",
    progress: {
      label: "auto",
      maxLines: 8,
      toolProgress: true,
    },
  },
},
},
}

• partial mengedit satu pesan pratinjau saat token tiba.
• block memancarkan potongan sebesar draf (gunakan draftChunk untuk menyesuaikan ukuran dan titik jeda, dibatasi ke textChunkLimit).
• Final berupa media, kesalahan, dan balasan eksplisit membatalkan edit pratinjau yang tertunda.
• streaming.preview.toolProgress (bawaan true) mengontrol apakah pembaruan alat/progres menggunakan kembali pesan pratinjau.
• streaming.preview.commandText / streaming.progress.commandText mengontrol detail perintah/eksekusi dalam baris progres ringkas: raw (bawaan) atau status (hanya label alat).

Sembunyikan teks perintah/eksekusi mentah sambil mempertahankan baris progres ringkas:

{
  "channels": {
    "discord": {
      "streaming": {
        "mode": "progress",
        "progress": {
          "toolProgress": true,
          "commandText": "status"
        }
      }
    }
  }
}

Streaming pratinjau hanya teks; balasan media beralih kembali ke pengiriman normal. Ketika streaming block diaktifkan secara eksplisit, OpenClaw melewati aliran pratinjau untuk menghindari streaming ganda.

Konteks riwayat server:

• channels.discord.historyLimit bernilai bawaan 20
• cadangan: messages.groupChat.historyLimit
• 0 menonaktifkan

Kontrol riwayat DM:

• channels.discord.dmHistoryLimit
• channels.discord.dms["<user_id>"].historyLimit

Perilaku utas:

• Utas Discord dirutekan sebagai sesi kanal dan mewarisi konfigurasi kanal induk kecuali ditimpa.
• Sesi utas mewarisi pilihan /model tingkat sesi kanal induk sebagai cadangan khusus model; pilihan /model lokal utas tetap didahulukan dan riwayat transkrip induk tidak disalin kecuali pewarisan transkrip diaktifkan.
• channels.discord.thread.inheritParent (bawaan false) mengikutsertakan utas otomatis baru untuk diinisialisasi dari transkrip induk. Penimpaan per akun berada di bawah channels.discord.accounts.<id>.thread.inheritParent.
• Reaksi alat pesan dapat menyelesaikan target DM user:<id>.
• guilds.<guild>.channels.<channel>.requireMention: false dipertahankan selama jalur cadangan aktivasi tahap balasan.

Topik kanal diinjeksi sebagai konteks tidak tepercaya. Daftar izin membatasi siapa yang dapat memicu agen, bukan menjadi batas redaksi konteks tambahan penuh.

Discord dapat mengikat utas ke target sesi sehingga pesan tindak lanjut di utas tersebut tetap dirutekan ke sesi yang sama (termasuk sesi subagen).

Perintah:

• /focus <target> ikat utas saat ini/baru ke target subagen/sesi
• /unfocus hapus pengikatan utas saat ini
• /agents tampilkan eksekusi aktif dan status pengikatan
• /session idle <duration|off> periksa/perbarui lepas fokus otomatis karena ketidakaktifan untuk pengikatan yang difokuskan
• /session max-age <duration|off> periksa/perbarui usia maksimum mutlak untuk pengikatan yang difokuskan

Konfigurasi:

{
session: {
threadBindings: {
  enabled: true,
  idleHours: 24,
  maxAgeHours: 0,
},
},
channels: {
discord: {
  threadBindings: {
    enabled: true,
    idleHours: 24,
    maxAgeHours: 0,
    spawnSessions: true,
    defaultSpawnContext: "fork",
  },
},
},
}

Catatan:

• session.threadBindings.* mengatur bawaan global.
• channels.discord.threadBindings.* menimpa perilaku Discord.
• spawnSessions mengontrol pembuatan/pengikatan utas otomatis untuk sessions_spawn({ thread: true }) dan pembuatan utas ACP. Bawaan: true.
• defaultSpawnContext mengontrol konteks subagen bawaan untuk pembuatan terikat utas. Bawaan: "fork".
• Kunci spawnSubagentSessions/spawnAcpSessions yang sudah tidak digunakan dimigrasikan oleh openclaw doctor --fix.
• Jika pengikatan utas dinonaktifkan untuk suatu akun, /focus dan operasi pengikatan utas terkait tidak tersedia.

Lihat Subagen, Agen ACP, dan Referensi Konfigurasi.

Untuk ruang kerja ACP "selalu aktif" yang stabil, konfigurasikan pengikatan ACP bertipe tingkat atas yang menargetkan percakapan Discord.

Jalur konfigurasi:

• bindings[] dengan type: "acp" dan match.channel: "discord"

Contoh:

{
agents: {
list: [
  {
    id: "codex",
    runtime: {
      type: "acp",
      acp: {
        agent: "codex",
        backend: "acpx",
        mode: "persistent",
        cwd: "/workspace/openclaw",
      },
    },
  },
],
},
bindings: [
{
  type: "acp",
  agentId: "codex",
  match: {
    channel: "discord",
    accountId: "default",
    peer: { kind: "channel", id: "222222222222222222" },
  },
  acp: { label: "codex-main" },
},
],
channels: {
discord: {
  guilds: {
    "111111111111111111": {
      channels: {
        "222222222222222222": {
          requireMention: false,
        },
      },
    },
  },
},
},
}

Catatan:

• /acp spawn codex --bind here mengikat kanal atau utas saat ini di tempat dan mempertahankan pesan mendatang pada sesi ACP yang sama. Pesan utas mewarisi pengikatan kanal induk.
• Dalam kanal atau utas terikat, /new dan /reset mengatur ulang sesi ACP yang sama di tempat. Pengikatan utas sementara dapat menimpa resolusi target saat aktif.
• spawnSessions mengontrol pembuatan/pengikatan utas turunan melalui --thread auto|here.

Lihat Agen ACP untuk detail perilaku pengikatan.

Mode notifikasi reaksi per server:

• off
• own (bawaan)
• all
• allowlist (menggunakan guilds.<id>.users)

Peristiwa reaksi diubah menjadi peristiwa sistem dan dilampirkan ke sesi Discord yang dirutekan.

ackReaction mengirim emoji tanda diterima saat OpenClaw memproses pesan masuk.

Urutan resolusi:

• channels.discord.accounts.<accountId>.ackReaction
• channels.discord.ackReaction
• messages.ackReaction
• cadangan emoji identitas agen (agents.list[].identity.emoji, jika tidak "👀")

Catatan:

• Discord menerima emoji Unicode atau nama emoji kustom.
• Gunakan "" untuk menonaktifkan reaksi bagi kanal atau akun.

Penulisan konfigurasi yang dimulai kanal diaktifkan secara bawaan.

Ini memengaruhi alur /config set|unset (ketika fitur perintah diaktifkan).

Nonaktifkan:

{
channels: {
discord: {
  configWrites: false,
},
},
}

Rutekan lalu lintas WebSocket Gateway Discord dan pencarian REST saat mulai berjalan (ID aplikasi + resolusi daftar izin) melalui proxy HTTP(S) dengan channels.discord.proxy.

{
channels: {
discord: {
  proxy: "http://proxy.example:8080",
},
},
}

Penimpaan per akun:

{
channels: {
discord: {
  accounts: {
    primary: {
      proxy: "http://proxy.example:8080",
    },
  },
},
},
}

Aktifkan resolusi PluralKit untuk memetakan pesan yang diproksikan ke identitas anggota sistem:

{
channels: {
discord: {
  pluralkit: {
    enabled: true,
    token: "pk_live_...", // optional; needed for private systems
  },
},
},
}

Catatan:

• daftar izin dapat menggunakan pk:<memberId>
• nama tampilan anggota dicocokkan berdasarkan nama/slug hanya ketika channels.discord.dangerouslyAllowNameMatching: true
• pencarian menggunakan ID pesan asli dan dibatasi jendela waktu
• jika pencarian gagal, pesan yang diproksikan diperlakukan sebagai pesan bot dan dibuang kecuali allowBots=true

Gunakan mentionAliases ketika agen memerlukan penyebutan keluar deterministik untuk pengguna Discord yang dikenal. Kunci adalah handle tanpa awalan @; nilai adalah ID pengguna Discord. Handle yang tidak dikenal, @everyone, @here, dan penyebutan di dalam rentang kode Markdown dibiarkan tidak berubah.

{
channels: {
discord: {
  mentionAliases: {
    Vladislava: "123456789012345678",
  },
  accounts: {
    ops: {
      mentionAliases: {
        OpsLead: "234567890123456789",
      },
    },
  },
},
},
}

Pembaruan kehadiran diterapkan ketika Anda mengatur kolom status atau aktivitas, atau ketika Anda mengaktifkan kehadiran otomatis.

Contoh hanya status:

{
channels: {
discord: {
  status: "idle",
},
},
}

Contoh aktivitas (status kustom adalah jenis aktivitas bawaan):

{
channels: {
discord: {
  activity: "Focus time",
  activityType: 4,
},
},
}

Contoh streaming:

{
channels: {
discord: {
  activity: "Live coding",
  activityType: 1,
  activityUrl: "https://twitch.tv/openclaw",
},
},
}

Peta jenis aktivitas:

• 0: Bermain
• 1: Streaming (memerlukan activityUrl)
• 2: Mendengarkan
• 3: Menonton
• 4: Kustom (menggunakan teks aktivitas sebagai keadaan status; emoji bersifat opsional)
• 5: Berkompetisi

Contoh kehadiran otomatis (sinyal kesehatan runtime):

{
channels: {
discord: {
  autoPresence: {
    enabled: true,
    intervalMs: 30000,
    minUpdateIntervalMs: 15000,
    exhaustedText: "token exhausted",
  },
},
},
}

Kehadiran otomatis memetakan ketersediaan runtime ke status Discord: sehat => online, terdegradasi atau tidak diketahui => idle, habis atau tidak tersedia => dnd. Penggantian teks opsional:

• autoPresence.healthyText
• autoPresence.degradedText
• autoPresence.exhaustedText (mendukung placeholder {reason})

Discord mendukung penanganan persetujuan berbasis tombol di DM dan secara opsional dapat memposting prompt persetujuan di channel asal.

Path konfigurasi:

• channels.discord.execApprovals.enabled
• channels.discord.execApprovals.approvers (opsional; kembali ke commands.ownerAllowFrom jika memungkinkan)
• channels.discord.execApprovals.target (dm | channel | both, default: dm)
• agentFilter, sessionFilter, cleanupAfterResolve

Discord otomatis mengaktifkan persetujuan exec native ketika enabled tidak diatur atau "auto" dan setidaknya satu pemberi persetujuan dapat diselesaikan, baik dari execApprovals.approvers maupun dari commands.ownerAllowFrom. Discord tidak menyimpulkan pemberi persetujuan exec dari channel allowFrom, dm.allowFrom lama, atau pesan langsung defaultTo. Atur enabled: false untuk menonaktifkan Discord sebagai klien persetujuan native secara eksplisit.

Untuk perintah grup sensitif khusus pemilik seperti /diagnostics dan /export-trajectory, OpenClaw mengirim prompt persetujuan dan hasil akhir secara privat. OpenClaw mencoba DM Discord terlebih dahulu ketika pemilik yang memanggil memiliki rute pemilik Discord; jika itu tidak tersedia, OpenClaw kembali ke rute pemilik pertama yang tersedia dari commands.ownerAllowFrom, seperti Telegram.

Ketika target adalah channel atau both, prompt persetujuan terlihat di channel. Hanya pemberi persetujuan yang telah diselesaikan yang dapat menggunakan tombol; pengguna lain menerima penolakan ephemeral. Prompt persetujuan menyertakan teks perintah, jadi aktifkan pengiriman channel hanya di channel tepercaya. Jika ID channel tidak dapat diturunkan dari kunci sesi, OpenClaw kembali ke pengiriman DM.

Discord juga merender tombol persetujuan bersama yang digunakan oleh channel chat lain. Adapter Discord native terutama menambahkan perutean DM pemberi persetujuan dan fanout channel. Ketika tombol tersebut ada, tombol itu menjadi UX persetujuan utama; OpenClaw sebaiknya hanya menyertakan perintah manual /approve ketika hasil tool mengatakan persetujuan chat tidak tersedia atau persetujuan manual adalah satu-satunya jalur. Jika runtime persetujuan native Discord tidak aktif, OpenClaw mempertahankan prompt lokal deterministik /approve <id> <decision> tetap terlihat. Jika runtime aktif tetapi kartu native tidak dapat dikirim ke target mana pun, OpenClaw mengirim pemberitahuan fallback di chat yang sama dengan perintah /approve yang persis dari persetujuan tertunda.

Autentikasi Gateway dan penyelesaian persetujuan mengikuti kontrak klien Gateway bersama (ID plugin: diselesaikan melalui plugin.approval.resolve; ID lain melalui exec.approval.resolve). Persetujuan kedaluwarsa setelah 30 menit secara default.

Lihat Persetujuan exec.

• aktifkan Message Content Intent
• aktifkan Server Members Intent ketika Anda bergantung pada penyelesaian pengguna/anggota
• mulai ulang gateway setelah mengubah intent

• verifikasi groupPolicy
• verifikasi allowlist guild di bawah channels.discord.guilds
• jika map channels guild ada, hanya channel yang tercantum yang diizinkan
• verifikasi perilaku requireMention dan pola mention

Pemeriksaan berguna:

openclaw doctor
openclaw channels status --probe
openclaw logs --follow

Penyebab umum:

• groupPolicy="allowlist" tanpa allowlist guild/channel yang cocok
• requireMention dikonfigurasi di tempat yang salah (harus berada di bawah channels.discord.guilds atau entri channel)
• pengirim diblokir oleh allowlist users guild/channel

Log umum:

• Slow listener detected ...
• stuck session: sessionKey=agent:...:discord:... state=processing ...

Knob antrean Gateway Discord:

• akun tunggal: channels.discord.eventQueue.listenerTimeout
• multi-akun: channels.discord.accounts.<accountId>.eventQueue.listenerTimeout
• ini hanya mengontrol pekerjaan listener Gateway Discord, bukan masa hidup giliran agen

Discord tidak menerapkan timeout milik channel pada giliran agen yang diantrekan. Listener pesan langsung menyerahkan pekerjaan, dan proses Discord yang diantrekan mempertahankan urutan per sesi hingga siklus hidup sesi/tool/runtime selesai atau membatalkan pekerjaan.

{
channels: {
discord: {
  accounts: {
    default: {
      eventQueue: {
        listenerTimeout: 120000,
      },
    },
  },
},
},
}

OpenClaw mengambil metadata Discord /gateway/bot sebelum terhubung. Kegagalan sementara akan kembali ke URL Gateway default Discord dan dibatasi laju di log.

Knob timeout metadata:

• akun tunggal: channels.discord.gatewayInfoTimeoutMs
• multi-akun: channels.discord.accounts.<accountId>.gatewayInfoTimeoutMs
• fallback env saat config belum diatur: OPENCLAW_DISCORD_GATEWAY_INFO_TIMEOUT_MS
• default: 30000 (30 detik), maks: 120000

OpenClaw menunggu event READY Gateway Discord saat startup dan setelah runtime terhubung ulang. Penyiapan multi-akun dengan jeda startup dapat memerlukan jendela READY startup yang lebih lama daripada default.

Knob timeout READY:

• startup akun tunggal: channels.discord.gatewayReadyTimeoutMs
• startup multi-akun: channels.discord.accounts.<accountId>.gatewayReadyTimeoutMs
• fallback env startup saat config belum diatur: OPENCLAW_DISCORD_READY_TIMEOUT_MS
• default startup: 15000 (15 detik), maks: 120000
• runtime akun tunggal: channels.discord.gatewayRuntimeReadyTimeoutMs
• runtime multi-akun: channels.discord.accounts.<accountId>.gatewayRuntimeReadyTimeoutMs
• fallback env runtime saat config belum diatur: OPENCLAW_DISCORD_RUNTIME_READY_TIMEOUT_MS
• default runtime: 30000 (30 detik), maks: 120000

Pemeriksaan izin channels status --probe hanya berfungsi untuk ID channel numerik.

Jika Anda menggunakan kunci slug, pencocokan runtime masih dapat berfungsi, tetapi probe tidak dapat memverifikasi izin sepenuhnya.

• DM dinonaktifkan: channels.discord.dm.enabled=false
• Kebijakan DM dinonaktifkan: channels.discord.dmPolicy="disabled" (lama: channels.discord.dm.policy)
• menunggu persetujuan pairing dalam mode pairing

Secara default, pesan yang ditulis bot diabaikan.

Jika Anda mengatur channels.discord.allowBots=true, gunakan aturan mention dan allowlist yang ketat untuk menghindari perilaku loop. Pilih channels.discord.allowBots="mentions" agar hanya menerima pesan bot yang menyebut bot tersebut.

{
channels: {
discord: {
  accounts: {
    mantis: {
      // Mantis listens to other bots only when they mention her.
      allowBots: "mentions",
    },
    molty: {
      // Molty listens to all bot-authored Discord messages.
      allowBots: true,
      mentionAliases: {
        // Lets Molty write "@Mantis" and send a real Discord mention.
        Mantis: "MANTIS_DISCORD_USER_ID",
      },
    },
  },
},
},
}

• pertahankan OpenClaw tetap mutakhir (openclaw update) agar logika pemulihan penerimaan suara Discord tersedia
• pastikan channels.discord.voice.daveEncryption=true (default)
• mulai dari channels.discord.voice.decryptionFailureTolerance=24 (default upstream) dan sesuaikan hanya jika diperlukan
• pantau log untuk:
  • discord voice: DAVE decrypt failures detected
  • discord voice: repeated decrypt failures; attempting rejoin
• jika kegagalan berlanjut setelah bergabung ulang otomatis, kumpulkan log dan bandingkan dengan riwayat penerimaan DAVE upstream di discord.js #11419 dan discord.js #11449