Clawdbot 完整使用指南

目錄

1. 概念介紹
2. 核心功能
3. 使用方法
4. OAuth 配置完整指南
5. 快速切換 AI Model
6. 常用指令
7. 成本估算
8. 安全警告
9. 常見 Q&A

概念介紹

什麼是 Clawdbot？

Clawdbot 是一款開源的個人 AI 助手，其核心理念是將 AI 能力下沈到用戶自己的設備上，而非依賴遠端雲端服務。

核心特色：

• 本地優先的架構（Local-first）
• 支援多通訊平台整合（WhatsApp、Telegram、Discord、Slack 等）
• 具有真正的行動能力（可操控電腦）
• 擁有複雜的記憶系統
• 完全開源免費

核心架構

你的通訊軟體 (WhatsApp/Telegram/等)
        ↓
   通訊平台伺服器
        ↓
你的電腦上的 Gateway（本地網關）
        ↓
Claude / ChatGPT / Gemini（本地運行）
        ↓
回覆訊息 + 執行任務

重點：所有 AI 運算都在你的電腦上進行，資料不上傳到任何第三方伺服器。

核心功能

1. 記憶與理解能力

Clawdbot 擁有真正的長期記憶機制，不同於 ChatGPT 每次都要重新提供背景。它會：

• 自動生成 Markdown 日記形式的「記憶檔案」，記錄每天的所有互動
• 記住你的偏好、習慣和過去的對話
• 甚至記得你兩週前隨口提過的一件小事，隨著時間推移越來越懂你

2. 主動出擊能力

與傳統 AI 被動等待不同，Clawdbot 會主動找你：

• 晨間簡報：起床時自動發送當日行程、緊急郵件、待辦事項摘要
• 股票監控：你關注的股票下跌時主動警報
• 天氣提醒：明天天氣不好時提前通知
• 郵件提醒：收到緊急郵件時立即通知

3. 真正的行動能力

Clawdbot 不只回答問題，它能直接操控你的電腦：

• 瀏覽器自動化：自動登入網站、點擊、填表、截圖
• Shell 命令執行：運行程式、修改設定、安裝軟體
• 檔案系統操作：讀寫檔案、整理資料夾
• 設備控制：相機拍照、螢幕錄製（如有手機節點連接）

具體應用場景

使用方法：30 分鐘快速上手

第一步：選擇運行環境（5 分鐘）

選項 A：使用免費 AWS 伺服器（推薦入門）

• 申請 AWS 免費方案，獲得 100 美元抵用金
• 啟動 EC2 實例（Ubuntu 系統）
• 完全免費運行 Clawdbot

選項 B：本地電腦運行

• 直接在 macOS、Linux、Windows（WSL2）上安裝
• 設備需求：1GB 記憶體以上

選項 C：便宜的 VPS

• 如 Hetzner 的 5 美元/月伺服器
• 官方推薦方案

第二步：安裝 Clawdbot（3 分鐘）

在終端機執行一行指令即可：

curl -fsSL https://clawd.bot/install.sh | bash

安裝完成後會自動跳出設定精靈。

第三步：選擇 AI 模型與通訊方式（10 分鐘）

設定精靈會引導你選擇：

1. 選擇 AI 模型

• Claude（Anthropic） - 官方推薦，長上下文記憶能力強，抗提示詞注入
• ChatGPT（OpenAI） - 可選，根據個人偏好
• Gemini（Google） - 可選

2. 獲取 API Token

系統會要求你：

• 在自己電腦執行指令生成 Token，或
• 在瀏覽器登入 LLM 帳號

OpenAI 例子：

1. 訪問 platform.openai.com/api-keys
2. 點擊「Create new secret key」
3. 複製 Token 貼回設定精靈

3. 選擇通訊平台

支援的平台：

• Telegram（最推薦，設定最簡單）
• WhatsApp
• Discord
• Slack
• Signal
• Microsoft Teams
• Google Chat
• iMessage（macOS 限定）
• 未來：LINE（待開發）

第四步：連接通訊軟體（5 分鐘，以 Telegram 為例）

Telegram 連接步驟（詳細版）

步驟 1：建立 Telegram Bot

1. 打開 Telegram，搜尋 @botfather
2. 發送指令 /newbot
3. BotFather 會詢問：
   • Bot 的顯示名稱（例如：My AI Assistant）
   • Bot 的用戶名（必須以 bot 結尾，例如：my_ai_assistant_bot）
4. BotFather 會給你一串 Bot Token（格式類似：1234567890:ABCdefGHIjklMNOpqrsTUVwxyz）
5. 重要：立即複製這個 Token，不要分享給任何人

步驟 2：設定 Clawdbot 連接

# 方法 A：使用設定精靈（推薦，首次設定）
clawdbot channels login

# 方法 B：直接設定（進階使用者）
# 編輯配置檔案 ~/.clawdbot/clawdbot.json

選擇 Telegram 作為通訊平台，然後貼上剛才取得的 Bot Token。

步驟 3：初始化對話

