第一個機器人

本指南會從頭帶你建立 Discord 應用程式、邀請機器人加入伺服器，並建立一個會回音訊息的工作代理。完成後你會有一個 Python 腳本，透過 discli serve 監聽訊息並自動回覆。

前置作業

• 已安裝 discli
• Discord 帳號
• 你有管理權限的 Discord 伺服器（必要時建立測試伺服器）

設定 Discord 機器人

discli config set token YOUR_BOT_TOKEN

Set token.

discli server list

我的測試伺服器（ID: 1234567890123456789）— 5 位成員

建立第一個代理

接著進入核心：建立一個會監聽訊息並回覆的機器人。這會使用 discli serve，透過 stdin/stdout 開啟持續 JSONL（JSON Lines）連線。

import json
import subprocess

# 以 JSON 輸出啟動 discli 的 serve 模式
proc = subprocess.Popen(
    ["discli", "--json", "serve"],
    stdin=subprocess.PIPE,
    stdout=subprocess.PIPE,
    text=True,
)

# 從 stdout 逐列讀取 JSON 物件事件
for line in proc.stdout:
    event = json.loads(line)

    # 只回應非機器人訊息
    if event.get("event") == "message" and not event.get("is_bot"):
        # 建立回覆動作
        cmd = json.dumps({
            "action": "reply",
            "channel_id": event["channel_id"],
            "message_id": event["message_id"],
"content": f"你剛才說：{event['content']}",
        })

        # 經由 stdin 傳送動作給 discli
        proc.stdin.write(cmd + "\n")
        proc.stdin.flush()

python my_bot.py

你：你好，bot！
My discli Bot：你剛才說：你好，bot！

程式碼運作方式

先把代理程式拆開解讀：

啟動 serve 流程

proc = subprocess.Popen(
    ["discli", "--json", "serve"],
    stdin=subprocess.PIPE,
    stdout=subprocess.PIPE,
    text=True,
)

這會以子進程方式啟動 discli serve。--json 旗標讓 discli 以 JSON 輸出事件，stdin 與 stdout 形成雙向通訊管道：

• stdout — discli 會將事件（訊息、表情、成員加入等）以 JSON 列輸出
• stdin — 你的代理將動作（傳訊息、回覆、加表情等）以 JSON 列輸入

讀取事件

for line in proc.stdout:
    event = json.loads(line)

stdout 的每列都是完整 JSON 物件，代表一則 Discord 事件。event 欄位指示事件種類。訊息事件範例如下：

{
  "event": "message",
  "channel_id": "1111111111111111111",
  "message_id": "2222222222222222222",
  "author": "Alice",
  "author_id": "3333333333333333333",
    "content": "你好，bot！",
  "is_bot": false,
  "guild_id": "4444444444444444444"
}

過濾事件

if event.get("event") == "message" and not event.get("is_bot"):

這行邏輯會檢查兩件事：

1. 事件是訊息而非表情、成員加入等
2. 訊息不是機器人自己傳的（避免機器人自我回覆形成無限循環）

傳送動作

cmd = json.dumps({
    "action": "reply",
    "channel_id": event["channel_id"],
    "message_id": event["message_id"],
    "content": f"你剛才說：{event['content']}",
})
proc.stdin.write(cmd + "\n")
proc.stdin.flush()

要讓機器人執行動作，就將 JSON 動作寫進 stdin。reply 會回覆指定訊息；其他動作還有 send（傳訊息）、react（加表情）、thread_create（建立討論串）與更多。

flush() 非常重要，否則 Python 可能暫存輸出，導致動作無法即時送到 discli。

疑難排解

擴充代理

你可以在這個基礎上再做：

• 加入 AI 模型。 不必只回音，改為把訊息內容送進 LLM（Claude、GPT 等）再以 AI 回覆。
• 讀取對話歷史。 用 message_list 取得先前訊息，補齊 AI 需要的上下文。
• 建立討論串。 用 thread_create 幫每個對話各建一個專用討論串。
• 加入斜線指令。 設定使用者可透過 / 呼叫的自訂指令。
• 限制權限。 用 discli permission set chat 把可執行操作縮小到必要範圍。

下一步