如何在 VPS 上安裝 Clawdbot

Clawdbot 是一款開源、自架設的個人 AI 助理，能連接你喜愛的通訊平台。與基於雲端的 AI 助理（如 ChatGPT）不同，Clawdbot 完全運行於你的基礎設施上，讓你對資料與隱私擁有完整掌控。本文將引導你使用 Node.js 在 VPS 上安裝 Clawdbot。我們推薦使用 LightNode 作為你的 VPS 供應商。

什麼是 Clawdbot？

Clawdbot 是一個強大的個人 AI 助理，存在於你喜愛的應用程式和通訊平台中。它可連接 WhatsApp、Telegram、Discord、Slack、Signal、iMessage、Microsoft Teams、Google Chat 等多種平台，將大型語言模型轉化為真正個人化、隨時可用的夥伴。主要特色包括：

• 多平台支援：支援超過 10 種通訊平台
• 持久記憶：能記住你的偏好與過往對話
• 主動行動：可執行動作、設定提醒及發送通知
• 自架設：完整資料擁有權與隱私控制
• 可客製化：可擴充技能與工具
• 全天候運行：可在 VPS 或本機 24/7 運作

安裝前準備

開始前請確保你具備以下條件：

1. VPS 伺服器：可選擇多種雲端服務供應商。我們推薦 LightNode，因其優異效能與全球佈局。
2. 基本指令列知識：熟悉終端機指令會更方便操作。
3. 已安裝 Node.js：確保伺服器上安裝 Node.js 22 版或以上。
4. 最低系統需求：2GB RAM、1 vCPU、10GB 硬碟空間（生產環境建議 4GB RAM）。

為什麼推薦 LightNode VPS

LightNode 是托管 Clawdbot 的絕佳選擇，原因如下：

LightNode 主要優勢

• 價格實惠：方案起價為 每月 7.71 美元，採用按小時計費，方便測試無需長期綁約。
• 全球 40+ 地點：資料中心遍布六大洲，包括美國、歐洲、亞洲、中東與非洲，確保全球用戶低延遲。
• 高效能：NVMe SSD 儲存與高頻 CPU，提供 AI 工作負載優異效能。
• 99.95% 正常運作時間保證：可靠基礎設施與本地 BGP 連線，確保助理隨時可用。
• 彈性計費：按使用量付費，適合測試與擴展。
• 開發者友好：完整 root 權限、即時部署，支援 Linux 與 Windows。
• 免費快照：每台 VPS 提供一次免費快照，方便備份與還原。
• 新用戶優惠：首次儲值可獲得最高 15 美元免費額度。

推薦的 LightNode Clawdbot 配置

此配置能提供 Clawdbot 運作所需的充足資源，並隨使用量成長留有擴充空間。

開始使用 LightNode

第一步：設定你的 VPS

1. 啟動實例：登入 LightNode 並建立新的 VPS 實例。建議選擇接近主要用戶的地點以獲得最佳延遲。亞洲用戶可選新加坡或香港，北美用戶則推薦矽谷。
2. 選擇作業系統：選擇 Ubuntu 22.04 LTS（推薦）或 Ubuntu 24.04，這些版本對 Node.js 支援良好且經過廣泛測試。
3. SSH 連線：使用 SSH 用戶端連接伺服器：

   ssh username@your_server_ip
   

第二步：安裝 Node.js

Clawdbot 需要 Node.js 22 版或以上。以下是在 Ubuntu 上安裝的方法：

# 更新套件清單
sudo apt update

# 從 NodeSource 倉庫安裝 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 驗證安裝
node --version
# 應顯示：v22.x.x

你也可以使用 NVM（Node 版本管理器）以獲得更彈性的版本管理：

# 安裝 NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

# 安裝 Node.js 22
nvm install 22
nvm use 22

# 驗證安裝
node --version

第三步：安裝 Clawdbot

有多種安裝方式，請選擇最適合你的。

方法一：官方安裝腳本（初學者推薦）

安裝腳本最簡單，會自動處理相依性：

# 下載並執行安裝腳本
curl -fsSL https://clawd.bot/install.sh | bash