1. 回到 Telegram，搜尋你剛建立的 Bot（使用 Bot 的用戶名）
2. 點擊 Start 或發送 /start
3. Bot 會詢問一些初始設定問題：
   • 你該叫我什麼名字？（例如：小明、Jason）
   • 你該叫我什麼？（例如：助理、AI、小幫手）
   • 我的存在目的是什麼？（例如：協助我處理日常任務）
   • 你在哪個時區？（例如：Asia/Taipei、GMT+8）
4. 回答完成後，Bot 會確認設定並開始運作

步驟 4：驗證連線

# 檢查頻道狀態
clawdbot channels status

# 預期輸出應該包含類似：
# ✓ telegram: connected
# └─ Bot: @your_bot_name

# 查看完整狀態
clawdbot status --deep

# 測試發送訊息（可選）
clawdbot message send --target telegram --message "測試連線" --json

預期結果：

• clawdbot channels status 應該顯示 Telegram 頻道為 connected 狀態
• 在 Telegram 中發送任何訊息，Bot 應該會回應

常見問題排解

問題 1：Bot Token 錯誤

Error: Invalid bot token

解決方案：

• 確認 Token 完整複製（包含所有字元）
• 向 @botfather 發送 /token 重新獲取
• 確認沒有多餘的空格或換行

問題 2：頻道狀態顯示為空

# 執行
clawdbot channels status
# 沒有顯示任何頻道

解決方案：

# 重新登入
clawdbot channels login

# 如果還是失敗，檢查 Gateway
clawdbot gateway status
clawdbot gateway restart

問題 3：Bot 不回應訊息

# 1. 檢查 Gateway 是否運行
clawdbot gateway status

# 2. 檢查 Model 認證
clawdbot models status

# 3. 查看 logs 找出錯誤
clawdbot logs --tail 50

# 4. 重啟 Gateway
clawdbot gateway restart

問題 4：找不到 Bot

• 確認 Bot 用戶名輸入正確
• 確認 Bot 已透過 @botfather 建立成功
• 在 Telegram 搜尋時要包含 @ 符號（例如：@my_ai_assistant_bot）

完整檢查清單

設定完成後，確認以下項目：

• BotFather 顯示 Bot 建立成功
• 已取得並保存 Bot Token
• clawdbot channels status 顯示 Telegram 已連接
• clawdbot models status 顯示至少一個 AI model 已認證
• clawdbot gateway status 顯示 Gateway 正在運行
• 在 Telegram 中發送訊息，Bot 有回應
• Bot 的初始設定問題已回答完成

其他平台連接

WhatsApp：

clawdbot channels login

然後掃描二維碼連結設備

Discord/Slack：

• 設定相應的 Bot Token

第五步：可選 - 啟用高級功能（額外 5 分鐘）

開啟聯網搜尋

Set up Brave search with this API key: [你的 Key]

在 brave.com/search/api 申請免費 API Key

連接外部服務

• GitHub
• Google Drive
• Google Calendar
• Todoist
• WHOOP 運動手環
• 等等

OAuth 配置完整指南

概述

Clawdbot 支援三種主流 AI 模型，全部使用 OAuth 認證（更安全，無需手動管理 API Key）：

1. 啟用 OAuth Plugins

# 啟用 Gemini OAuth plugin
clawdbot plugins enable google-gemini-cli-auth

# 重啟 gateway 套用變更
clawdbot gateway restart

2. 執行 OAuth 登入

Claude OAuth

clawdbot models auth login --provider anthropic

• 會開啟瀏覽器
• 登入你的 Anthropic 帳號
• 授權完成後自動儲存 token

Gemini OAuth

clawdbot models auth login --provider google-gemini-cli

• 會開啟瀏覽器
• 登入 Google 帳號
• 授權 Gemini CLI 存取權限

Codex (OpenAI) OAuth

clawdbot models auth login --provider openai-codex

• 會開啟瀏覽器
• 登入 ChatGPT 帳號（需要 Plus 訂閱）
• 授權完成後自動儲存

3. 檢查認證狀態

# 查看所有 model 的認證狀態
clawdbot models status

# 查看 OAuth token 有效期
clawdbot models status | grep -A 10 "OAuth/token status"

範例輸出：

OAuth/token status
- anthropic usage: 5h 45% left ⏱2h 16m
  - anthropic:claude-cli expiring expires in 52m (claude-cli)
- google-gemini-cli usage: Pro 100% left · Flash 100% left
  - google-gemini-cli:jason@example.com expiring expires in 54m
- openai-codex usage: 5h 100% left ⏱5h · Day 100% left ⏱Feb 2
  - openai-codex:codex-cli ok expires in 10d (codex-cli)

4. 設定預設 Model

# 查看可用的 models
clawdbot models list

# 設定預設 model（選擇一個）
clawdbot models set anthropic/claude-sonnet-4-5              # Claude Sonnet 4.5
clawdbot models set google-gemini-cli/gemini-3-pro-preview   # Gemini 3 Pro Preview
clawdbot models set openai-codex/gpt-5.2-codex               # Codex (GPT-5.2)

