Discord AI 機器人（大笨bot）

👉 介紹網頁：不用看程式碼，直接看大笨bot 能做什麼。

讀取頻道的歷史訊息當上下文，用本地模型（例如 Qwen，經 LiteLLM 的 OpenAI 相容 API）回覆。 機器人本體跑在 Linux 伺服器上（systemd 服務 discord-bot），連到你設定的模型 API（LLM_BASE_URL）。 Discord 機器人只需要「往外連」Discord，不用開任何連接埠。

快速開始（自己架一隻）

1. 需要什麼

• Python 3.11 以上
• 系統要裝 ffmpeg（放音樂用）和 node（yt-dlp 解 YouTube 用）。Ubuntu／Debian：sudo apt install ffmpeg nodejs
• 一個 OpenAI 相容的模型 API：本機的 Ollama、LiteLLM、vLLM，或 OpenAI、DeepSeek 等線上服務都行
• 一個 Discord 機器人帳號（下一步）
• 選填：星盤圖要用 Chromium 把 SVG 轉成 PNG（pip install playwright && playwright install chromium，裝在哪個 Python 由 .env 的 SVG_PYTHON 指定）；沒裝就只有文字星盤

2. 建立 Discord 機器人並拿到 token

1. 到 Discord Developer Portal → New Application，取名字。
2. 左邊 Bot 頁 → Reset Token → 複製出現的 token（只會顯示一次）。這就是 DISCORD_TOKEN，等同機器人的密碼，不要貼到任何公開的地方。
3. 同一頁往下找到 Privileged Gateway Intents，打開 Message Content Intent（沒開機器人讀不到訊息內容）。
4. 左邊 General Information 複製 Application ID（也就是 client id）。
5. 邀請機器人進你的伺服器：把下面「邀請連結」裡的 YOUR_CLIENT_ID 換成剛才的 Application ID，用瀏覽器打開、選伺服器、同意。

3. 安裝與設定

git clone https://github.com/ggh93234999/discord-ai-bot.git
cd discord-ai-bot
python3 -m venv .venv
source .venv/bin/activate          # Windows：.venv\Scripts\activate
pip install -r requirements.txt

cp .env.example .env               # Windows：copy .env.example .env

然後用文字編輯器打開 .env，把金鑰填在這裡（這個檔案已被 .gitignore 擋住，不會被 git 上傳；千萬不要把它傳給別人或貼到聊天室）：

變數	填什麼
DISCORD_TOKEN	上一步複製的機器人 token
LLM_BASE_URL	模型 API 位址，要含 /v1。Ollama：http://localhost:11434/v1；LiteLLM：http://localhost:4000/v1；OpenAI：https://api.openai.com/v1
LLM_API_KEY	模型 API 的金鑰。Ollama 不檢查，隨便填一個非空字串（例如 ollama）即可
LLM_MODEL	模型名稱，要跟 API 那邊的名稱一樣，例如 qwen3:8b、gpt-4o-mini
DEEPSEEK_API_KEY	選填，只有想用 /餘額 查 DeepSeek 餘額才需要
ADMIN_USER_IDS	選填，除了機器人擁有者以外，還有誰能用 /模型 切模型（Discord 使用者 ID，逗號分隔）

其他選填設定都有預設值，說明寫在 .env.example 裡。

4. 啟動

python bot.py

看到「已同步斜線指令」就成功了。到 Discord 打 / 就能看到指令（第一次可能要等一兩分鐘，或按 Ctrl+R 重新整理）。 語音和聊天都在這一個程式裡，不需要對外開任何連接埠，機器人只是主動連出去 Discord 和你的模型 API。

要長期運作的話，可以用 systemd：參考 discord-bot.service.example，改掉使用者和路徑後放到 /etc/systemd/system/，再 sudo systemctl enable --now discord-bot。

5. 常見問題

• 機器人在線上但不回話：多半是 Message Content Intent 沒開（步驟 2-3），或 LLM_BASE_URL 連不到（看終端機的錯誤訊息）。
• 指令沒出現：重新整理 Discord（Ctrl+R）；確認邀請連結有包含 applications.commands。
• 放音樂沒聲音／失敗：確認系統有 ffmpeg，機器人有「連線」和「說話」權限；YouTube 常改版，pip install -U yt-dlp 通常就會好。
• token 外洩了：馬上回 Developer Portal 重新 Reset Token，舊的就失效，再把新的填進 .env。

什麼時候會回

• 私訊機器人
• 在頻道裡 @機器人，或直接回覆機器人的訊息
• 用 /自動回覆 開 開啟的頻道，任何人說話都回

其他機器人發的訊息一律不理，避免兩個機器人互相無限對話。 模型那台電腦關機或沒開模型時，機器人會回「模型那台電腦現在沒開或連不到」。

This is the beginning of the README. Read the rest at the original. Read the full README ↗