安裝

discli 使用 Python 3.10+，可在 macOS、Linux 與 Windows 執行。請依你的作業流程選擇適合的安裝方式。

安裝需求

安裝前請先確認已具備以下條件：

  • Python 3.10 或更新版本 — 可用 python --version 或 python3 --version 檢查
  • Discord 機器人 Token — 需要用來完成驗證。若你尚未取得，請先參考 第一個機器人。

安裝 discli

最快的安裝方式是透過 PyPI 安裝 discli：

Terminal window
pip install discord-cli-agent

這會連同依賴套件（discord.py 與 click）一起安裝 discli 指令到全域環境。

Tip

如果你使用虛擬環境（建議用於專案隔離），請先啟用環境：

Terminal window
python -m venv .venv
source .venv/bin/activate   # macOS/Linux
.venv\Scripts\activate      # Windows
pip install discord-cli-agent

使用一行安裝指令可自動下載並完成 discli 安裝：

Terminal window
curl -fsSL https://raw.githubusercontent.com/DevRohit06/discli/main/installers/install.sh | bash

這支指令會：

  1. 檢查 Python 3.10+ 是否可用
  2. 用 pip 安裝 discord-cli-agent
  3. 驗證安裝結果
Note

若不想直接 pipe 到 bash，可先下載指令稿再檢查內容：

Terminal window
curl -fsSL https://raw.githubusercontent.com/DevRohit06/discli/main/installers/install.sh -o install.sh
less install.sh
bash install.sh

開啟 PowerShell 並執行：

Terminal window
irm https://raw.githubusercontent.com/DevRohit06/discli/main/installers/install.ps1 | iex

這支指令會偵測 Python 後，透過 pip 安裝 discord-cli-agent。

Warning

你可能需要先調整 PowerShell 的執行原則：

Terminal window
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

複製原始碼庫並以可編輯模式安裝：

Terminal window
git clone https://github.com/DevRohit06/discli.git
cd discli
pip install -e ".[dev]"

此方法會以可編輯模式安裝 discli，並包含開發相依套件（pytest、pytest-asyncio），方便你修改原始碼後立即驗證。

驗證安裝

安裝後請確認 discli 是否可用：

Terminal window
discli --help

你應該會看到類似輸出：

用法：discli [選項] 指令 [參數]...


  discli — 給 AI 代理使用的 Discord CLI。


選項：
  --token TEXT                     Discord 機器人 token。
  --json                           以 JSON 格式輸出。
  -y, --yes                        略過破壞性動作的確認提示。
  --profile [full|chat|readonly|moderation]
                                  覆寫本次執行使用的權限設定檔。
  --help                           顯示這則訊息並結束。


指令：
  audit       檢視稽核日誌。
  channel     管理頻道。
  config      管理 discli 設定。
  dm          傳送及讀取私人訊息。
  listen      接收即時 Discord 事件。
  member      管理伺服器成員。
  message     傳送、讀取及管理訊息。
  permission  管理指令存取控制的權限設定檔。
  poll        建立及管理投票。
  reaction    管理訊息反應。
  role        管理伺服器身分組。
  serve       啟動持續執行的代理工作階段（JSONL 通訊協定）。
  server      列出及檢視伺服器。
  thread      管理討論串。
  typing      在頻道中顯示輸入中指示器。
Danger

如果出現 command not found: discli，請確認 Python 的 scripts 目錄已加入 PATH。pip 安裝通常在 Linux/macOS 為 ~/.local/bin，在 Windows 為 %APPDATA%\Python\Scripts。

選用項目：語音功能

核心安裝預設為 僅文字模式。若僅用聊天機器人，可不安裝語音依賴；語音功能會引入較重的套件（PyNaCl、discord-ext-voice-recv、davey、audioop-lts）。在需要時再安裝語音額外套件：

Terminal window
pip install 'discord-cli-agent[voice,deepgram]'
# 或是用套件管理指令：
uv sync --extra voice --extra deepgram

可用的額外套件：

額外套件說明
voice核心語音收發、Silero VAD、audioop-lts（支援 Python 3.13+）
deepgramDeepgram 串流 STT + Aura TTS
elevenlabsElevenLabs TTS
openai-voiceOpenAI Whisper STT + TTS
all-voicevoice + elevenlabs + deepgram（便利性匯總）

使用 voice play 或 TTS 播放時，系統亦需安裝 libopus（apt install libopus0、brew install opus）與 ffmpeg。

可用下列指令驗證：

Terminal window
discli doctor

完整設定請參考語音指南。

檢查安裝狀態

Terminal window
discli doctor

discli doctor 會依 CORE / VOICE / STT / TTS / TOOLS 分組回報 discli 所需元件。未安裝的選用依賴不會顯示為錯誤訊息；純文字使用者可看到精簡的兩段式報表。若要做腳本串接請加上 --json。

升級

升級到最新版本：

Terminal window
pip install --upgrade discord-cli-agent

移除

Terminal window
pip uninstall discord-cli-agent

這只會移除 discli 指令，不會刪除 ~/.discli/ 的設定目錄；若要完整移除，請手動刪除該目錄。

後續步驟

快速上手

兩分鐘內傳送第一則 Discord 訊息。

設定

設定機器人 Token 與權限設定檔。

Last updated: August 2, 2026
1 min read
Edit this page