# 查看當前設定
clawdbot models status | grep "Default"

5. 測試三種 Model

⚠️ 重要：agent 指令需要指定 session

使用 clawdbot agent 指令時，必須加上以下其中一個參數：

• --session-id <id> - 指定 session ID（最簡單，適合測試）
• --to <E.164> - 指定電話號碼（例如：+886912345678）
• --agent <id> - 指定 agent ID

方式 1：使用 clawdbot agent 指令測試

# ✅ 測試 Claude Sonnet 4.5（推薦，最快速）
clawdbot models set anthropic/claude-sonnet-4-5
clawdbot agent --session-id test-claude --message "你好，請用繁體中文自我介紹" --json

# ✅ 測試 Gemini 3 Pro Preview（支援大 context）
clawdbot models set google-gemini-cli/gemini-3-pro-preview
clawdbot agent --session-id test-gemini --message "你好，請用繁體中文自我介紹" --json

# ✅ 測試 Codex (GPT-5.2)（最新代碼模型）
clawdbot models set openai-codex/gpt-5.2-codex
clawdbot agent --session-id test-codex --message "你好，請用繁體中文自我介紹" --json

注意事項：

• Claude Sonnet 4.5: 最快（~10秒），適合日常對話和快速任務
• Gemini 3 Pro: 較慢（~2分鐘），但支援超大 context window (1024k)
• Codex (GPT-5.2): 快速（~15秒），專為代碼任務優化

方式 2：在通訊軟體中測試（推薦）

發送訊息到你的 Telegram/WhatsApp bot：

你好，請自我介紹一下

通訊軟體中的測試會自動使用預設 model，無需指定 session-id。切換 model 後再測試以比較回應風格。

測試結果預期

Claude Sonnet 4.5 回應範例：

{
  "status": "ok",
  "result": {
    "payloads": [{
      "text": "你好！我是 Claude，由 Anthropic 公司開發的 AI 助手..."
    }],
    "meta": {
      "durationMs": 10401,
      "agentMeta": {
        "provider": "anthropic",
        "model": "claude-sonnet-4-5",
        "usage": {
          "input": 10,
          "output": 472
        }
      }
    }
  }
}

Gemini 3 Pro Preview 回應範例：

{
  "status": "ok",
  "result": {
    "payloads": [{
      "text": "你好！我是由 Google 的 Gemini 3 Pro 模型驅動的 AI 助手..."
    }],
    "meta": {
      "durationMs": 142208,
      "agentMeta": {
        "provider": "google-gemini-cli",
        "model": "gemini-3-pro-preview",
        "usage": {
          "input": 6004,
          "output": 905
        }
      }
    }
  }
}

注意: Gemini 回應較慢（~2分鐘），這是正常現象。

Codex (GPT-5.2) 回應範例：

{
  "status": "ok",
  "result": {
    "payloads": [{
      "text": "你好！我是你的個人助理 AI，使用的模型是 openai-codex/gpt-5.2-codex..."
    }],
    "meta": {
      "durationMs": 15377,
      "agentMeta": {
        "provider": "openai-codex",
        "model": "gpt-5.2-codex",
        "usage": {
          "input": 218,
          "output": 185
        }
      }
    }
  }
}

6. Token 更新管理

自動更新（推薦）

OAuth tokens 會在接近過期時自動更新（如果有 refresh token）。

手動更新

如果 token 過期，重新執行登入即可：

clawdbot models auth login --provider anthropic
clawdbot models auth login --provider google-gemini-cli
clawdbot models auth login --provider openai-codex

7. 移除舊的 API Keys（可選）

如果之前用 API Key 方式設定，現在改用 OAuth，可以清理環境變數：

# 檢查哪裡設定了 API Keys
grep -r "ANTHROPIC_API_KEY\|GEMINI_API_KEY\|OPENAI_API_KEY" \
  ~/.bashrc ~/.zshrc ~/.profile ~/.bash_profile 2>/dev/null

# 編輯對應檔案移除這些環境變數
vim ~/.bashrc  # 或其他檔案

# 重新載入環境
source ~/.bashrc

8. 疑難排解

問題：OAuth 登入失敗

# 檢查 gateway 是否運行
clawdbot gateway status

# 重啟 gateway
clawdbot gateway restart

# 檢查是否有錯誤
clawdbot logs --tail 50

問題：Token 過期

# 重新登入即可
clawdbot models auth login --provider <provider-name>

問題：找不到認證檔案

# 檢查認證檔案位置
ls -la ~/.clawdbot/agents/main/agent/auth-profiles.json

# 查看檔案內容（確認 token 存在）
cat ~/.clawdbot/agents/main/agent/auth-profiles.json | jq '.profiles | keys'

問題：agent 指令要求 session-id

Error: Pass --to <E.164>, --session-id, or --agent to choose a session

解決方案：agent 指令必須指定 session，使用以下任一參數：

# 方法 1：使用 session-id（最簡單，適合測試）
clawdbot agent --session-id test --message "你好" --json

# 方法 2：使用電話號碼（E.164 格式）
clawdbot agent --to +886912345678 --message "你好" --json

# 方法 3：指定 agent ID
clawdbot agent --agent main --message "你好" --json

問題：Model 不可用 (Unknown model)

Error: Unknown model: openai-codex/gpt-5.2-codex

原因：使用了錯誤的 model ID

解決方案：

# 1. 檢查可用的 models
clawdbot models list | grep -v "missing"

# 2. 使用正確的 Model ID
clawdbot models set anthropic/claude-sonnet-4-5              # Claude
clawdbot models set google-gemini-cli/gemini-3-pro-preview   # Gemini
clawdbot models set openai-codex/gpt-5.2-codex               # Codex (正確)

# 3. 確認設定
clawdbot models status | grep "Default"

問題：Gemini 回應很慢 (~2 分鐘)

原因：這是 Gemini 3 Pro Preview 的正常行為

說明：

• Gemini 平均回應時間：120-150 秒
• Claude 平均回應時間：10-15 秒
• Codex 平均回應時間：15-20 秒

建議：

• 日常對話使用 Claude Sonnet 4.5（最快）
• 需要大 context 時使用 Gemini（支援 1024k）
• 代碼任務使用 Codex GPT-5.2（代碼優化）

問題：Gemini 容量不足 (429 Error) - 已少見

Cloud Code Assist API error (429): No capacity available for model gemini-3-pro-preview

解決方案：

• Google 伺服器暫時容量不足（目前已較少發生）
• 稍後再試（通常幾分鐘後恢復）
• 或暫時切換到其他 model（Claude 或 Codex）

遠端控制電腦的原理

運作流程

1. 你用通訊軟體（WhatsApp/Telegram/等）發送命令
2. 通訊平台伺服器將訊息轉發到你電腦上的 Clawdbot Gateway
3. Gateway 將命令傳給 Claude/ChatGPT 等 AI 模型
4. AI 執行實際操作：
   • 控制瀏覽器（自動化點擊、填表、登入）
   • 執行 Shell 命令（運行程式、修改檔案）
   • 存取檔案系統（讀寫資料夾）
5. 完成後，結果（文字、截圖、檔案等）透過通訊軟體回傳給你

LINE 整合（未來支援）

雖然目前 LINE 還未整合，但一旦支援，流程將是：

你的 LINE 應用
    ↓
LINE 伺服器
    ↓
你的電腦 Gateway
    ↓
Claude/ChatGPT
    ↓
回覆 + 執行任務

快速切換 AI Model

Clawdbot 支援在多個 AI 模型之間快速切換，以下提供三種方法：

方法 1：使用 Model Aliases（最推薦）

設定 Aliases

# 為常用 models 設定簡短別名
clawdbot models aliases add claude anthropic/claude-sonnet-4-5
clawdbot models aliases add opus anthropic/claude-opus-4-5
clawdbot models aliases add gemini google-gemini-cli/gemini-3-pro-preview
clawdbot models aliases add codex openai-codex/gpt-5.2-codex

# 查看所有 aliases
clawdbot models aliases list

快速切換

# 使用 alias 快速切換
clawdbot models set claude    # 切換到 Claude Sonnet 4.5
clawdbot models set gemini    # 切換到 Gemini 3 Pro
clawdbot models set codex     # 切換到 Codex GPT-5.2
clawdbot models set opus      # 切換到 Claude Opus 4.5

# 查看當前使用的 model
clawdbot models status | grep "Default"

方法 2：快速切換腳本（推薦進階使用者）

建立一個快速切換腳本，更方便管理：

建立腳本檔案

將以下內容儲存為 ~/clawdbot-switch.sh：

#!/bin/bash
# Clawdbot 快速切換 AI Model 腳本

case "$1" in
  claude)
    echo "🤖 切換到 Claude Sonnet 4.5..."
    clawdbot models set claude
    ;;
  opus)
    echo "🤖 切換到 Claude Opus 4.5..."
    clawdbot models set opus
    ;;
  gemini)
    echo "🤖 切換到 Gemini 3 Pro Preview..."
    clawdbot models set gemini
    ;;
  codex)
    echo "🤖 切換到 Codex GPT-5.2..."
    clawdbot models set codex
    ;;
  status)
    echo "📊 當前 Model 狀態："
    clawdbot models status | grep -A 3 "Default\|Primary"
    ;;
  list)
    echo "📋 可用的 Models："
    clawdbot models aliases list
    ;;
  *)
    echo "用法: $0 {claude|opus|gemini|codex|status|list}"
    echo ""
    echo "快速切換 AI Model："
    echo "  $0 claude   - 切換到 Claude Sonnet 4.5（快速、日常對話）"
    echo "  $0 opus     - 切換到 Claude Opus 4.5（最強推理）"
    echo "  $0 gemini   - 切換到 Gemini 3 Pro（大 context）"
    echo "  $0 codex    - 切換到 Codex GPT-5.2（代碼優化）"
    echo "  $0 status   - 查看當前使用的 model"
    echo "  $0 list     - 列出所有可用 models"
    exit 1
    ;;
esac

設定執行權限

