先決條件
- 一個 Discord 帳號
- 一個您擁有 管理伺服器 權限的 Discord 伺服器
- 一個 LemonClaw 實例:
- 託管型:建立 Claw 實例
- 自託管型:安裝 LemonClaw
設定指南
建立 Discord 應用程式
- 前往 Discord Developer Portal
- 點擊 New Application
- 為其命名(例如「My AI Bot」)並點擊 Create
建立機器人
- 在您的應用程式中,前往 Bot 分頁
- 點擊 Add Bot → Yes, do it!
- 在 Privileged Gateway Intents 下,啟用:
- Message Content Intent(必選)
- Server Members Intent(建議)
- 點擊 Reset Token 以產生機器人 token
- 複製該 token — 您稍後會用到它
邀請機器人至您的伺服器
- 前往 OAuth2 分頁 → URL Generator
- 在 Scopes 下,選擇:
bot,applications.commands - 在 Bot Permissions 下,選擇:
Send Messages,Read Message History - 複製產生的 URL 並在瀏覽器中開啟
- 選擇您的伺服器並點擊 Authorize
開啟 LemonClaw WebUI
- 如果您使用的是託管型 Claw,請前往您的 Claw Dashboard 並點擊 Open WebUI
- 如果您是自託管 LemonClaw,請開啟您自己的 WebUI(例如
http://your-ip:18789)並使用您的 token 登入 - 在 WebUI 中,導覽至 Settings → Channels
- 展開 Discord 區塊
- 貼上您的 Bot Token
- 點擊 Save
在伺服器中使用
群組設定
在 LemonClaw WebUI 的 Channels 設定中配置伺服器(guild)行為:| 設定 | 選項 | 描述 |
|---|---|---|
| Group Policy | 開放 (預設) / 白名單 / 已停用 | 控制對伺服器頻道的存取 |
| Require @mention | 開啟 / 關閉 | 機器人僅在被 @標記時回應(建議) |
| Group IDs | 伺服器 ID 列表 | 限制於特定伺服器(留空 = 所有伺服器) |
Discord 使用各伺服器獨立的使用者白名單,而非全域群組白名單。如需進階的各伺服器使用者過濾,請直接在 LemonClaw 設定檔中進行配置。
私訊(DM)策略
控制誰可以向您的機器人發送私訊:| 策略 | 行為 |
|---|---|
| 配對 (預設) | 新使用者會獲得配對碼 — 在 WebUI 中輸入以進行授權 |
| 白名單 | 僅限您指定的使用者 ID 可以私訊機器人 |
| 開放 | 任何人都可以私訊機器人(請謹慎使用) |
疑難排解
機器人在線但沒有回應
機器人在線但沒有回應
- 確保在 Developer Portal 中已啟用 Message Content Intent
- 驗證機器人 token 是否正確
- 檢查機器人是否擁有在該頻道讀取及發送訊息的權限
機器人顯示為離線
機器人顯示為離線
- 在儀表板中檢查您的實例狀態(應為綠色/執行中)
- 嘗試重新啟動實例
- 驗證 token 是否在 Developer Portal 中被重設
日誌中出現 409 Conflict 錯誤
日誌中出現 409 Conflict 錯誤
- 當兩個實例嘗試使用同一個機器人 token 時會發生此情況
- 確保只有一個 LemonClaw 實例配置了此 token