Clawdbot 安裝指南
這是一份 Clawdbot 安裝指南。Clawdbot 是目前最熱門的開源個人 AI 助手，在 GitHub 已獲得超過 10K 星標。
📋 系統需求
| 項目 | 最低需求 |
|---|---|
| Node.js | 版本 22+ (必須) |
| 作業系統 | macOS、Linux、Windows (WSL2) |
| 記憶體 | 最少 2GB |
| 儲存空間 | 約 500MB |
🚀 安裝步驟（推薦方式）
Step 1
一鍵安裝腳本
macOS / Linux:
curl -fsSL https://clawd.bot/install.sh | bash
Windows (WSL2 中):
請先安裝 WSL2 並進入 Ubuntu 環境：
# 安裝 WSL2 wsl --install -d Ubuntu # 在 WSL2 終端執行 curl -fsSL https://clawd.bot/install.sh | bash
或使用 npm / pnpm 安裝:
npm install -g clawdbot@latest # 或 pnpm add -g clawdbot@latest
Step 2
驗證安裝
clawdbot --version # 應該輸出版本號，如: 2026.1.23-1
Step 3
執行引導精靈（最簡單）
clawdbot onboard --install-daemon
精靈會自動引導您完成以下配置：
- Gateway 設置
- AI 模型和認證
- 聊天頻道連接 (Discord/Telegram/WhatsApp)
- 安全設置
- 背景服務安裝（自動啟動）
Step 4
連接 Discord（推薦新手首選）
- 前往 Discord 開發者平台。
- 建立新應用 → 導覽至 Bot 部分。
- 開啟權限：Message Content Intent ✅。
- 點擊 Reset Token 並複製 Token。
- 在 OAuth2 生成連結：
https://discord.com/api/oauth2/authorize?client_id=YOUR_APP_ID&permissions=274877908992&scope=bot
Step 5
檢查狀態
clawdbot status
預期輸出如下：
Gateway: running (ws://127.0.0.1:18789)
Auth: configured (anthropic)
Channels: – discord: ready
Sessions: 0 active
📱 其他頻道設置
Telegram
clawdbot configure --section telegram
設定 botToken：從 @BotFather 獲取。
clawdbot channels login
掃描終端顯示的 QR Code 連接您的 WhatsApp 賬戶。
Slack
進入配置設定 Bot Token + App Token。
🐳 Docker 方式
如果你熟悉 Docker，這可能是最穩定的運行方式：
git clone https://github.com/clawdbot/clawdbot.git cd clawdbot ./docker-setup.sh
🔧 從源代碼安裝（開發者）
git clone https://github.com/clawdbot/clawdbot.git cd clawdbot pnpm install pnpm ui:build pnpm build pnpm clawdbot onboard --install-daemon # 開發模式 pnpm gateway:watch
💡 常用命令參考
| 功能 | 指令 |
|---|---|
| 查看完整狀態 | clawdbot status --all |
| 診斷工具 | clawdbot doctor |
| 發送測試消息 | clawdbot message send --to +123 --message "Hello" |
| AI 對話 (Thinking) | clawdbot agent --message "問題" --thinking high |
| 終端 UI 模式 | clawdbot tui |
🎯 配置文件位置
預設路徑：~/.clawdbot/
clawdbot.json— 主設置文件credentials/— OAuth 令牌和會話agents/— AI 代理配置
⚠️ Windows 用戶重要提示
強烈建議使用 WSL2！原生 Windows 環境目前不支援。
強烈建議使用 WSL2！原生 Windows 環境目前不支援。
🚀 快速啟動 (TL;DR)
# 1. 安裝 npm install -g clawdbot@latest # 2. 快速設置 clawdbot onboard --install-daemon # 3. 啟動服務 clawdbot gateway --port 18789 --verbose # 4. 測試對話 clawdbot agent --message "列出我的下載文件夾中的文件"