chmod +x ~/clawdbot-switch.sh

使用範例

# 切換到 Claude（快速、日常對話）
~/clawdbot-switch.sh claude

# 切換到 Gemini（大 context，約 2 分鐘回應）
~/clawdbot-switch.sh gemini

# 切換到 Codex（代碼優化）
~/clawdbot-switch.sh codex

# 切換到 Opus（最強推理）
~/clawdbot-switch.sh opus

# 查看當前使用的 model
~/clawdbot-switch.sh status

# 列出所有可用 models
~/clawdbot-switch.sh list

方法 3：Shell Aliases（最快速）

在 ~/.bashrc 或 ~/.zshrc 中加入以下內容：

# Clawdbot Model 快速切換
alias cb-switch='~/clawdbot-switch.sh'
alias cb-claude='clawdbot models set claude'
alias cb-gemini='clawdbot models set gemini'
alias cb-codex='clawdbot models set codex'
alias cb-opus='clawdbot models set opus'
alias cb-status='clawdbot models status | grep -A 3 "Default"'
alias cb-list='clawdbot models aliases list'

重新載入配置：

source ~/.bashrc   # 或 source ~/.zshrc

使用範例：

cb-claude    # 切換到 Claude Sonnet 4.5
cb-gemini    # 切換到 Gemini 3 Pro
cb-codex     # 切換到 Codex GPT-5.2
cb-opus      # 切換到 Claude Opus 4.5
cb-status    # 查看當前狀態
cb-list      # 列出所有 aliases

Model 選擇建議

注意事項

⚠️ 切換後的行為：

• 切換 model 後，在 Telegram 的下一次對話就會使用新的 model
• 不需要重啟 Gateway
• 切換是即時生效的
• 不會影響現有的對話歷史和記憶

建議工作流程

# 早上起床，用 Claude 處理日常對話
cb-claude

# 需要分析長文件時，切換到 Gemini
cb-gemini

# 寫程式時，切換到 Codex
cb-codex

# 需要最強推理時，切換到 Opus
cb-opus

# 隨時查看當前使用的 model
cb-status

一鍵安裝腳本

快速安裝切換腳本並設定 aliases：

# 下載腳本（如果你有放在 GitHub）
curl -o ~/clawdbot-switch.sh https://your-repo/clawdbot-switch.sh
chmod +x ~/clawdbot-switch.sh

# 或直接建立腳本
cat > ~/clawdbot-switch.sh << 'EOF'
#!/bin/bash
# Clawdbot 快速切換 AI Model 腳本

case "$1" in
  claude)
    echo "🤖 切換到 Claude Sonnet 4.5..."
    clawdbot models set claude
    ;;
  opus)
    echo "🤖 切換到 Claude Opus 4.5..."
    clawdbot models set opus
    ;;
  gemini)
    echo "🤖 切換到 Gemini 3 Pro Preview..."
    clawdbot models set gemini
    ;;
  codex)
    echo "🤖 切換到 Codex GPT-5.2..."
    clawdbot models set codex
    ;;
  status)
    echo "📊 當前 Model 狀態："
    clawdbot models status | grep -A 3 "Default\|Primary"
    ;;
  list)
    echo "📋 可用的 Models："
    clawdbot models aliases list
    ;;
  *)
    echo "用法: $0 {claude|opus|gemini|codex|status|list}"
    echo ""
    echo "快速切換 AI Model："
    echo "  $0 claude   - 切換到 Claude Sonnet 4.5（快速、日常對話）"
    echo "  $0 opus     - 切換到 Claude Opus 4.5（最強推理）"
    echo "  $0 gemini   - 切換到 Gemini 3 Pro（大 context）"
    echo "  $0 codex    - 切換到 Codex GPT-5.2（代碼優化）"
    echo "  $0 status   - 查看當前使用的 model"
    echo "  $0 list     - 列出所有可用 models"
    exit 1
    ;;
esac
EOF

chmod +x ~/clawdbot-switch.sh

# 自動加入 aliases 到 ~/.bashrc
cat >> ~/.bashrc << 'EOF'

# Clawdbot Model 快速切換
alias cb-switch='~/clawdbot-switch.sh'
alias cb-claude='clawdbot models set claude'
alias cb-gemini='clawdbot models set gemini'
alias cb-codex='clawdbot models set codex'
alias cb-opus='clawdbot models set opus'
alias cb-status='clawdbot models status | grep -A 3 "Default"'
alias cb-list='clawdbot models aliases list'
EOF

# 重新載入配置
source ~/.bashrc

echo "✅ 安裝完成！現在可以使用 cb-claude, cb-gemini, cb-codex 等指令快速切換 Model"

常用指令

通訊軟體中的指令

在任何通訊軟體（Telegram/WhatsApp/Discord 等）中可使用：

CLI 命令行指令

Gateway 管理

# 啟動 gateway
clawdbot gateway

# 強制啟動（自動 kill 佔用的 port）
clawdbot gateway --force

# 指定 port
clawdbot gateway --port 18789

# 查看 gateway 狀態
clawdbot gateway status