此指令會：

• 偵測你的作業系統
• 確保安裝 Node.js 22+
• 透過 npm 全域安裝 Clawdbot
• 設定必要路徑
• 執行 doctor 指令檢查安裝狀況

方法二：npm 全域安裝

適合熟悉 npm 的使用者：

# 全域安裝 Clawdbot
npm install -g clawdbot@latest

# 或使用 pnpm（較快）
pnpm add -g clawdbot@latest

# 驗證安裝
clawdbot --version

方法三：從原始碼安裝（開發者用）

# 克隆原始碼庫
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# 安裝相依套件
pnpm install

# 建置 UI
pnpm ui:build

# 建置專案
pnpm build

# 執行入門嚮導
./dist/entry.js onboard --install-daemon

方法四：Docker 安裝（選用）

容器化部署：

# 克隆原始碼庫
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# 執行 Docker 設定腳本
./docker-setup.sh

第四步：執行入門嚮導

安裝完成後，執行入門嚮導設定 Clawdbot：

# 啟動互動式入門嚮導
clawdbot onboard --install-daemon

嚮導會引導你完成：

1. Gateway 設定：選擇本地或遠端 Gateway 模式，並設定 Gateway 連接埠（預設：18789）。
2. 認證設定：配置 AI 模型提供者。
   • Anthropic (Claude)：API 金鑰或 OAuth（推薦）
   • OpenAI (ChatGPT/Codex)：API 金鑰
   • 其他提供者：自訂端點與 API 金鑰
3. 頻道設定：設定通訊平台：
   • WhatsApp：QR Code 登入
   • Telegram：從 @BotFather 取得 Bot Token
   • Discord：從 Discord 開發者平台取得 Bot Token
   • Slack：OAuth 或 Bot Token
4. 服務安裝：將 Gateway 安裝為背景服務（Linux 使用 systemd）。
5. 代理身份：設定助理個性與預設行為。

第五步：啟動 Gateway

完成入門嚮導後，Gateway 應自動啟動。你可以用以下指令檢查狀態：

# 檢查 Gateway 狀態
clawdbot gateway status

# 查看日誌
clawdbot logs --follow

# 檢查健康狀態
clawdbot health

手動啟動（若服務未運行）

# 前景模式啟動 Gateway
clawdbot gateway --port 18789 --verbose

服務管理

# 啟動服務
systemctl --user start clawdbot-gateway.service

# 停止服務
systemctl --user stop clawdbot-gateway.service

# 重啟服務
systemctl --user restart clawdbot-gateway.service

# 設定開機自動啟動
systemctl --user enable clawdbot-gateway.service

# 查看服務日誌
journalctl --user -u clawdbot-gateway -f

第六步：存取控制面板

Clawdbot 控制介面可透過瀏覽器存取：

http://your_server_ip:18789/

若入門嚮導中設定了認證，需輸入 Gateway Token 才能登入。

透過 SSH 隧道遠端存取

為安全遠端存取：

# 從本機建立 SSH 隧道
ssh -N -L 18789:127.0.0.1:18789 username@your_server_ip

# 然後本機瀏覽器開啟
http://localhost:18789/

第七步：連接第一個頻道

WhatsApp

連接 WhatsApp：

# 產生並顯示 QR Code
clawdbot channels login

# 使用 WhatsApp 掃描：
# 設定 → 已連結裝置 → 連結裝置

掃描後，WhatsApp 即會連接至 Clawdbot。

Telegram

1. 在 Telegram 上與 @BotFather 聊天建立機器人
2. 按指示建立新機器人
3. 複製提供的 Bot Token
4. 加入 Clawdbot：

clawdbot channels add --channel telegram --token "your_bot_token_here"

Discord

1. 前往 Discord 開發者平台
2. 建立新應用程式
3. 在「Bot」頁籤啟用機器人
4. 複製 Bot Token
5. 邀請機器人加入你的 Discord 伺服器並授予適當權限
6. 加入 Clawdbot：

clawdbot channels add --channel discord --token "your_discord_bot_token"

