Skip to content

Discord 機器人設定

逐步教學：將 Claw Buff Agent 連接到 Discord

將您的 Claw Buff AI Agent 連接到 Discord 伺服器。機器人將回應私訊和頻道訊息。設定大約需要 10 分鐘。

前置需求

  • 一個 Discord 帳號
  • 一個您擁有管理伺服器權限的 Discord 伺服器
  • 已部署的 Claw Buff Agent（快速入門）

步驟 1：建立 Discord 應用程式

開啟開發者入口網站

前往 Discord Developer Portal，點擊 New Application。為它命名（例如「My AI Agent」）。

建立機器人

在側邊欄點擊 Bot。您可以自訂機器人的使用者名稱和頭像。

啟用 Message Content Intent

向下捲動至 Privileged Gateway Intents，啟用以下選項：

  • Message Content Intent — 讀取訊息內容的必要權限
  • Server Members Intent — 建議啟用，用於基於角色的存取控制

點擊 Save Changes。

複製 Bot Token

點擊 Reset Token（或顯示的 Copy）取得 Bot Token。請妥善保存 — 下一步會用到。

Bot Token 是機密資訊。切勿公開分享。如果遭到洩漏，請立即在 Developer Portal 中重設。

步驟 2：邀請機器人加入伺服器

產生邀請連結

在 Developer Portal 側邊欄，點擊 OAuth2 → URL Generator。

勾選以下範圍（scopes）：

  • bot
  • applications.commands

然後勾選以下機器人權限（bot permissions）：

  • View Channels
  • Send Messages
  • Read Message History
  • Embed Links
  • Attach Files

邀請機器人

複製產生的 URL，在瀏覽器中開啟。選擇要加入機器人的伺服器，然後點擊 Authorize。

步驟 3：連接至 Claw Buff

  1. 開啟 Claw Buff 管理後台 → 頻道 頁面
  2. 找到 Discord 卡片並點擊連接
  3. 貼上步驟 1 取得的 Bot Token
  4. 點擊儲存並啟用

機器人將在幾秒鐘內上線。

步驟 4：配對您的帳號

機器人開始回應之前，您需要先配對 Discord 帳號：

  1. 私訊機器人 — 在伺服器成員列表中點擊機器人名稱，傳送任意訊息（例如「hello」）
  2. 機器人會回覆一組配對碼（例如 X7QTGBD4）
  3. 前往 Claw Buff 管理後台 → 頻道 頁面
  4. 您會看到待處理的配對請求區塊 — 點擊配對碼旁的核准

核准後，機器人將立即回應您的私訊。

步驟 5：啟用伺服器頻道（選填）

預設情況下，機器人僅在私訊中運作。若要在伺服器頻道中使用：

  1. 在 Discord 中，右鍵點擊伺服器圖示 → 複製伺服器 ID

如果看不到「複製伺服器 ID」選項，請先啟用開發者模式：使用者設定 → 進階 → 開啟「開發者模式」。

  1. 在管理後台，前往頻道 → 點擊 Discord 卡片上的管理
  2. 在已授權伺服器下方，貼上伺服器 ID 並點擊新增

機器人現在會回應該伺服器頻道中的 @提及。您可以新增多個伺服器。

提及機器人時，請確認您選擇的是機器人使用者（顯示在「成員」區塊，帶有 APP 標籤），而非同名的角色。Discord 會自動建立一個與機器人同名的角色——提及角色並不會觸發機器人回應。

功能一覽

功能支援狀態
私人訊息是
頻道訊息是（需提及）
串流回應是（即時編輯）
斜線指令是
豐富嵌入是
檔案附件是
語音頻道是

常見問題

1. 機器人在 Discord 中顯示離線？

  • 檢查 Token — 確認您貼上的 Token 完整無誤
  • 檢查 Intents — 必須在 Developer Portal 中啟用 Message Content Intent
  • 檢查管理後台 — 頻道頁面會顯示連線狀態與錯誤紀錄

2. 機器人不回應訊息？

  • 確認已啟用 Message Content Intent（步驟 1）
  • 在頻道中，機器人需要被 @提及 才會回應
  • 請確認您提及的是機器人使用者，而非角色 — 輸入 @ 時，請從「成員」區塊（帶有 APP 標籤）選擇機器人，而非從「角色」區塊選擇。Discord 會建立一個與機器人同名的角色，但提及角色並不會觸發回應。
  • 確認機器人在該頻道擁有 View Channels 和 Read Message History 權限

3. 出現「Missing Permissions」錯誤？

機器人需要在該頻道擁有正確的權限。請確認至少具備以下權限：View Channels、Send Messages、Read Message History 和 Embed Links。