# 重啟 gateway
clawdbot gateway restart

# 停止 gateway
clawdbot gateway stop

# 查看即時 logs
clawdbot logs --tail 50

# 持續監看 logs
clawdbot logs --follow

Model 管理

# 列出所有可用 models
clawdbot models list

# 查看 model 認證狀態
clawdbot models status

# 設定預設 model
clawdbot models set anthropic/claude-sonnet-4-5

# OAuth 登入
clawdbot models auth login --provider anthropic
clawdbot models auth login --provider google-gemini-cli
clawdbot models auth login --provider openai-codex

# 查看認證 profiles
clawdbot models auth order

Agent 管理

# 列出所有 agents
clawdbot agents list

# 添加新 agent
clawdbot agents add

# 刪除 agent
clawdbot agents delete <agent-id>

# 發送訊息給 agent
clawdbot agent --message "你好" --json

# 指定 agent 處理
clawdbot agent --agent ops --message "產生報告"

# 指定 session
clawdbot agent --to +886912345678 --message "查詢狀態"

# 直接傳送回覆到通訊軟體
clawdbot agent --message "總結今天的工作" --deliver

# 本地執行（不透過 Gateway）
clawdbot agent --local --message "分析程式碼"

通訊頻道管理

# 查看頻道狀態
clawdbot channels status

# 登入頻道（例如 WhatsApp）
clawdbot channels login

# 查看 sessions
clawdbot sessions

# 發送訊息
clawdbot message send --target +886912345678 --message "Hi" --json

Plugin 管理

# 列出所有 plugins
clawdbot plugins list

# 查看 plugin 詳情
clawdbot plugins info <plugin-id>

# 啟用 plugin
clawdbot plugins enable <plugin-id>

# 停用 plugin
clawdbot plugins disable <plugin-id>

# 安裝 plugin
clawdbot plugins install <path-or-npm-spec>

# 更新 plugins
clawdbot plugins update

系統診斷

# 健康檢查
clawdbot doctor

# 系統健康狀態
clawdbot health

# 查看頻道和 session 狀態
clawdbot status

# 配置管理
clawdbot config get <path>
clawdbot config set <path> <value>
clawdbot config unset <path>

其他工具

# 開啟控制面板
clawdbot dashboard

# 查看 cron 排程
clawdbot cron

# 記憶體搜尋
clawdbot memory

# 瀏覽器管理
clawdbot browser

# 沙箱工具
clawdbot sandbox

# 更新 CLI
clawdbot update

# 重設配置
clawdbot reset

# 完全移除
clawdbot uninstall

快速檢查指令組合

# 全面狀態檢查
clawdbot gateway status && \
clawdbot models status && \
clawdbot channels status && \
clawdbot agents list

# 重啟並檢查
clawdbot gateway restart && \
sleep 3 && \
clawdbot health

# 查看最近錯誤
clawdbot logs --tail 100 | grep -i error

測試連線

# ✅ 測試 Claude Sonnet 4.5（最快速）
clawdbot models set anthropic/claude-sonnet-4-5
clawdbot agent --session-id test-claude --message "測試 Claude 連線" --json | jq '.result.payloads[0].text'

# ✅ 測試 Gemini 3 Pro（支援大 context，較慢約 2 分鐘）
clawdbot models set google-gemini-cli/gemini-3-pro-preview
clawdbot agent --session-id test-gemini --message "測試 Gemini 連線" --json | jq '.result.payloads[0].text'

# ✅ 測試 Codex GPT-5.2（代碼優化）
clawdbot models set openai-codex/gpt-5.2-codex
clawdbot agent --session-id test-codex --message "測試 Codex 連線" --json | jq '.result.payloads[0].text'

# 簡化測試（不使用 jq，查看完整 JSON）
clawdbot agent --session-id test --message "Hello" --json

實際使用例子

你：「查查看今天有沒有重要郵件」
機器人：「你有 3 封郵件：1 件來自老闆，2 件來自客戶，我已幫你分類。」

你：「監控 Amazon 上 iPhone 15 的價格，降到 $700 以下就通知我」
機器人：「✓ 已設定監控，每小時檢查一次。」
[6 小時後]
機器人：「✓ 價格降到 $699！[截圖]」

你：「幫我在 Excel 帳本裡找過去一年最貴的一筆支出」
機器人：「找到了！2025 年 3 月買的 MacBook Pro，花費 $3,200。我也列出了前 10 大支出。」

成本估算

月度成本分析

成本對比：

• 傳統人類助理：月薪 $2,000+
• Clawdbot：$20-30/月
• 節省：90% 以上

如何控制成本

1. 設定硬上限：在 OpenAI 的「Billing」設定中設定上限金額（如 $20），超過後機器人自動停止

2. 選擇便宜模型：

   • Claude API：按 token 計費，便宜
   • OpenAI：也很便宜，個人用途通常 $3-10/月

3. 使用 AWS 免費層：第一年完全免費

安全警告 ⚠️

絕對不要在以下電腦上安裝 Clawdbot

