[Tool Note] — 架設 OpenClaw(ClawBot) & 使用 Google Antigravity 搭配免費模型

Introduction & 前言

⚠️⚠️⚠️ 注意請先看這段：這邊 2026/02/02 02:52 更新說明，ClawBot -> MoltBot -> OpenClaw 都是同一的東西，期間有改名過兩次，買名詳細原因可以查查看 又改名了！Moltbot(前Clawdbot) 更名「OpenClaw」並帶來四大更新，尤其加強安全性，以下文章有提到這三個名稱的都是指向同一個工具，如有不便敬請見諒 ⚠️⚠️⚠️

提醒：這邊文章是透過 TG 下指令給 Clawdbot 自動產出整篇文章的，如果內容有誤麻煩留言，筆者會盡快修改，感謝包容

之前有玩過 n8n 這套自動化工具，覺得能夠串接各種服務來打造自己的工作流程真的很方便。最近在社群上看到 Clawdbot 這個專案蠻紅的，它是一個基於 Claude 的 AI 助手框架，可以讓你透過 Telegram、Discord、WhatsApp 等通訊軟體直接呼叫 AI 助手來執行各種任務。

如果對 n8n 有興趣也可以參考筆者的另一篇文章 [Tool Note]  — 架設 n8n & 簡易使用指南

趁著週末有空，我就把它安裝到本機玩了一下，發現整個設定過程比想像中簡單，而且功能真的很強大！可以直接讓 AI 幫你操作電腦、瀏覽網頁、查資料，甚至幫你寫程式。

這篇文章會記錄一下我的安裝過程和一些基本使用方式，如果你也對這個工具有興趣，可以參考看看。

---

Summary & 摘要

本文會介紹 Clawdbot 是什麼、怎麼安裝，以及如何串接 Telegram 來使用。

本篇文章將有以下幾個部分：

1. 什麼是 Clawdbot
2. 事前準備
3. 安裝步驟
4. 串接 Telegram
5. 基本使用
6. 進階功能
7. 常見問題
8. Clawdbot 設定 Google Gemini API Key 的疑難排解
9. 補充：在 AWS EC2 VPS 上安裝 Clawdbot

---

什麼是 Clawdbot

Clawdbot 是一個開源的 AI 助手框架，它的核心是 Anthropic 的 Claude 模型。簡單來說，它讓你可以：

• 🤖 透過各種通訊軟體（Telegram、Discord、WhatsApp 等）與 AI 對話
• 💻 讓 AI 助手直接操作你的電腦（執行指令、讀寫檔案）
• 🌐 自動化瀏覽器操作
• 📅 設定定時任務和提醒
• 🔧 安裝各種 Skills 來擴充功能

它的設計理念是讓 AI 助手真正成為你的「數位助理」，而不只是一個聊天機器人。

官方資源：

• 官方文件：https://docs.clawd.bot
• GitHub：https://github.com/clawdbot/clawdbot
• Discord 社群：https://discord.com/invite/clawd

---

事前準備

在開始安裝之前，請確保你的環境符合以下條件：

系統需求

• Node.js 18 以上版本
• macOS / Linux / Windows（推薦 macOS 或 Linux）

需要的帳號

1. Google 帳號（推薦使用 Google Antigravity 免費額度）

   • 只需要一個 Google 帳號即可透過 OAuth 認證使用 Claude 模型
   • 這是本文推薦的方式，可以使用 免費額度

2. Claude Code 訂閱（或 Anthropic API Key）— 可選

   • 如果你有 Claude Pro/Max 訂閱，可以使用 claude setup-token 產生的 token
   • 或者到 console.anthropic.com 申請 API Key

3. Telegram Bot Token（如果要串接 Telegram）

   • 透過 @BotFather 建立一個 Bot

---

安裝步驟

Step 1：安裝 Clawdbot

使用 npm 或 pnpm 全域安裝：

# 使用 npm
npm install -g clawdbot

# 或使用 pnpm（推薦）
pnpm add -g clawdbot

