Clawdbot Discord 整合

Clawdbot Discord 整合概述

Clawdbot Discord 整合讓您能夠使用官方 Discord 機器人閘道，將 AI 驅動的助手帶入您的 Discord 伺服器。此功能已準備好支援私訊和公會文字頻道。

為什麼要將 Clawdbot 與 Discord 搭配使用？

Discord 是遊戲和社群交流的領先平台。將 Clawdbot 與 Discord 整合可提供：

快速設定（初學者）

1. 建立 Discord 機器人並複製機器人令牌
2. 在 Discord 應用程式設定中，啟用 Message Content Intent（如需要還可啟用 Server Members Intent）
3. 透過環境變數（DISCORD_BOT_TOKEN=...）或設定檔（channels.discord.token）設定令牌
4. 使用訊息權限邀請機器人加入您的伺服器
5. 啟動閘道
6. 私訊存取預設為配對模式；首次接觸時批准配對碼

最小設定：

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

設定 Clawdbot Discord

前置條件

在將 Clawdbot 連接到 Discord 之前，請確保您具備：

• 已在您的裝置上安裝 Clawdbot
• 一個 Discord 帳戶
• Discord 開發者入口網站存取權限
• 伺服器管理員權限

步驟 1：建立 Discord 應用程式

設定您的 Clawdbot Discord 應用程式：

1. 前往 Discord 開發者入口網站
2. 點擊「New Application」
3. 在您的應用程式中：Bot → Add Bot
4. 複製機器人令牌

步驟 2：啟用閘道意圖

啟用 Clawdbot 需要的意圖：

• Message Content Intent — 讀取訊息內容所需
• Server Members Intent — 允許清單或名稱查詢所需

步驟 3：產生邀請 URL

在開發者入口網站中使用 OAuth2 URL 產生器：

Clawdbot Discord 所需權限：

• Read Messages/View Channels
• Send Messages
• Embed Links
• Read Message History
• Add Reactions
• Use Slash Commands

步驟 4：設定 Clawdbot Discord

將您的 Discord 機器人加入 Clawdbot：

環境變數：

DISCORD_BOT_TOKEN=YOUR_BOT_TOKEN

設定檔（~/.clawdbot/clawdbot.json）：

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

如果同時設定了環境變數和設定檔，設定檔優先。

步驟 5：啟動閘道

clawdbot gateway --port 18789

當令牌可用且 channels.discord.enabled 不為 false 時，Discord 會自動啟動。

步驟 6：驗證連線

檢查您的 Clawdbot Discord 狀態：

clawdbot channels status discord

運作方式

• 私訊會合併到代理的主會話（預設 agent:main:main）
• 公會頻道保持隔離為 agent:<agentId>:discord:channel:<channelId>
• 群組私訊預設被忽略；透過 channels.discord.dm.groupEnabled 啟用
• 路由是確定性的：回覆總是返回到收到訊息的頻道

Clawdbot Discord 功能

私訊存取控制

私訊透過 channels.discord.dm.policy 預設是安全的：

範例（硬編碼允許清單）：

{
  "channels": {
    "discord": {
      "dm": {
        "policy": "allowlist",
        "allowFrom": ["user:123456789"]
      }
    }
  }
}

公會頻道設定

設定每個公會或每個頻道的規則：

{
  "channels": {
    "discord": {
      "guilds": {
        "<guild_id>": {
          "channels": ["bot-commands", "ai-chat"],
          "requireMention": true
        }
      }
    }
  }
}

斜線指令

Clawdbot Discord 支援原生斜線指令：

原生指令預設為 "auto"（Discord/Telegram 開啟）。可透過以下方式覆蓋：

{
  "channels": {
    "discord": {
      "commands": {
        "native": true
      }
    }
  }
}

公會上下文歷史

設定 channels.discord.historyLimit（預設 20）以在回覆提及時包含最後 N 條公會訊息作為上下文。設為 0 可禁用。

反應

代理可以透過 discord 工具觸發反應（受 channels.discord.actions.* 控制）。

Clawdbot Discord 設定

完整設定範例

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "dm": {
        "policy": "pairing",
        "groupEnabled": false
      },
      "guilds": {
        "*": {
          "requireMention": true
        }
      },
      "historyLimit": 20
    }
  }
}

設定寫入

預設情況下，Discord 允許寫入由 /config set|unset 觸發的設定更新。可透過以下方式禁用：

{
  "channels": {
    "discord": {
      "configWrites": false
    }
  }
}

Clawdbot Discord 憑證儲存

Clawdbot 安全地儲存 Discord 憑證：

~/.clawdbot/credentials/discord/bot_token
~/.clawdbot/credentials/discord/servers.json

您的 Clawdbot Discord 資料保留在您的本地機器上。

Clawdbot Discord 故障排除

機器人離線

如果 Clawdbot Discord 顯示離線：

1. 驗證令牌：clawdbot channels verify discord
2. 檢查閘道連線
3. 查看日誌：cat /tmp/clawdbot/discord.log

斜線指令不工作

如果 Clawdbot Discord 斜線指令失敗：

1. 透過設定重新註冊指令
2. 檢查機器人權限
3. 驗證伺服器特定的指令註冊

權限錯誤

如果 Clawdbot Discord 缺少權限：

1. 在伺服器設定中檢查機器人角色位置
2. 檢查頻道特定權限
3. 使用正確的權限重新邀請

名稱解析

名稱 → id 解析使用公會成員搜尋，需要 Server Members Intent。如果機器人無法搜尋成員，請使用 id 或 <@id> 提及。

Clawdbot Discord 最佳實踐

1. 使用配對模式：私訊預設使用配對碼確保安全
2. 設定頻道限制：將 Clawdbot Discord 限制在適當的頻道
3. 設定角色：使用基於角色的存取控制 Clawdbot Discord
4. 監控活動：定期查看 Clawdbot Discord 日誌
5. 使用斜線指令：比文字指令有更好的使用者體驗

Clawdbot Discord 使用案例

社群支援

將 Clawdbot Discord 部署為支援機器人：

• 自動回答常見問題
• 升級複雜問題
• 提供 24/7 全天候協助

遊戲社群

在遊戲伺服器中使用 Clawdbot Discord：

• 遊戲資訊查詢
• 團隊協調
• 活動排程

開發者社群

在開發者伺服器中使用 Clawdbot Discord：

• 程式碼協助
• 文件查詢
• 錯誤分類

下一步

• Clawdbot WhatsApp 整合 - 將 Clawdbot 連接到 WhatsApp
• Clawdbot Telegram 整合 - 在 Telegram 上設定 Clawdbot
• Clawdbot 設定指南 - 完整安裝指南