設定

discli 採用分層式設定架構管理驗證，並以權限設定檔控管可執行的指令。本頁說明如何設定機器人 Token、管理設定檔，以及使用權限設定檔。

機器人 Token

Discord 機器人 Token 是唯一必要的設定。discli 會依下列優先順序解析 Token：

--token 的優先權最高，其次是環境變數，最後才是已儲存的設定檔。請依你的作業流程選擇任一方式。

選項 1：設定檔（建議本機使用）

將 Token 持久化儲存，避免每次都重新輸入：

discli config set token YOUR_BOT_TOKEN

已設定 Token。

這會寫入 ~/.discli/config.json：

{
  "token": "YOUR_BOT_TOKEN"
}

chmod 600 ~/.discli/config.json

選項 2：環境變數（建議用於 CI / 容器）

設定 DISCORD_BOT_TOKEN 環境變數：

export DISCORD_BOT_TOKEN=your_token

$env:DISCORD_BOT_TOKEN = "your_token"

[System.Environment]::SetEnvironmentVariable("DISCORD_BOT_TOKEN", "your_token", "User")

docker run -e DISCORD_BOT_TOKEN=your_token my-agent

env:
  DISCORD_BOT_TOKEN: ${{ secrets.DISCORD_BOT_TOKEN }}

選項 3：逐指令旗標

單次執行時直接提供 Token：

discli --token YOUR_BOT_TOKEN server list

檢視目前設定

查看目前已設定的內容：

discli config show

token: your-bot-token

為防止外洩，Token 會截斷顯示。若要看完整 JSON 輸出：

discli --json config show

{
  "token": "your-bot-token-here"
}

權限設定檔

權限設定檔會決定機器人（或代理）可執行哪些指令。這在讓 AI 代理使用 discli 時特別重要，可將其限制在安全的操作範圍內。

可用設定檔

設定啟用中的設定檔

權限設定檔有三種設定方式，優先順序與 Token 相同：

持久化（寫入磁碟）：

discli permission set chat

權限設定檔已設定為：chat（訊息、表情回應、討論串、輸入指示）

這會將啟用的設定檔寫入 ~/.discli/permissions.json。

逐指令（旗標）：

discli --profile readonly message list "#general"

--profile 旗標可在單次呼叫中覆寫已儲存的設定檔。

透過環境變數：

export DISCLI_PROFILE=readonly

此設定優先於已儲存的設定檔，但仍會被 --profile 旗標覆寫。

檢視啟用中的設定檔

discli permission show

啟用的設定檔：chat
說明：訊息、表情回應、討論串、僅輸入動作
允許：message, reaction, thread, typing, dm, listen, serve, config, server
拒絕：member kick, member ban, member unban, channel delete, role delete, role create, channel create

列出所有設定檔

discli permission profiles

  full: 全部指令都可使用
  chat: 訊息、表情回應、討論串、僅輸入動作
  readonly: 只讀：list、info、get、search、listen
  moderation: 含審核權限的完整存取

危險操作保護

某些指令屬於破壞性操作，執行前會要求確認：

• member kick
• member ban
• member unban
• channel delete
• message delete
• role delete

執行這類指令時，discli 會跳出確認提示：

⚠ 危險操作：member kick（使用者：Alice）。是否繼續？[y/N]

若要在腳本與自動化中略過提示，請加 --yes 或 -y 旗標：

discli --yes member kick "My Server" @spammer

稽核日誌

discli 會將每次指令執行寫入 ~/.discli/audit.log。可用來追蹤代理實際執行了哪些操作。

# 檢視最近的稽核紀錄
discli audit show --limit 10

# JSON 輸出
discli --json audit show --limit 5

# 清除日誌
discli audit clear

設定檔參考

~/.discli/config.json

{
  "token": "YOUR_BOT_TOKEN"
}

~/.discli/permissions.json

{
  "active_profile": "chat",
  "profiles": {}
}

profiles 欄位可自訂更多設定檔，預設內建的四個設定檔已可覆蓋大多數需求。

~/.discli/audit.log

每一列為一筆 JSON 物件的換行分隔檔，代表一筆稽核紀錄：

{"timestamp": "2026-03-15T10:32:00+00:00", "command": "message send", "args": {"channel": "general", "content": "Hello"}, "result": "ok", "user": ""}

後續步驟