如何建立 Discord Bot：新手完整指南

如果你正在設定 Beatra Custom Bot，第一件需要的東西就是你自己的 Discord bot——一個具有 token 並啟用正確 intents 的應用程式。本指南將帶你逐步完成每個步驟。比較想用看的？下方附有完整的教學影片連結。

🎥 教學影片： https://www.youtube.com/watch?v=qddwRsNU2X8

建立 Discord bot 完全免費，只需幾分鐘即可完成。請依序照著以下步驟操作。

步驟 1 — 開啟 Discord Developer Portal

前往 Discord Developer Portal（https://discord.com/developers/applications），並使用你的 Discord 帳號登入。這是所有 Discord bot 建立與管理的官方平台。

步驟 2 — 建立新的應用程式

點擊右上角的 New Application。為它取一個名稱——這是你機器人的專案名稱，之後可以再更改——接受條款並點擊 Create。現在你已經擁有一個應用程式。

步驟 3 — 開啟 Bot 分頁

在左側選單中，點擊 Bot 分頁。Discord 會自動為你的應用程式建立一個 bot 使用者。在這裡你可以設定機器人的使用者名稱與頭像，這也是你的社群將會看到的樣子。

步驟 4 — 啟用 Privileged Gateway Intents

這是最重要的步驟，也是大家最常漏掉的步驟。往下捲動到 Privileged Gateway Intents，並開啟全部三項：

• Presence Intent
• Server Members Intent
• Message Content Intent

Beatra 需要 Message Content Intent 才能讀取指令，也需要其他兩項 intents 才能在你的伺服器中正常運作。如果這些設定關閉，你的機器人將無法啟動或回應。啟用後請點擊 Save Changes。

步驟 5 — 將機器人設為公開

繼續留在 Bot 分頁，找到 Public Bot 設定，並確認它是開啟的。這樣你（以及 Beatra 的設定引導流程）才能透過邀請連結將機器人加入你的伺服器。如果它是關閉的，就只有你自己能加入它，設定可能會失敗。

步驟 6 — 複製你的 Token

在 Bot 分頁的頂端，點擊 Reset Token 並確認。Discord 只會顯示一次你的機器人 token——請點擊 Copy。

⚠️ 請保密你的 token。 任何取得你 token 的人都能完全控制你的機器人。切勿分享或公開發布它。如果不慎外洩，請回到這裡重設它。Beatra 會以完全加密的方式儲存你的 token，且不會再次顯示。

步驟 7 — 將它貼到 Beatra

回到 Beatra Custom Bot 的設定引導畫面，將你的 token 貼到 token 欄位中。Beatra 會驗證該 token，並在繼續之前確認 Message Content Intent 已啟用。如果你看到 intent 相關的錯誤訊息，請回到步驟 4，啟用 intents、儲存後再試一次。

常見問題

• 「Message Content Intent is disabled」——你跳過了步驟 4。請啟用全部三項 intents 並儲存。
• 「Invalid token」——token 複製錯誤，或是之後又被重設了。請再重設一次並複製最新的 token。
• 無法將機器人加入伺服器——Public Bot 是關閉的（步驟 5），或是你在該伺服器沒有「Manage Server」權限。

完成了

一旦你的 token 通過驗證，Beatra 就會設定好你的機器人並提供邀請連結。從此，你的 Custom Bot 就能以你自己的名義運行完整的 Beatra 體驗。想進一步了解這項功能，請閱讀推出 Custom Bot。