Clawdbot：打造你的 Telegram AI Assistant 完整教學

想在 Telegram 上擁有專屬的 AI 助理嗎？本文完整介紹如何使用 Clawdbot 打造 Telegram AI Assistant，從安裝設定到實際應用案例，讓你在即時通訊軟體中直接與 AI 對話，提升工作效率。

什麼是 Telegram AI Assistant？

Telegram AI Assistant 是一種透過 Telegram 介面與 AI 模型互動的聊天機器人，讓使用者可以在熟悉的通訊軟體中直接發送訊息、獲得 AI 回應，無需切換到其他應用程式或網頁。

與傳統的 ChatGPT 網頁版不同，Telegram AI Assistant 的優勢在於：

隨時可用：手機通知即時收到 AI 回覆
對話延續：上下文記憶，不用重複說明背景
多功能整合：可以結合行事曆、Email、檔案處理等功能
自訂彈性：根據需求擴充技能，打造專屬助理

Clawdbot：開源的多通道 AI 閘道器

Clawdbot 是一個開源專案，能將 Telegram、WhatsApp、Discord、iMessage 等即時通訊軟體連接至 AI 編程助理。它扮演「橋樑」的角色，讓你的訊息傳送到後端 AI 處理，再將回應傳回聊天視窗。

核心架構

你的手機 (Telegram/WhatsApp/Discord)
        │
        ▼
  ┌─────────────────┐
  │    Clawdbot     │  ← 閘道器 (Gateway)
  │    Gateway      │
  └────────┬────────┘
           │
           ▼
     AI 編程助理 (Pi)

核心概念對照表

概念	說明	實際應用
Gateway	核心服務，管理通道連線與訊息路由	執行 `clawdbot gateway` 啟動
Channel	支援的通訊平台	Telegram、WhatsApp、Discord
Session	獨立的對話上下文	每個聊天室各自記憶
Skill	AI 能力擴充模組	GitHub 操作、天氣查詢

為什麼選擇 Clawdbot？

市面上有許多 Telegram AI Chatbot 方案，以下是 Clawdbot 與其他選擇的比較：

Clawdbot vs. 第三方 SaaS 服務

比較項目	Clawdbot	Lunabot / Yatter	優勢
成本	開源免費，自託管	訂閱制月費	Clawdbot 長期成本更低
資料隱私	資料完全自控	資料經第三方伺服器	Clawdbot 更安全
自訂能力	無限擴充	功能受限於平台	Clawdbot 更靈活
多平台	原生支援 4+ 平台	通常僅 1-2 平台	Clawdbot 更全面

Clawdbot vs. n8n + AI 節點

比較項目	Clawdbot	n8n + AI	適用情境
專注領域	AI 對話體驗	通用工作流自動化	需要即時對話選 Clawdbot
設定時間	30 分鐘上手	需設計完整流程	快速部署選 Clawdbot
對話品質	串流回應、上下文管理	需自行處理	重視體驗選 Clawdbot

安裝與設定教學

環境需求

Node.js 22+
作業系統：macOS、Linux、Windows (WSL2)
Telegram Bot Token（透過 @BotFather 取得）

Step 1：安裝 Clawdbot

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

# 執行引導設定（會自動安裝為背景服務）
clawdbot onboard --install-daemon

Step 2：建立 Telegram Bot

在 Telegram 搜尋 @BotFather
發送 /newbot 建立新機器人
依指示設定名稱
取得 Bot Token（格式：123456789:ABCdefGhIJKlmnoPQRstUVwxYZ）

Step 3：設定 Clawdbot

編輯設定檔 ~/.clawdbot/clawdbot.json：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN_HERE",
      "dmPolicy": "pairing"
    }
  }
}

Step 4：啟動 Gateway

1
2
3

# 如已安裝為服務，會自動啟動
# 手動啟動方式：
clawdbot gateway

Step 5：開始對話

在 Telegram 搜尋你剛建立的 Bot，發送任何訊息即可開始與 AI 對話！

進階設定

限制使用者存取

只允許特定帳號使用：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN",
      "allowFrom": ["your_telegram_id"]
    }
  }
}

群組中使用（需 @ 提及）

{
  "messages": {
    "groupChat": {
      "mentionPatterns": ["@your_bot_name"]
    }
  }
}

同時連接多個平台

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "TELEGRAM_TOKEN"
    },
    "discord": {
      "enabled": true,
      "botToken": "DISCORD_TOKEN"
    }
  }
}

實際使用案例

案例 1：程式碼助手

情境：在手機上收到 Bug 回報，需要快速 Review 程式碼

你：幫我檢查這段 Python 程式碼有什麼問題

def calculate_average(numbers):
    total = 0
    for n in numbers:
        total += n
    return total / len(numbers)

AI：這段程式碼有一個潛在問題：當 numbers 是空列表時，
會產生 ZeroDivisionError。建議加入防護：

def calculate_average(numbers):
    if not numbers:
        return 0
    return sum(numbers) / len(numbers)

案例 2：排程提醒助理

情境：設定每日早上的行程提醒

你：幫我設定每天早上 9 點提醒我今天的行程

AI：已設定 Cron Job，每天 09:00 會自動查詢你的 
Google Calendar 並推送當日行程摘要。

案例 3：GitHub 操作

情境：在通勤時快速查看 PR 狀態

你：查看 hexo_dev repo 的 open PRs

AI：目前有 2 個 Open PRs：
1. #14 "Add: Clawdbot 介紹文章" - 等待 review
2. #12 "Fix: 修正首頁排版" - 已通過 CI

案例 4：文件摘要

情境：會議中收到長篇文件，需要快速了解重點

你：[傳送 PDF 檔案]
   幫我摘要這份文件的重點

AI：這份文件主要討論 Q1 營收報告：
1. 總營收較去年同期成長 15%
2. 新產品線貢獻 30% 營收
3. 建議重點投資 AI 相關產品

常見問題 FAQ

Q1：Clawdbot 支援哪些 AI 模型？

Clawdbot 預設使用 Pi 編程助理，支援 Claude、GPT 等主流模型。你可以透過設定檔切換不同的 AI Provider。

Q2：資料會被傳到哪裡？

自託管的 Clawdbot 將資料保留在你自己的伺服器上。對話紀錄儲存在本地，不會傳送給第三方服務（除了你選擇的 AI API Provider）。

Q3：可以在公司內部使用嗎？

可以。Clawdbot 支援企業常用的 Mattermost、Slack 等平台（透過 Plugin），並可整合企業內部的知識庫或文件系統。

Q4：需要一直開著電腦嗎？

建議將 Clawdbot 部署在 VPS 或家中的 Server（如 Synology NAS），這樣即使電腦關機也能持續運作。

Q5：免費嗎？

Clawdbot 本身完全免費開源。你只需支付 AI API 的使用費用（如 Anthropic Claude 或 OpenAI GPT 的 API 費用）。

結語

Telegram AI Assistant 讓 AI 助理真正融入日常生活，而 Clawdbot 提供了一個開源、靈活、安全的解決方案。無論你是想要一個隨身的程式碼助手、日程管理員，還是智能客服機器人，Clawdbot 都能滿足需求。

相較於第三方 SaaS 服務，自架 Clawdbot 的優勢在於完全掌控資料與無限擴充可能。當其他人還在付月費使用功能受限的服務時，你已經擁有一個完全客製化的 AI 助理。

參考連結: