Cloudo AgentsCloudo Agents

把您的代理人連到 Discord

大約 10 分鐘。完成後，您的 Discord 伺服器中會多一個能與代理人對談的機器人。設定步驟比 Telegram 多，因為 Discord 把建立機器人拆成「開發者入口」與「邀請流程」兩部分 — 但仍然是一次性的工作。

開始之前

  • 一個已經部署、在入口網站顯示為 active 的代理人
  • 一個 Discord 帳號
  • 一個您具有 Manage Server 或 Administrator 權限的 Discord 伺服器（您無法把機器人加到自己不是管理員的伺服器）
  • 大約 10 分鐘
整體概念

和 Telegram 不同，Discord 沒有「跟一個機器人聊天來建立機器人」的流程。您要進到 Discord 的 開發者入口（在瀏覽器中），註冊一個 應用程式，把一個 機器人 附加到該應用程式上，產生一個 邀請網址，點選網址把機器人加入您的伺服器，最後再把機器人的 token 貼進 OpenClaw。聽起來很多 — 但其實總共大約只要點 10 次。

步驟 1 — 建立一個 Discord 應用程式

  1. 前往 discord.com/developers/applications。如果還沒登入請先登入。
  2. 點右上角的 New Application。
  3. 幫它取個名字。這個名稱會顯示在開發者入口與 Discord 內 — 使用您代理人的名字就可以了。範例：Acme Support。
  4. 接受開發者條款，點 Create。

步驟 2 — 設定機器人

  1. 您現在應該在應用程式的設定頁面。在左側選單點 Bot。
  2. 在 Privileged Gateway Intents 區塊，啟用：
    • Server Members Intent — 如果代理人需要依使用者個人化，就要開
    • Message Content Intent — 機器人要讀取訊息內容就一定要開（大部分代理人都需要）
    為了隱私考量，Discord 預設把這兩項設為 關閉；不開啟的話，機器人只能看到對它的提及，而看不到完整訊息內容。
  3. 點 Save Changes。

步驟 3 — 複製 bot token

  1. 仍在 Bot 頁面，點 Reset Token（如果有View Token 也可以）。Discord 會產生 token 並只顯示一次。
  2. 複製 token。它看起來像這樣：
    MTAxNjMwODc4ODI3MTQ1NDgwMA.GxYz_a.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890ABCD
把 token 當成密碼來保管

任何拿到 bot token 的人，都能以您的機器人身分在它所在的任何伺服器讀取和發送訊息。不要把它貼到公開頻道、截圖、gist 或 git commit 裡。如果不小心洩漏了，在 Bot 頁面點 Reset Token 作廢，然後在 OpenClaw 用新的 token 更新即可。

步驟 4 — 產生邀請網址

  1. 在左側選單，點 OAuth2，然後點 URL Generator。
  2. 在 Scopes 區塊勾選：
    • bot
    • applications.commands（讓您之後可以註冊斜線指令）
  3. 會出現第二個區塊（Bot Permissions）。至少勾選：
    • Read Messages/View Channels
    • Send Messages
    • Embed Links
    • Read Message History
    • Use Slash Commands
    請勿勾選 Administrator。機器人幾乎從來不需要它，而且授予這個權限會讓 token 一旦外洩時的傷害範圍更大。
  4. Discord 會在頁面下方產生一個邀請網址。複製它。

步驟 5 — 把機器人邀請到您的伺服器

  1. 把邀請網址貼到瀏覽器網址列然後按 Enter。
  2. Discord 會問您要把機器人加到哪個伺服器。挑選目標伺服器（您必須在該伺服器擁有 Manage Server 或 Administrator 權限）。
  3. 確認所要求的權限與您在步驟 4 設定的相符。點 Authorize。
  4. Discord 會顯示驗證碼，然後是成功畫面。機器人現在已經在您的伺服器中，會出現在成員側欄，但狀態是離線（它還沒有任何軟體在跑 — 這是下一步要做的）。

步驟 6 — 把 token 貼進 OpenClaw

  1. 在 Cloudo 入口網站，點您想連接的代理人上的 Open my OpenClaw。
  2. 打開 Channels 分頁。
  3. 點 Discord，然後點 Connect。
  4. 把步驟 3 的 bot token 貼進 Bot Token 欄位。
  5. 點 Save。OpenClaw 會連到 Discord 的 gateway，並回應類似：
    Connected as Acme Support#1234 (in 1 server: My Server)

幾秒內，Discord 成員側欄中機器人的狀態會從離線變成線上。

步驟 7 — 傳送第一則訊息

在 Discord 伺服器中，到任何機器人可進入的頻道，提及機器人：

@Acme Support hi, what can you do?

您的代理人應該在幾秒內，以設定好的語氣回覆。如果您沒有 @-提及機器人，它就不會回應 — Discord 預設機器人是「僅在被提及時回應」，除非您自行修改（見下方）。

選擇性的進階設定

斜線指令

OpenClaw 可以註冊像 /help、/reset、 /contact-human 這類斜線指令。在 OpenClaw 的 Discord channel 設定中定義它們；Discord 會在約 30 分鐘內全域註冊（或是在單一伺服器內立即生效）。

頻道限定

預設情況下，機器人會在所有它看得到的頻道中接收訊息。若要把它限定在特定頻道，請在 Discord 中調整各頻道的角色權限，或設定 OpenClaw 只在預先允許的頻道清單中回應。

機器人頭像與描述

回到開發者入口的應用程式根層設定：上傳一張頭像（正方形圖片），設定簡短描述（檢視機器人個人檔案的使用者會看到）。

疑難排解

機器人在線但被提及時不回應

最可能的原因：Message Content Intent 沒開。

  1. 回到開發者入口 → 您的應用程式 → Bot 分頁。
  2. 捲動到 Privileged Gateway Intents。
  3. 啟用 Message Content Intent（如果代理人需要依使用者個人化，也一併啟用 Server Members Intent）。
  4. 儲存。
  5. 在 OpenClaw 重新啟動連線（中斷後，用同一組 token 重新連接）。

如果 intent 都開了機器人仍然不回應，請檢查機器人在該特定頻道的權限 — 有時候頻道層級的角色覆寫會把 View Channel 或 Send Messages 拿掉。

「401 Unauthorized」或「invalid token」

token 錯了或被重置了。到開發者入口 → Bot → Reset Token，複製新的 token，貼進 OpenClaw，儲存。

儲存 token 後機器人一直離線

依序檢查：

  1. OpenClaw 顯示的連線狀態是 connected（不是 error） — 如果顯示 error，代表 token 錯了。
  2. 您的額度餘額大於零 — 連線會保持，但額度用完代理人就不會回應。
  3. 機器人確實已經被邀請到該伺服器（步驟 5）。Bot 分頁與 OAuth2 邀請是兩個獨立的步驟；很容易漏掉邀請那一步，然後納悶為什麼機器人不在伺服器裡。

我想把機器人從一個伺服器中移除

在 Discord 成員側欄上對機器人點右鍵 → Kick。機器人會離開，但應用程式與 token 仍然有效；您可以重新邀請（步驟 5），不需要重新註冊。

我想完全刪除機器人

開發者入口 → 您的應用程式 → General Information → 最下方的 Delete App。這會永久作廢 token。

完成了。您的代理人現在能在 Discord 上以您設定的語氣回覆，並具備與其他管道相同的 SOUL 與能力。一個代理人、所有管道。

下一步：連接 Slack，或如果還沒設定的話，回到 Telegram。也可以回到 文件首頁。

連接 Discord — Cloudo 文件