5 分鐘掌握 Clawdbot：打造專屬 AI 助手的完整新手指南

想要一個能在所有聊天軟件中使用的私人 AI 助手，還能記住你說過的話、主動給你發消息提醒嗎？ Clawdbot 正是這樣一個革命性的開源項目，它讓 Claude AI 真正成爲你的專屬助手。

核心價值: 讀完本文，你將掌握 Clawdbot 的核心概念、安裝配置方法，以及如何通過 API 接入讓它在 Discord、Telegram、WhatsApp 等 8+ 平臺上爲你服務。

Clawdbot 是什麼？一句話解讀

Clawdbot 是由 Peter Steinberger （PSPDFKit 創始人）開發的開源個人 AI 助手項目。與傳統網頁版 ChatGPT 或 Claude 不同，Clawdbot 直接運行在你常用的聊天軟件裏——你在 WhatsApp 發消息，它在 WhatsApp 回覆；你在 Discord 提問，它在 Discord 解答。

特性	Clawdbot	傳統 AI 聊天
使用方式	在常用聊天軟件內使用	需要打開專門網頁
對話記憶	跨平臺持久記憶	每次對話獨立
主動推送	支持定時提醒和主動通知	只能被動響應
數據存儲	本地 Markdown 文件	存儲在雲端
定製能力	完全可編程 Skills 系統	有限的自定義選項

🎯 關鍵理解: Clawdbot 不是一個 AI 模型，而是一個「AI 網關」——它負責連接你的聊天軟件和 AI 大模型 API，讓 AI 能力無縫融入日常溝通工具。

Clawdbot 核心架構:3 層設計

理解 Clawdbot 的架構有助於後續配置和排錯。它採用清晰的三層設計:

第一層: Gateway 網關

Gateway 是 Clawdbot 的核心控制平面，默認監聽 localhost:18789:

管理所有消息會話
路由不同渠道的消息
處理工具調用和 Skills 執行
維護對話歷史和記憶系統

第二層: Channels 渠道

Channels 負責連接各種聊天平臺:

渠道類型	支持平臺	連接方式
即時通訊	WhatsApp， Telegram， Signal	Bot API / Web 協議
協作平臺	Discord， Slack， Teams	Bot API
蘋果生態	iMessage， macOS	imsg CLI / 原生集成
開放協議	Matrix， WebChat	標準協議對接
區域應用	Zalo， BlueBubbles	社區插件

第三層: LLM 大模型

Clawdbot 支持多種 AI 模型後端:

模型提供商	認證方式	適用場景
Anthropic Claude	API Key / OAuth	推薦首選，Clawdbot 原生優化
OpenAI GPT	API Key / OAuth	通用場景
第三方 API 代理	API Key	成本優化、訪問便利

🎯 技術建議: 對於 Claude 模型的調用，我們建議通過 API易 apiyi.com 平臺獲取 API Key。該平臺支持 Claude 4 全系列模型，提供統一的 OpenAI 兼容接口，價格更優惠且無需海外支付。

Clawdbot 4 大核心優勢詳解

優勢一: 全渠道無縫接入

Clawdbot 的「全渠道」理念意味着:

同一個助手，多個入口: 你在手機上用 WhatsApp 問的問題，在電腦上用 Discord 繼續追問
上下文自動同步: 無論從哪個渠道對話，助手都記得之前的交流內容
消息智能路由: 可配置特定類型消息走特定渠道

優勢二: 持久記憶系統

傳統 AI 聊天每次對話都是「失憶」狀態，而 Clawdbot:

將記憶存儲爲 Markdown 文件，類似 Obsidian 筆記
支持語義檢索，能關聯你之前提過的信息
完全本地存儲，數據不上傳雲端

~/clawd/
├── memories/           # 對話記憶
│   ├── 2026-01-26.md  # 按日期組織
│   └── topics/        # 按主題分類
├── skills/            # 自定義技能
└── config.yaml        # 配置文件

優勢三: 主動推送能力

這是 Clawdbot 區別於其他 AI 助手的殺手級功能:

