Clawdbot

Clawdbot 是一個個人 AI 助手，可在本地運行並透過 WebSocket Gateway 架構連接多個訊息平台。

⚠️ 開發中

此模板正在開發中。由於 Clawdbot 正在快速開發，本模板使用 main tag 以取得最新版本。

✅ 已完成

• Gateway 啟動並接受 WebSocket 連線
• Web UI 可透過公開網域載入
• Token 認證（無需裝置配對）
• AI 供應商認證（Anthropic API 金鑰）
• 透過 Web UI 與 AI 助手對話
• Zeabur AI Hub 整合
• Telegram 機器人連接

🔄 測試中

• WhatsApp 連接（QR code 登入）
• Discord 機器人連接
• Slack 整合

---

建議資源配置

資源需求可能因使用的工具和功能而異。

• 共享叢集：2000 m（2 vCPU）、2048 Mi（2 GB）
• 專用伺服器：推薦使用以獲得更好的效能

支援平台

• WhatsApp
• Telegram
• Slack
• Discord
• 更多訊息平台

使用方式

1. 部署完成後，系統會自動產生一組安全的 Gateway Token
2. 在使用說明頁籤找到預先產生的 URL
3. 點擊「Web UI (with token)」連結直接連線（Token 已包含在 URL 中）
4. 看到 Clawdbot 介面即表示部署完成
5. 前往 Chat 頁面測試 AI 供應商是否正常運作

更多詳情請參閱官方文件。

設定

• ZEABUR_AI_HUB_API_KEY：您的 Zeabur AI Hub API 金鑰（推薦）。在此取得 API 金鑰
• ANTHROPIC_API_KEY：您的 Anthropic Claude API 金鑰
• OPENAI_API_KEY：您的 OpenAI API 金鑰（選填，用於 OpenAI 功能如記憶搜尋、TTS 等）

Telegram 機器人設定

從 BotFather 取得 Token：

1. 開啟 Telegram 並搜尋 @BotFather
2. 發送 /newbot 建立新機器人
3. 依照提示設定機器人的名稱和使用者名稱
4. BotFather 會傳送 Token 給您（例如 123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

將 Token 加入 Zeabur：

1. 前往 Zeabur 控制台的服務環境變數頁籤
2. 新增 TELEGRAM_BOT_TOKEN 並填入您的 Token
3. 重新啟動服務

配對您的 Telegram 帳號：

1. 在 Telegram 向您的機器人發送 /start
2. 機器人會回覆配對碼（例如 JN4MSY23）
3. 在 Zeabur 控制台開啟指令進入容器終端
4. 執行：clawdbot pairing approve telegram <配對碼>
5. 看到 Approved telegram sender <user-id>. 表示配對成功
6. 現在可以開始與機器人對話了！

更多設定方式

除了環境變數外，您也可以透過以下方式設定 Clawdbot：

Web UI

1. 開啟 Clawdbot Web UI
2. 前往 Settings 設定模型、頻道和偏好設定

指令

1. 在 Zeabur 控制台開啟指令
2. 使用 clawdbot 指令管理供應商、模型和設定

修改預設模型

預設模型為 zeabur-ai/gpt-5-mini。修改方式：

透過 Web UI：

1. 在 Clawdbot Web UI 開啟 Settings
2. 從列表中選擇您偏好的模型

透過指令：

clawdbot config set agents.defaults.model.primary zeabur-ai/claude-sonnet-4-5

可用模型： gemini-3-pro-preview, gpt-5, claude-sonnet-4-5, gemini-3-flash-preview, gpt-5-mini, claude-haiku-4-5, gemini-2.5-flash, deepseek-v3.2

資料持久化

• /home/node/.clawdbot - 設定、會話和憑證
• /home/node/clawd - 工作區和記憶檔案

文件

• GitHub：https://github.com/clawdbot/clawdbot