OpenClaw 的 Discord 技能

OpenClaw Discord 技能概述

Discord 技能透過 Discord API 將 OpenClaw 連接到您的 Discord 伺服器，讓您的 AI 代理成為強大的 Discord 助手。安裝完成後，您可以傳送訊息、管理討論串、發起投票、上傳表情符號，甚至處理管理操作 — 全部透過自然語言指令完成。

Discord 是開發者社群、開源專案和團隊溝通最受歡迎的平台之一。OpenClaw Discord 技能消除了在終端機和 Discord 之間切換的需要。無論您是在監控社群頻道、回覆問題，還是管理伺服器設定，只需與 OpenClaw 進行簡單對話即可完成。

典型工作流程：

1. 要求 OpenClaw 傳送訊息或查看 Discord 頻道中的近期活動。
2. 代理使用相應的操作呼叫 Discord API（例如 sendMessage、readMessages）。
3. 結果以易讀的摘要形式返回 — 無需切換上下文。

Discord 技能安裝前的準備

在安裝 Discord 技能之前，請確保您已具備：

• 已安裝並執行的 OpenClaw（v1.0+）
• 擁有您要管理的伺服器存取權限的 Discord 帳號
• 在 開發者入口網站 中建立的 Discord 機器人，並取得機器人權杖
• 機器人已邀請到您的伺服器，並具有必要的權限
• 已安裝 clawhub CLI 用於技能管理

驗證您的設定：

# 檢查 OpenClaw 版本
openclaw --version

# 檢查 clawhub CLI
clawhub --version

建立 Discord 機器人

如果您還沒有機器人，請按照以下步驟操作：

1. 前往 Discord 開發者入口網站，點擊 New Application。
2. 導航到 Bot 標籤頁，點擊 Add Bot。
3. 複製機器人權杖 — 設定時會需要用到。
4. 在 Privileged Gateway Intents 下，如果需要技能讀取訊息內容，請啟用 Message Content Intent。
5. 使用 OAuth2 URL Generator 建立包含 bot 範圍和所需權限的邀請連結。

如何安裝 Discord 技能

使用一條指令即可安裝 Discord 技能：

npx clawhub@latest install discord

驗證安裝：

clawhub list

您應該會在已安裝技能列表中看到 discord。您也可以在安裝前使用 clawhub inspect discord 預覽該技能。

Discord 技能設定指南

Discord 技能需要機器人權杖進行身份驗證。如果您還未建立機器人，請在 Discord 開發者入口網站 中建立。

環境設定

# 設定您的 Discord 機器人權杖
export DISCORD_BOT_TOKEN=your_bot_token_here

重要： 切勿在設定檔中硬編碼權杖。請使用環境變數或密鑰管理器，例如 1Password。

Gateway Intents

該技能使用 Discord Gateway Intents 來接收事件。有三個 intents 屬於特權類別，必須在開發者入口網站中啟用：

| Intent | 用途 | 是否必要？ | |--------|------|-----------| | MESSAGE_CONTENT | 讀取訊息文字、嵌入內容和附件 | 是，用於 readMessages | | GUILD_MEMBERS | 存取成員加入/離開事件和成員列表 | 僅在使用 memberInfo 時需要 | | GUILD_PRESENCES | 追蹤使用者上線/離線狀態 | 很少需要 |

僅啟用您的使用場景所需的 intents。對於大多數設定，僅啟用 MESSAGE_CONTENT 就已足夠。

操作閘控

Discord 技能支援細粒度的操作控制。大多數操作預設為啟用，但敏感操作預設為停用：

| 操作 | 預設值 | 說明 | |------|--------|------| | discord.actions.moderation | false | 禁言、踢出和封禁使用者 | | discord.actions.roles | false | 為成員新增或移除角色 |

若要啟用管理操作，請更新您的 OpenClaw 設定：

# 啟用管理操作（請謹慎使用）
openclaw config set discord.actions.moderation true

Discord 技能使用範例

1. 向頻道傳送訊息

你：「向 #announcements 頻道傳送一條訊息，內容為『2.0 版本現已上線！請查看版本說明了解詳情。』」

代理使用 sendMessage 操作，指定目標頻道 ID。它會發佈訊息並回傳訊息連結確認送達。

2. 監控社群問題

你：「讀取 #help-forum 中最近的 10 條訊息，並總結所有未回覆的問題。」

代理對指定頻道呼叫 readMessages，篩選出沒有回覆的訊息，並返回未回覆問題的摘要及各討論串的連結。

3. 發起社群投票

你：「在 #general 建立一個投票，問題為『我們接下來應該開發什麼功能？』選項為：深色模式、行動應用程式、API 改進、更好的文件。投票持續 24 小時。」

代理使用 poll 操作建立投票，最多可設定 10 個選項。它會設定持續時間並返回投票連結確認。

4. 上傳自訂表情符號

你：「把這張圖片作為名為 'ship_it' 的自訂表情符號上傳到我們的伺服器。」

代理使用 emojiUpload 將圖片（PNG/JPG/GIF，最大 256KB）新增為伺服器表情符號。它會確認上傳並顯示表情符號代碼 :ship_it: 以供在訊息中使用。

安全與最佳實踐

Discord 技能可以在您的伺服器上執行寫入操作，包括傳送訊息，以及（如果啟用的話）管理操作。請遵循以下指南以確保安全：

• 使用最小權限原則。 僅授予機器人實際需要的權限。除非絕對必要，否則避免授予 Administrator 權限。
• 預設停用管理功能。 該技能預設停用 moderation 和 roles 操作。僅在有特定需求且了解其影響時才啟用。
• 僅啟用必要的 intents。 特權 intents 如 MESSAGE_CONTENT 和 GUILD_MEMBERS 僅應在工作流程需要時才啟用。
• 定期輪換機器人權杖。 如果您懷疑權杖已洩露，請立即在 開發者入口網站 中重新產生。
• 確認前仔細檢查。 OpenClaw 會在執行破壞性操作前提示確認。請務必在核准前閱讀操作摘要，特別是管理和批次操作。
• 稽核機器人活動。 使用 Discord 的稽核日誌追蹤機器人執行的操作，並驗證它們是否符合您的預期。

常見錯誤與故障排除

"401: Unauthorized"

您的機器人權杖遺失、無效或已被重新產生。

1. 檢查環境中是否已設定 DISCORD_BOT_TOKEN。
2. 驗證權杖是否與 開發者入口網站 機器人設定中的權杖一致。
3. 如果權杖近期已重新產生，請更新您的環境變數。

# 驗證權杖是否已設定
echo $DISCORD_BOT_TOKEN

"50001: Missing Access"

機器人沒有權限存取目標頻道或伺服器。

1. 確認機器人已被邀請到伺服器並具有正確的權限。
2. 檢查頻道級別的權限覆蓋是否可能阻擋了機器人。
3. 使用 permissions 操作檢查機器人在某個頻道的有效權限。

"MESSAGE_CONTENT intent is required"

您嘗試讀取訊息內容，但未啟用 MESSAGE_CONTENT 特權 intent。

1. 前往 開發者入口網站 → 您的應用程式 → Bot 標籤頁。
2. 在 Privileged Gateway Intents 下，啟用 Message Content Intent。
3. 對於已驗證的機器人（75+ 伺服器），您必須透過入口網站申請此 intent。