• 有加密貨幣錢包或私鑰的設備
• 存有重要財務資訊的機器
• 有高度安全敏感性的工作電腦

為什麼這麼危險？

1. Clawdbot 需要 Shell 存取與完整檔案系統讀寫權限（相當於開啟一個巨大後門）
2. 一旦 AI 被提示詞注入攻擊或誤判，可能執行危險操作
3. 有可能不小心安裝病毒或刪除重要檔案
4. 歷史例子：有人不小心讓 AI 刪除了他的整個資料庫

安全防護措施

DM 配對模式

• 陌生人先收到配對碼確認
• 確認前機器人不執行任何指令

白名單控制

• 設定 allowFrom 限制互動用戶
• 只允許特定 LINE/Telegram 帳號

沙箱隔離

• 群組中的非主會話在 Docker 沙盒運行
• 防止誤操作影響系統

診斷工具

clawdbot doctor

執行此命令檢查潛在安全風險

最佳實踐

1. 用獨立電腦運行：

   • 買一台 Mac mini（$600）或便宜 VPS（$5/月）
   • 不要在主電腦安裝

2. 定期審查：

   • 定期檢查機器人執行了什麼操作
   • 保持 Clawdbot 軟體更新

3. 限制權限：

   • 不要給 Clawdbot 存取銀行帳戶、加密錢包等敏感設備
   • 只在非關鍵系統上運行

4. 啟用所有防護：

   • 啟用 DM 配對模式
   • 設定白名單
   • 啟用沙箱隔離

常見 Q&A

Q：我不懂技術，能安裝嗎？

A：可以。Clawdbot 只需要複製貼上命令，按照引導精靈走。不會編碼也沒關係，遇到問題可以問 ChatGPT。目前網路上已有大量教學影片。

Q：如果聊太多會不會破產？

A：可以設定硬上限。在 OpenAI 的「Billing」設定中設定上限金額（如 $20），超過後機器人自動停止，不會刷爆信用卡。

Q：機器人壞掉了怎麼辦？

A：99% 的問題重啟即可。重新登入伺服器，執行：

NODE_OPTIONS="--max-old-space-size=2048" clawdbot gateway --force

Q：我有 ChatGPT Plus ($20/月)，為什麼還要付 API 費用？

A：這是兩個不同的錢包：

• ChatGPT Plus：網頁吃到飽，$20/月
• API：機器人計量付費，個人用途通常只需 $3-10/月

兩者互不影響，可以都訂，或只訂其中一個。

Q：線上時數有限制嗎？

A：沒有。Clawdbot 在雲端伺服器上 24/7 自動運行，即使你關電腦也不影響。

Q：我可以同時連接多個通訊軟體嗎？

A：完全可以。你可以同時在 WhatsApp、Telegram、Discord、Slack 中都連接同一個 Clawdbot，所有會話共享同一份記憶。

Q：Clawdbot 會記得我多久以前的事？

A：理論上永久記得。Clawdbot 會自動生成 Markdown 日記，記錄每天的所有互動。你可以隨時查詢幾個月前的對話。

Q：如果我換了 AI 模型（從 Claude 改成 ChatGPT），會不會丟失記憶？

A：不會。Clawdbot 的記憶系統獨立於 LLM，所以換模型不影響記憶。

Q：GitHub 上有多少開發者在維護這個專案？

A：截至 2026 年 1 月，Clawdbot 已達約 24,600 顆星，擁有超過 280 位貢獻者，是非常活躍的開源專案。

下一步行動

立即開始（5 分鐘）

1. 選擇運行環境（AWS / 本地 / VPS）
2. 執行安裝指令
3. 連接 Telegram
4. 發送第一條訊息給機器人

深度配置（30 分鐘）

1. 連接多個通訊軟體（WhatsApp、Discord 等）
2. 設定聯網搜尋
3. 連接外部服務（Google Calendar、GitHub 等）
4. 設定定時任務

進階應用（1-2 小時）

1. 設定自動化工作流（如晨間簡報）
2. 建立自訂指令
3. 整合特殊業務流程
4. 與團隊共享使用

資源連結

• GitHub：https://github.com/clawdbot/clawdbot
• 官網：https://clawd.bot
• 文件：https://docs.clawd.bot
• 社群：GitHub Discussions、Discord

總結

Clawdbot = ChatGPT + Siri + 自動化機器 + 完整記憶

• ChatGPT 的能力：可以思考、分析、寫作
• Siri 的形態：整合進你的日常通訊軟體，隨時召喚
• 自動化機器：真的能控制電腦執行任務
• 完整記憶：記得所有細節，越用越懂你

用 30 分鐘、花費每月 $20-30，你就能擁有一個真正的 AI 超級秘書。

快速參考卡

每日檢查指令

# 查看系統狀態
clawdbot gateway status
clawdbot models status
clawdbot health

# 查看 OAuth 有效期
clawdbot models status | grep "expires in"

# 查看最近 logs
clawdbot logs --tail 20

OAuth 更新（Token 過期時）

# Claude
clawdbot models auth login --provider anthropic

# Gemini
clawdbot models auth login --provider google-gemini-cli