Step 2：執行初始化設定

clawdbot onboard

執行後會看到以下畫面：

安裝過程中會有一些設定需要選擇，例如選擇 Model/Auth Provider 等：

這個指令會引導你完成基本設定，包括：

• 選擇運行模式（本機 / 雲端）
• 設定 API 認證
• 建立工作目錄

Step 3：設定 Model Provider（推薦 Google Antigravity）

在設定過程中，當你看到選擇 Model/Auth Provider 的畫面時，強烈推薦選擇 Google Antigravity OAuth：

設定流程：

1. 選擇 Model/auth provider → Google
2. 選擇 Google auth method → Google Antigravity OAuth
3. 系統會開啟瀏覽器讓你登入 Google 帳號進行 OAuth 認證
4. 認證完成後，選擇你想使用的模型（例如 claude-opus-4-5-thinking）

為什麼推薦 Google Antigravity？

Provider	說明	用途
google	Google AI Studio (Gemini API)	使用 Gemini 模型
google-antigravity	Google Vertex AI (透過 OAuth)	使用 Claude on Vertex

🎉 重點： google-antigravity 是透過 Google Vertex AI 提供的 Claude 模型存取方式，目前有 免費額度 可以使用！不需要 Claude Code 訂閱，也不需要 Anthropic API Key，只要有 Google 帳號就能開始使用。

Step 4：設定 Claude API Token（如果沒選 Google Antigravity）

如果你選擇使用 Claude Code 訂閱，可以使用以下指令設定：

claude setup-token

這會產生一個 token 並自動設定好。

小提醒：透過 claude setup-token 產生的 token 是走你的 Claude 訂閱額度，不是 API 按量計費，所以不用擔心會產生額外費用！

Step 5：啟動 Gateway

clawdbot gateway start

看到類似以下輸出就代表啟動成功：

Gateway started on http://127.0.0.1:18789

你可以手動打開瀏覽器訪問 http://127.0.0.1:18789/chat 來使用 Web 介面。第一次進入時，Clawdbot 會問你一些自我介紹的設定，幫助它了解你和建立個人化的 AI 助手：

---

串接 Telegram

Step 1：建立 Telegram Bot

1. 打開 Telegram，搜尋 @BotFather
2. 發送 /newbot 指令
3. 依照提示設定 Bot 名稱和 username
4. 取得 Bot Token（格式像是 123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

Step 2：設定 Clawdbot

執行以下指令來設定 Telegram：

clawdbot configure

或者直接編輯設定檔 ~/.clawdbot/clawdbot.json，加入：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的_BOT_TOKEN"
    }
  }
}

Step 3：重啟 Gateway

clawdbot gateway restart

Step 4：配對你的 Telegram 帳號

在 Telegram 找到你的 Bot，發送任意訊息，你會收到類似這樣的回覆：

Clawdbot: access not configured.
Your Telegram user id: 1234567890
Pairing code: XXXXXXXX
Ask the bot owner to approve with: clawdbot pairing approve telegram <code>

這時候你有兩種方式可以進行配對：

方式一：透過終端機指令

clawdbot pairing approve telegram XXXXXXXX

方式二：透過 Web UI

回到 http://127.0.0.1:18789，在 Dashboard 上會顯示待批准的配對請求，直接點擊 Approve 即可。

方式三：直接傳訊息給 Clawdbot

如果你已經在其他地方（如 Web UI）配對成功，可以直接請 Clawdbot 幫你執行配對指令。

看到 Approved telegram sender 1234567890. 就代表配對成功了！

---

基本使用

配對完成後，你就可以直接在 Telegram 跟你的 AI 助手對話了。

常用功能範例

查詢資料：

今天台股的整體走勢如何？

操作檔案：

幫我在桌面建立一個叫做 test.txt 的檔案，內容寫 Hello World

執行指令：

列出目前目錄下的所有檔案

設定提醒：

30 分鐘後提醒我喝水

---

進階功能

查看可用模型

clawdbot models list