第八步：設定私訊安全性

預設 Clawdbot 對私訊採用 配對模式，即未知發送者會收到配對碼，訊息在獲批准前不會被處理。

# 列出待配對請求
clawdbot pairing list whatsapp

# 批准配對請求
clawdbot pairing approve whatsapp <pairing_code>

# 查看已批准配對
clawdbot pairing list whatsapp --approved

你也可以在設定檔 ~/.clawdbot/clawdbot.json 中修改此行為。

第九步：測試你的設定

發送測試訊息確認一切正常：

# 發送測試訊息
clawdbot message send --to +15555550123 --message "Hello from Clawdbot!"

# 或透過 Telegram 測試
clawdbot message send --to @your_telegram_username --message "Hello!"

你也可以直接向已連接的 WhatsApp/Telegram/Discord 發訊息，Clawdbot 助理應會回覆。

第十步：設定 Nginx（選用）

生產環境建議使用 Nginx 反向代理以提升安全性並管理 SSL 憑證。

安裝 Nginx

sudo apt install -y nginx

設定 Nginx

編輯 Nginx 設定檔：

sudo nano /etc/nginx/sites-available/clawdbot

加入以下設定：

server {
    listen 80;
    server_name your-domain.com;  # 請替換為你的網域

    location / {
        proxy_pass http://localhost:18789;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

啟用設定

# 建立符號連結
sudo ln -s /etc/nginx/sites-available/clawdbot /etc/nginx/sites-enabled/

# 測試 Nginx 設定
sudo nginx -t

# 重新啟動 Nginx
sudo systemctl restart nginx

使用 Certbot 加入 SSL（推薦）

# 安裝 Certbot
sudo apt install -y certbot python3-certbot-nginx

# 取得 SSL 憑證
sudo certbot --nginx -d your-domain.com

# Certbot 會自動設定 Nginx SSL

完成後，你的 Clawdbot 將可透過以下網址存取：

https://your-domain.com/

常見問題排解

Gateway 無法啟動

若 Gateway 啟動失敗：

# 檢查設定錯誤
clawdbot doctor

# 查看詳細日誌
journalctl --user -u clawdbot-gateway -n 50

記憶體不足錯誤

2GB RAM VPS 在更新時可能遇到記憶體不足，請新增交換檔案：

# 建立 2GB 交換檔案
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# 設定開機自動啟用交換檔
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

埠口已被佔用

若 18789 埠口已被使用：

# 查詢佔用該埠口的程序
sudo lsof -i :18789

# 或使用不同埠口啟動
clawdbot gateway --port 18889

機器人無回應

若機器人不回應：

1. 檢查 Gateway 狀態：clawdbot gateway status
2. 確認頻道設定：確保 Token 正確且頻道已啟用
3. 檢查認證：確認 API 金鑰有效
4. 查看日誌：clawdbot logs --follow 尋找錯誤訊息

更新 Clawdbot

更新至最新版本：

# 重新執行安裝腳本
curl -fsSL https://clawd.bot/install.sh | bash

# 或透過 npm 更新
npm update -g clawdbot@latest

# 重啟 Gateway
clawdbot gateway restart

# 檢查健康狀態
clawdbot health

結語

在 VPS 上安裝 Clawdbot 是一個簡單的流程，能讓你擁有一個強大、自架設的 AI 助理，並可跨多種通訊平台使用。搭配 LightNode 價格實惠、全球佈局與高效能基礎設施，你可以放心部署個人 AI 助理。

依照本指南操作，約 20-30 分鐘即可讓 Clawdbot 在 VPS 上運行，提供你一個隨時可用、尊重隱私且完全掌控資料的 AI 夥伴。

欲進一步自訂與使用進階功能，請參考官方文件及 Clawdbot GitHub 頁面，並參與社群討論以獲得更多技巧與建議。

其他資源

• Clawdbot 官方文件
• Clawdbot GitHub 倉庫
• LightNode VPS - 推薦的 VPS 供應商
• Clawdbot 社群 Discord
• 技能市集 - 擴充你的助理技能