# Codex
clawdbot models auth login --provider openai-codex

切換 Model

# 切換到 Claude
clawdbot models set anthropic/claude-sonnet-4-5

# 切換到 Gemini
clawdbot models set google-gemini-cli/gemini-3-pro-preview

# 切換到 Codex
clawdbot models set openai-codex/gpt-5.2-codex

重啟 Gateway（遇到問題時）

# 標準重啟
clawdbot gateway restart

# 強制重啟（清理舊 process）
clawdbot gateway stop
sleep 2
clawdbot gateway --force

測試 AI 回應

# 快速測試（使用當前預設 model，必須指定 session-id）
clawdbot agent --session-id test --message "測試連線" --json

# 測試特定 model
clawdbot agent --session-id test-claude --message "你是什麼 AI?" --json

# 測試並傳送到通訊軟體（需要先設定通訊頻道）
clawdbot agent --session-id test --message "測試訊息" --deliver --reply-channel telegram

記憶檔案位置

# Agent 記憶體目錄
~/.clawdbot/agents/main/agent/

# 認證檔案
~/.clawdbot/agents/main/agent/auth-profiles.json

# 配置檔案
~/.clawdbot/clawdbot.json

# Logs 目錄
/tmp/clawdbot/

故障排除 Checklist

1. Gateway 無法啟動

   clawdbot gateway status
   clawdbot doctor
   lsof -i :18789  # 檢查 port 是否被佔用
   

2. OAuth 過期

   clawdbot models status | grep "expiring"
   clawdbot models auth login --provider <provider>
   

3. Agent 無回應

   clawdbot health
   clawdbot logs --tail 50
   clawdbot gateway restart
   

4. 通訊頻道離線

   clawdbot channels status
   clawdbot channels login
   

效能優化

# 檢查記憶體使用
ps aux | grep clawdbot

# 設定記憶體限制
NODE_OPTIONS="--max-old-space-size=2048" clawdbot gateway --force

# 清理舊 sessions
clawdbot sessions | grep -i inactive

備份重要資料

# 備份配置和認證
tar -czf clawdbot-backup-$(date +%Y%m%d).tar.gz \
  ~/.clawdbot/clawdbot.json \
  ~/.clawdbot/agents/main/agent/auth-profiles.json

# 還原備份
tar -xzf clawdbot-backup-YYYYMMDD.tar.gz -C ~/

進階技巧

1. 多 Agent 配置

不同的 agent 可以用不同的 model：

# 添加專用 agent
clawdbot agents add

# 為不同 agent 設定不同的 workspace
# 編輯 ~/.clawdbot/clawdbot.json
{
  "agents": {
    "main": { "model": "anthropic/claude-sonnet-4-5" },
    "research": { "model": "google-gemini-cli/gemini-3-pro-preview" },
    "coding": { "model": "openai-codex/gpt-5.2-codex" }
  }
}

2. 設定 Fallback Models

當主 model 失敗時自動切換：

# 設定 fallback 順序
clawdbot models fallbacks add anthropic/claude-sonnet-4-5
clawdbot models fallbacks add google-gemini-cli/gemini-3-pro-preview
clawdbot models fallbacks add openai-codex/gpt-5.2-codex

# 查看 fallback 設定
clawdbot models status | grep Fallbacks

3. 定時 Token 更新

建立 cron job 自動更新 OAuth tokens：

# 編輯 crontab
crontab -e

# 每 4 小時更新 Claude token
0 */4 * * * clawdbot models auth login --provider anthropic 2>&1 | logger -t clawdbot-auth

# 每小時更新 Gemini token
0 * * * * clawdbot models auth login --provider google-gemini-cli 2>&1 | logger -t clawdbot-auth

4. 監控腳本

建立簡單的監控腳本：

#!/bin/bash
# ~/monitor-clawdbot.sh

echo "=== Clawdbot 狀態檢查 ==="
echo "時間: $(date)"
echo ""

# Gateway 狀態
echo "Gateway:"
clawdbot gateway status | grep "Runtime"

# Model 認證
echo -e "\nModel OAuth 狀態:"
clawdbot models status | grep -A 3 "OAuth/token status"

# 錯誤檢查
echo -e "\n最近錯誤:"
clawdbot logs --tail 100 | grep -i error | tail -5

echo "======================"

使用：

chmod +x ~/monitor-clawdbot.sh
~/monitor-clawdbot.sh

社群資源

官方資源

• GitHub: https://github.com/clawdbot/clawdbot
• 官網: https://clawd.bot
• 文件: https://docs.clawd.bot
• Discord: https://discord.gg/clawdbot

學習資源

• YouTube 教學影片搜尋: "Clawdbot tutorial"
• Reddit: r/clawdbot
• Twitter/X: #clawdbot

疑難排解

• GitHub Issues: 報告 bug 和功能請求
• Discord #support: 即時支援
• Stack Overflow: [clawdbot] tag

文件更新日期：2026 年 1 月 26 日 版本：2.0 - 新增 OAuth 完整指南和 CLI 指令參考