切換模型

預設使用 claude-opus-4-5，如果想省錢可以換成較便宜的模型：

# 在設定檔中修改，或透過 configure 指令
clawdbot configure

可選模型包括：

• anthropic/claude-opus-4-5 — 最強，但最貴
• anthropic/claude-sonnet-4-5 — 平衡性價比
• anthropic/claude-haiku-4-5 — 最快最便宜

安裝 Skills

Clawdbot 支援安裝各種 Skills 來擴充功能：

# 查看可用 Skills
clawdbot skills list

# 安裝 Skill
clawdbot skills install <skill-name>

可以到 ClawdHub 找更多社群開發的 Skills。

瀏覽器自動化

Clawdbot 可以控制瀏覽器來幫你做一些自動化操作：

幫我打開 Google 搜尋「今天天氣」

---

常見問題

Q：費用怎麼算？

如果你是用 claude setup-token 設定的 token，費用會走你的 Claude Pro/Max 訂閱額度，不會額外收費。

如果你是用 Anthropic API Key（sk-ant- 開頭），則會按照 API 使用量計費。

Q：可以同時在多個平台使用嗎？

可以！你可以同時串接 Telegram、Discord、WhatsApp 等多個平台，共用同一個 AI 助手。

Q：怎麼查看使用狀態？

clawdbot status

這會顯示目前的運行狀態、連接的頻道、Session 數量等資訊。

Q：怎麼讓它在背景運行？

可以使用 LaunchAgent（macOS）或 systemd（Linux）來設定開機自動啟動：

# macOS - 安裝 LaunchAgent
clawdbot gateway install

# 啟動服務
clawdbot gateway start

---

Clawdbot 設定 Google Gemini API Key 的疑難排解

Google Provider 差異說明

在設定 Clawdbot 時，你可能會看到兩種 Google 相關的 Provider，它們是不同的服務：

Provider	說明	用途
google	Google AI Studio (Gemini API)	使用 Gemini 模型
google-antigravity	Google Vertex AI (透過 OAuth)	使用 Claude on Vertex

💡 小提醒： google-antigravity 是透過 Google Vertex AI 提供的 Claude 模型存取方式，與 Anthropic 直接提供的 Claude Code 是分開計費的。如果你想使用免費額度，可以選擇 google-antigravity 搭配 OAuth 認證。

API Key 設定問題

如果你在 Clawdbot 的設定流程中，選擇 Model > Google > Google Gemini API key 並貼入 API Key 後，選擇了 google/gemini-2.5-flash 或 google/gemini-2.5-pro 等模型，然後重啟 clawdbot gateway restart，但發現 Clawdbot 仍然沒有反應，甚至收到類似 No available auth profile for google (all in cooldown or unavailable). (rate_limit) 的錯誤訊息，這表示你的 API Key 可能沒有被正確儲存。

這種情況通常發生在 Clawdbot 的設定精靈未能將 API Key 正確地持久化到底層的憑證儲存系統中。為了解決這個問題，你需要使用一個更直接的指令來確保 API Key 被正確註冊：

1. 重新貼上 API Key：
   在 Terminal 中執行以下指令，然後貼上你的 Google AI Studio API Key（以 AIza 開頭的那串）：

   clawdbot models auth paste-token --provider google

2. 重啟 Clawdbot Gateway：
   完成 API Key 的貼上後，務必重啟 Clawdbot Gateway 讓設定生效：

   clawdbot gateway restart

完成這些步驟後，你的 Clawdbot 就能正確地使用 Google Gemini 模型了。

💡 小補充：快速切換語言模型

如果你想快速切換 Clawdbot 使用的語言模型，可以使用以下指令：

clawdbot models set <provider>/<model-name>

例如，要將主要模型設定為 google/gemini-2.5-flash：

clawdbot models set google/gemini-2.5-flash

每次切換模型後，同樣需要重啟 Gateway：

clawdbot gateway restart

---

補充：在 AWS EC2 VPS 上安裝 Clawdbot