主動推送場景	示例
晨間簡報	每天早 8 點推送日程和天氣
任務提醒	在你提過的截止日期前提醒
監控告警	監控的網站異常時主動通知
定時執行	定期運行腳本並彙報結果

優勢四: Skills 技能系統

Skills 是 Clawdbot 的「外掛」系統，通過 Markdown 或 TypeScript 文件定義:

# skill: web-search
使用 Brave Search API 搜索網絡內容


## 觸發條件
當用戶詢問需要實時信息的問題時


## 執行步驟
1. 調用 Brave Search API
2. 解析搜索結果
3. 生成摘要回復

社區已貢獻 100+ 現成 Skills，涵蓋:

網頁瀏覽和截圖
文件讀寫操作
日程管理集成
代碼執行環境
智能家居控制

Clawdbot 安裝配置:3 步快速上手

環境要求

項目	要求
Node.js	≥ 22.x
操作系統	macOS / Linux / Windows （WSL2）
內存	≥ 2GB 可用
AI API	Claude 或 OpenAI API Key

第一步: 全局安裝

# 使用 npm 安裝 （推薦）
npm install -g clawdbot@latest

# 或使用 pnpm
pnpm add -g clawdbot@latest

第二步: 運行配置嚮導

# 啓動交互式配置嚮導
clawdbot onboard --install-daemon

嚮導會引導你完成:

AI 模型配置 – 輸入 Claude 或 OpenAI API Key
工作目錄設置 – 默認 ~/clawd
渠道啓用 – 選擇要連接的聊天平臺
守護進程安裝 – 讓 Gateway 後臺持續運行

🚀 快速開始: 如果你還沒有 Claude API Key，推薦使用 API易 apiyi.com 平臺快速獲取。該平臺提供開箱即用的 API 接口，註冊即送免費測試額度，5 分鐘即可完成配置。

第三步: 驗證安裝

# 檢查服務狀態
clawdbot status

# 深度健康檢查
clawdbot health

# 診斷配置問題
clawdbot doctor

預期輸出:

Gateway: ✓ Running on localhost:18789
Channels: ✓ Discord， Telegram connected
LLM: ✓ Claude API configured
Memory: ✓ 42 memories indexed

Clawdbot Discord 集成配置指南

Discord 是 Clawdbot 最常用的渠道之一，配置步驟如下:

步驟 1: 創建 Discord Bot

訪問 Discord Developer Portal: discord.com/developers/applications
點擊「New Application」創建應用
進入「Bot」頁面，點擊「Add Bot」
記錄 Bot Token （點擊 Reset Token 生成）

步驟 2: 配置 Bot 權限

在「OAuth2 → URL Generator」中勾選:

權限類別	具體權限
Scopes	bot， applications.commands
Bot Permissions	Send Messages， Read Message History， Embed Links

步驟 3: 邀請 Bot 到服務器

使用生成的 OAuth2 URL 邀請 Bot 到你的 Discord 服務器。

步驟 4: 配置 Clawdbot

# 交互式配置 Discord 渠道
clawdbot configure --section channels.discord

輸入 Bot Token 後，Clawdbot 會自動完成連接。

步驟 5: 測試對話

在 Discord 服務器中 @你的 Bot 或私信它:

@ClawdBot 你好，介紹一下你自己

Bot 會使用 Claude API 生成回覆併發送到 Discord。

Clawdbot API 配置詳解

Clawdbot 的智能來自底層的 AI 大模型，正確配置 API 至關重要。

官方 Anthropic API

# ~/clawd/config.yaml
llm:
  provider: anthropic
  model: claude-sonnet-4-20250514
  apiKey: sk-ant-xxxxx

優點:

直連官方，延遲最低
支持最新模型

侷限:

需要海外信用卡支付
部分地區訪問受限

第三方 API 代理（推薦）

# ~/clawd/config.yaml
llm:
  provider: openai-compatible
  model: claude-sonnet-4-20250514
  apiKey: sk-xxxxx
  baseUrl: https://api.apiyi.com/v1  # 使用 API易 統一接口

