Discord

透過 Discord Bot API 整合 OpenClaw，支援私訊和伺服器頻道通訊。

OpenClaw 的 Discord 整合透過 Discord 官方 Gateway 實現代理通訊，支援私訊和伺服器（Guild）頻道，可完整自訂權限和行為。

設定步驟

1. 建立應用程式和機器人 — 在 Discord Developer Portal 中建立新應用程式並新增機器人使用者
2. 啟用必要的 Intents — 包括 Message Content Intent（必要）和 Server Members Intent（建議用於使用者解析）
3. 取得 bot token — 在 Bot 設定中重設/產生憑證
4. 設定 OAuth2 範圍 — bot 和 applications.commands，搭配檢視頻道、傳送訊息、讀取歷史記錄、嵌入連結和附加檔案的基本權限
5. 收集必要的 ID — 在 Discord 中啟用開發者模式後，取得伺服器 ID 和使用者 ID
6. 設定環境變數 — 在啟動 Gateway 前設定 DISCORD_BOT_TOKEN 或使用設定檔中的 token

Bot token 是機密資訊（如同密碼），應透過環境變數安全儲存。

存取控制

系統實作多層安全機制：

• 私訊策略 — 透過 pairing（預設）、allowlist、open 或 disabled 模式控制私訊存取
• 伺服器策略 — 透過 open、allowlist（建議）或 disabled 設定管理伺服器範圍的存取
• 提及要求 — 伺服器頻道預設強制要求提及，可依伺服器或頻道自訂
• 角色路由 — 根據 Discord 角色 ID 將成員導向不同的代理

進階功能

互動元件

平台支援 Discord 元件 v2，包括按鈕、選擇選單和模態表單，可設定每個操作的權限和可重複使用的元件設定。

語音整合

機器人可加入語音頻道進行持續對話，支援自動加密和文字轉語音輸出（需設定提供者）。

對話串綁定

Discord 對話串可綁定到特定的工作階段目標，維持對話連續性，可設定閒置逾時和最長存活時間。

論壇頻道

透過向論壇父層傳送訊息自動建立對話串討論，也可使用明確的對話串建立方式。

監控與疑難排解

常用診斷指令包括 openclaw doctor、openclaw channels status --probe 和透過 openclaw logs --follow 檢視日誌。主要問題涉及 Intent 設定、允許清單不符和提及模式驗證。