如果你不想在本機上跑 Clawdbot，或是想讓它 24/7 全天候運行，可以將它部署到 VPS 上。這邊以 AWS EC2 為例，分享完整的安裝步驟。

為什麼選 t3.small 而不是 t3.micro？

很多人（包括筆者）一開始會選最便宜的 t3.micro（1GB RAM），但實測發現 Clawdbot 在 1GB RAM 的環境下會因為記憶體不足（OOM）而無法啟動。即使加了 1GB 的 Swap，連 openclaw doctor 和 openclaw onboard 都會直接炸掉：

FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory

所以 請直接選 t3.small（2GB RAM），省去很多麻煩。AWS 新帳號通常有免費抵用金可以使用，足夠覆蓋 t3.small 的費用。

Step 1：建立 EC2 Instance

1. 前往 AWS Console → EC2 → Launch Instance
2. AMI 選擇：Ubuntu Server 22.04 LTS
3. Instance Type：t3.small（2 vCPU / 2GB RAM）
4. Key Pair：建立新的 → 下載 .pem 檔案
5. Network Settings：啟用 Auto-assign Public IP
6. Security Group：新建，允許 SSH (port 22)，來源設為 My IP
7. Launch → 記下 Public IPv4

Step 2：本地連線到 EC2

chmod 400 your-key.pem
ssh -i your-key.pem ubuntu@<your-public-ip>

Step 3：VPS 基礎設定

# 系統更新
sudo apt update && sudo apt upgrade -y

# 安裝基礎套件
sudo apt install -y git curl build-essential jq ca-certificates openssl ufw htop

# 啟用防火牆
sudo ufw allow OpenSSH && sudo ufw --force enable

Step 4：建立 Clawdbot 專用用戶（資安隔離）

為了安全起見，建議不要直接在 ubuntu 用戶下跑 Clawdbot，而是建立一個專用用戶：

sudo adduser openclaw
sudo usermod -aG sudo openclaw

Step 5：設定 SSH 金鑰登入（本地操作）

在你的本機產生專用金鑰：

ssh-keygen -t ed25519 -C "openclaw@ec2" -f ~/.ssh/openclaw_id_ed25519
cat ~/.ssh/openclaw_id_ed25519.pub  # 複製這行公鑰

回到 VPS，把公鑰加到 openclaw 用戶：

sudo mkdir -p /home/openclaw/.ssh
sudo nano /home/openclaw/.ssh/authorized_keys  # 貼上公鑰
sudo chmod 700 /home/openclaw/.ssh
sudo chmod 600 /home/openclaw/.ssh/authorized_keys
sudo chown -R openclaw:openclaw /home/openclaw/.ssh /home/openclaw
sudo chmod 755 /home/openclaw

本地測試連線：

ssh -i ~/.ssh/openclaw_id_ed25519 openclaw@<your-public-ip>

Step 6：SSH 資安強化

sudo nano /etc/ssh/sshd_config

修改以下設定：

PermitRootLogin no
PasswordAuthentication no
PubkeyAuthentication yes

重啟 SSH：

sudo systemctl restart ssh

Step 7：加入 Swap（強烈建議）

即使是 t3.small，加入 Swap 也能讓系統更穩定：

sudo fallocate -l 1G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Step 8：設定 Node.js 與 npm（openclaw 用戶）

切換到 openclaw 用戶：

su - openclaw

安裝 Node.js 22：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

設定 openclaw 專用的 npm 路徑（避免需要 sudo）：

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

確認設定正確：

npm config get prefix
# 應該顯示：/home/openclaw/.npm-global

Step 9：安裝 Clawdbot

npm install -g openclaw@latest
which openclaw
# 應該顯示：/home/openclaw/.npm-global/bin/openclaw

Step 10：執行初始設定

openclaw onboard --install-daemon

設定過程中會需要：

• 選擇模型 Provider（Anthropic / Google 等）
• 貼上 API Key
• 設定 Telegram Bot Token（從 BotFather 取得）