💰 成本優化: 對於國內用戶，使用 API易 apiyi.com 作爲 API 代理是更優選擇。該平臺提供 OpenAI 兼容格式接口，支持 Claude 全系列模型，價格比官方更優惠，且支持支付寶/微信付款，無需海外支付渠道。

OAuth 訂閱認證

如果你已有 Claude Pro/Max 訂閱:

clawdbot configure --section llm.oauth

優點是使用現有訂閱額度，無需額外 API 費用。

Clawdbot 常用 Skills 配置

網頁搜索 Skill

# 配置 Brave Search API
clawdbot configure --section web

# 輸入你的 Brave Search API Key

配置後 Clawdbot 可以搜索實時網絡信息回答問題。

文件操作 Skill

Clawdbot 內置文件讀寫能力:

我: 幫我讀取 ~/Documents/notes.md 的內容
Bot: 正在讀取文件... [文件內容]

我: 在文件末尾添加一行 "今日待辦: 完成報告"
Bot: 已添加內容到文件

瀏覽器 Skill

我: 幫我訪問 example.com 並截圖
Bot: [啓動瀏覽器] → [加載頁面] → [生成截圖] → [返回圖片]

自定義 Skill

在 ~/clawd/skills/ 目錄創建 Markdown 文件即可:

# skill: daily-report
每日工作彙報生成器


## 描述
根據今日對話記錄生成工作日報


## 觸發詞
生成日報， 今日總結


## 執行邏輯
1. 讀取今日所有對話記憶
2. 提取工作相關內容
3. 生成結構化日報

Clawdbot 成本估算與對比

費用項目	月費用	說明
VPS 服務器	¥35-70	可選，本地運行免費
Claude API	¥70-140	取決於使用量
Claude Pro 訂閱	¥140	用 OAuth 認證可省 API 費
Claude Max 訂閱	¥1400	重度使用者，Opus 無限制

成本優化建議

本地運行: 用家裏的電腦或 Mac mini 運行，省去 VPS 費用
API 代理: 通過 API易 apiyi.com 調用 Claude API，價格更優惠
模型選擇: 日常對話用 claude-haiku，複雜任務再切換 claude-sonnet
記憶管理: 定期清理無用記憶，減少 Token 消耗

Clawdbot 與其他方案對比

對比維度	Clawdbot	ChatGPT App	Claude App	自建 Bot
多平臺支持	⭐⭐⭐⭐⭐ 8+ 平臺	⭐⭐ 僅 App	⭐⭐ 僅 App	⭐⭐⭐ 需要逐個開發
對話記憶	⭐⭐⭐⭐⭐ 持久本地存儲	⭐⭐⭐ 雲端有限	⭐⭐⭐ 雲端有限	⭐⭐ 需自行實現
主動推送	⭐⭐⭐⭐⭐ 完整支持	❌ 不支持	❌ 不支持	⭐⭐⭐ 需自行實現
隱私保護	⭐⭐⭐⭐⭐ 本地存儲	⭐⭐ 雲端存儲	⭐⭐ 雲端存儲	⭐⭐⭐⭐ 取決於實現
定製能力	⭐⭐⭐⭐⭐ Skills 系統	⭐⭐ GPTs 有限	⭐⭐ Projects	⭐⭐⭐⭐⭐ 完全自定義
上手難度	⭐⭐⭐ 需要技術基礎	⭐⭐⭐⭐⭐ 開箱即用	⭐⭐⭐⭐⭐ 開箱即用	⭐ 需要大量開發

💡 選擇建議: Clawdbot 適合有一定技術背景、追求隱私和深度定製的用戶。如果你只需要簡單的 AI 對話，官方 App 已經足夠；如果你想讓 AI 真正融入日常工作流，Clawdbot 值得投入時間學習。

常見問題 FAQ

Q1: Clawdbot 需要 VPS 服務器嗎？

不是必需的。Clawdbot 可以在你的個人電腦上運行，只要電腦開機就能使用。但如果你希望 24 小時在線，建議使用:

家裏的常開電腦（Mac mini 等）
雲服務器（VPS，每月 ¥35-70）
本地 NAS 設備

Q2: 沒有海外信用卡怎麼獲取 Claude API？

可以通過 API易 apiyi.com 平臺獲取 Claude API 訪問。該平臺支持支付寶、微信付款，提供與官方一致的 API 接口，且價格更優惠。註冊後即可獲取 API Key，配置到 Clawdbot 即可使用。

Q3: Clawdbot 支持中文嗎？

完全支持。Clawdbot 本身只是一個網關，AI 能力來自底層模型（Claude/GPT）。這些模型都對中文有很好的支持，你可以用中文與 Clawdbot 進行所有交互。

Q4: 如何保證對話隱私？

Clawdbot 採用「本地優先」設計:

對話記憶存儲在你自己的設備上（Markdown 文件）
Gateway 運行在 localhost，不暴露公網
可通過 SSH 隧道或 Tailscale 安全訪問
只有 AI 模型調用需要聯網（API 請求）

Q5: 遇到問題去哪裏求助？

Clawdbot 有活躍的社區:

Discord 服務器: 加入後可直接與兩個 Clawdbot 實例對話，還能提問
GitHub Issues: github.com/clawdbot/clawdbot
官方文檔: docs.clawd.bot

Bug 反饋通常能很快得到響應，有時作者會在聊天中實時修復。

Q6: Windows 用戶如何安裝？

Windows 用戶強烈建議使用 WSL2:

安裝 WSL2 （推薦 Ubuntu 發行版）
在 WSL2 中安裝 Node.js 22+
按 Linux 步驟安裝 Clawdbot

原生 Windows 支持尚不完善，可能遇到各種問題。

Clawdbot 進階玩法

1. 多 Agent 協作

Clawdbot 支持創建多個會話（Session），它們可以相互通信:

Session A （研究助手）: 調研市場數據
Session B （寫作助手）: 接收 A 的數據，生成報告
Session C （審覈助手）: 檢查 B 的報告，提出修改建議

2. 自動化工作流

結合 Cron 定時任務:

每日早 8 點: 彙總郵箱重要郵件
每週一 9 點: 生成上週工作總結
每月 1 日: 統計本月 API 使用量

3. 智能家居集成

通過 Home Assistant 或 MQTT 連接智能設備:

我: 把客廳燈調暗一點
Bot: [調用 Home Assistant API] 已將客廳燈亮度調至 50%

4. 代碼開發輔助

Clawdbot 可以:

讀取代碼文件並解釋
執行 shell 命令
瀏覽 GitHub 倉庫
生成代碼並保存到文件

總結與下一步

Clawdbot 代表了個人 AI 助手的新範式:

核心價值	說明
無處不在	在你常用的聊天軟件中使用 AI
永不遺忘	持久化記憶，真正瞭解你
主動服務	不再被動等待，主動推送提醒
完全可控	開源自託管，數據永遠屬於你
無限擴展	Skills 系統讓能力無上限

下一步行動:

安裝 Clawdbot: npm install -g clawdbot@latest
獲取 Claude API: 推薦通過 API易 apiyi.com 快速獲取
運行配置嚮導: clawdbot onboard --install-daemon
連接你的第一個渠道（推薦從 Discord 開始）
加入 Clawdbot Discord 社區交流經驗

參考資料

Clawdbot 官網: 產品介紹和快速開始
- 鏈接: clawd.bot
Clawdbot 官方文檔: 完整配置指南
- 鏈接: docs.clawd.bot
GitHub 倉庫: 開源代碼和 Issues
- 鏈接: github.com/clawdbot/clawdbot
MacStories 深度評測: 使用體驗分享
- 鏈接: macstories.net/stories/clawdbot-showed-me-what-the-future-of-personal-ai-assistants-looks-like/
Peter Steinberger 個人站: 作者博客
- 鏈接: steipete.me

📝 作者: APIYI Team
🔗 技術交流: 訪問 apiyi.com 獲取更多 AI API 使用技巧
📅 更新日期: 2026年1月