Step 11：驗證與啟動

openclaw doctor   # 驗證環境
openclaw status   # 查看運行狀態

⚠️ 注意： 如果你的 Telegram 已經有一個 Clawdbot Bot 在用，VPS 上需要建立另一個新的 Bot。同一個 Bot Token 不能同時被兩個 Clawdbot 實例使用，否則會搶訊息。

Step 12：Telegram Bot 配對

配對流程與前面 串接 Telegram - Step 4 相同。在 Telegram 對新 Bot 發送任意訊息後，你會收到 pairing code。

由於 VPS 上的 Gateway 綁定在 127.0.0.1，外部無法訪問 Web UI，所以需要 SSH 連進 VPS 後用 CLI 指令 完成配對：

openclaw pairing approve telegram <pairing-code>

💡 小補充： 如果之後設定了 Nginx 反代，就可以在 Web UI 的 Dashboard 上直接點 Approve，不用每次都 SSH 進去。

🚨 資安警告： 千萬不要為了方便，直接把 Gateway 的 port 18789 對外開放讓瀏覽器透過 http://你的IP:18789 存取！這樣做等於把你的 AI 助手完全暴露在公網上，任何人都能存取你的 Control UI，進而控制你的機器人、讀取你的檔案，甚至執行任意指令。如果需要從外部存取 Web UI，請務必先配置好 Nginx 反向代理 + SSL + 認證機制。 目前社群上已經有不少因為沒配置好反代就對外開放，導致機器人被控制或伺服器被入侵的案例。建議可以參考這部影片了解更多：別再亂裝 ClawdBot 了｜我實測後最安全的安裝與使用方式

常見問題：systemd user session 無法啟動

在 AWS EC2 上使用 openclaw gateway start 時，你可能會遇到以下錯誤：

Gateway service check failed: Error: systemctl --user unavailable: 
Failed to connect to bus: No medium found

這是因為 SSH 連線時 systemd user session 預設沒有啟動 D-Bus session bus。解決方式：

# 1. 啟用 lingering，讓 user service 在登出後也能持續運行
sudo loginctl enable-linger $(whoami)

# 2. 設定 XDG_RUNTIME_DIR 環境變數
export XDG_RUNTIME_DIR="/run/user/$(id -u)"

# 3. 建議加到 .bashrc 中，避免每次 SSH 都要手動設定
echo 'export XDG_RUNTIME_DIR="/run/user/$(id -u)"' >> ~/.bashrc

# 4. 安裝 daemon service
openclaw gateway install

# 5. 啟動 Gateway
openclaw gateway start

💡 小補充： loginctl enable-linger 是讓 systemd 在用戶登出後仍保持其 user service 運行的關鍵設定。沒有這個設定，當你關閉 SSH 連線後，Gateway daemon 就會被自動終止。

💡 VPS 管理小提醒

• 用 htop 監控記憶體和 CPU 使用量
• 用 journalctl --user -u openclaw-gateway 查看 Gateway 日誌
• 不使用時可以 Stop Instance 節省費用（Stop 狀態只收極少的 EBS 儲存費）
• Stop 再 Start 後 Public IP 可能會改變，記得從 Console 確認新 IP

---

Conclusion & 結論

整體來說，Clawdbot 是一個非常強大的 AI 助手框架。安裝過程比想像中簡單，串接 Telegram 後就可以隨時隨地呼叫 AI 助手來幫忙處理各種任務。

目前我主要用它來：

• 快速查詢資訊（股票、天氣等）
• 幫忙寫一些簡單的程式碼
• 設定提醒事項
• 操作電腦上的檔案

如果你也對 AI 助手有興趣，蠻推薦可以試試看 Clawdbot，它的開源特性讓你可以完全掌控自己的資料，不用擔心隱私問題。

之後如果有更多使用心得，再來分享給大家！

---

參考資源

• Clawdbot 官方文件
• Clawdbot GitHub
• ClawdHub - Skills 市集
• Anthropic Console
• Telegram BotFather