Clawdbot：您的個人化 AI 助理平台 🦞

總覽

Clawdbot 是一個創新的開源個人化 AI 助理平台，徹底改變了使用者與人工智慧互動的方式。與傳統的雲端助理不同，Clawdbot 完全在您的本地硬體上運行，同時無縫整合您日常使用的即時通訊應用程式。

Clawdbot 由 Peter Steinberger 開發，並由活躍的社群維護，它充當了強大的語言模型（Claude、GPT、Gemini）與您日常溝通管道之間的橋樑，創造了真正個人化、尊重隱私並提供前所未有控制權的 AI 體驗。

🚀 核心功能

多平台整合

• 即時通訊平台：WhatsApp、Telegram、Discord、Slack、Signal、iMessage、Microsoft Teams、Google Chat
• 擴充頻道：BlueBubbles、Matrix、Zalo、WebChat
• 行動支援：iOS 和 Android 配套應用程式
• 桌面端：具備語音喚醒功能的 macOS 選單列應用程式

本地優先架構

• 閘道系統：單一控制平面，管理所有連線和操作
• 自行託管：完全在您的硬體上運行（Mac、PC、Raspberry Pi 或雲端伺服器）
• 注重隱私：您的資料永不離開您的掌控
• 持久記憶：長期上下文保留，以 Markdown 檔案形式儲存在本地

進階功能

• 語音整合：Always-on 語音辨識，搭配 ElevenLabs TTS
• 即時畫布：由代理驅動的視覺化工作空間，搭配 A2UI
• 瀏覽器控制：自動化網頁導覽和表單填寫
• 系統存取：檔案管理、Shell 命令、Git 操作
• 智慧家居：與 Philips Hue 等裝置整合
• 主動式操作：排程任務、心跳監控、自動化工作流程

🏗️ 技術架構

以閘道為中心之設計

WhatsApp / Telegram / Discord / iMessage (+ 插件)
                    │
                    ▼
    ┌───────────────────────────────┐
    │         閘道                  │
    │      (控制平面)               │
    │   ws://127.0.0.1:18789        │
    └──────────────┬────────────────┘
                   │
    ├─ AI 代理 (RPC)
    ├─ CLI (clawdbot 命令)
    ├─ WebChat UI
    ├─ macOS 應用程式
    └─ iOS / Android 節點

關鍵組件

1. 閘道程序

• 長期執行的守護進程，管理所有即時通訊連線
• 用於客戶端通訊的 WebSocket 控制平面
• 會話路由和隔離
• 即時事件處理

2. 代理系統

• 多代理路由能力
• 基於工作空間的操作（約 clawd 目錄）
• 用於系統存取的工具整合層
• 用於安全執行的沙盒選項

3. 技能框架

• 模組化的 TypeScript/JavaScript 擴充功能
• 社群驅動的技能市集（ClawdHub）
• 透過 AI 生成的技能實現自我改進的能力
• 用於自訂整合的插件架構

4. 安全模型

• 用於未知聯絡人的 DM 配對系統
• 用於群組對話的 Docker 沙盒
• 可設定的權限系統
• 稽核記錄和安全診斷

🛠️ 安裝與設定

快速入門

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

# 執行入門精靈
clawdbot onboard --install-daemon

# 啟動閘道
clawdbot gateway --port 18789

開發設定

# 克隆儲存庫
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# 安裝依賴項
pnpm install
pnpm ui:build
pnpm build

# 執行入門設定
pnpm clawdbot onboard --install-daemon

系統需求

• 執行環境：Node.js ≥22
• 作業系統：macOS、Linux、Windows（透過 WSL2）
• 記憶體：建議 2GB+ RAM
• 儲存空間：建議使用 SSD 以獲得最佳效能

🔧 設定

核心設定

設定儲存在 ~/.clawdbot/clawdbot.json，包含全面的選項：

• 代理設定：工作空間路徑、模型偏好、思考層級
• 頻道設定：平台特定設定和存取控制
• 安全：沙盒模式、允許清單、DM 政策
• 工具：技能啟用和權限管理

多代理設定

# 建立隔離的代理實例
CLAWDBOT_CONFIG_PATH=~/.clawdbot/agent-a.json \
CLAWDBOT_STATE_DIR=~/.clawdbot-agent-a \
clawdbot gateway --port 19001

🎯 用途與應用

個人生產力

• 電子郵件管理和自動回覆
• 日曆協調和會議排程
• 跨多平台的任務自動化
• 文件處理和檔案整理

開發工作流程

• 程式碼審查和提取請求管理
• CI/CD 管道監控
• 儲存庫維護
• 自動化測試和部署

智慧家居整合

• 裝置控制和自動化
• 環境監控
• 排程例行事務
• 語音指令

創意專案

• 支援多媒體的內容生成
• 圖像和音訊處理
• 社群媒體管理
• 創意寫作輔助

🌟 社群與生態系統

活躍開發

• GitHub 儲存庫：18,000+ 顆星，持續成長中
• 發佈週期：頻繁更新，新增功能
• 社群 Discord：數千名活躍使用者
• 文件：全面的指南和教學

插件生態系統

• ClawdHub：集中式技能儲存庫
• 社群貢獻：使用者生成的技能和插件
• 整合函式庫：熱門服務的預建連接器
• 開發工具：用於擴充功能開發的 SDK 和 CLI 工具

📊 效能與擴充性

Token 效率

• 智慧快取以降低 API 成本
• 大型對話的自適應分塊
• 漸進式備援機制
• 上下文優化策略

資源管理

• 輕量級閘道程序
• 高效的 WebSocket 通訊
• 長期會話的優化記憶體使用
• 可設定的資源限制

🔒 安全與隱私

隱私優先設計

• 所有資料處理均在本地進行
• 核心功能無雲端依賴
• 使用者控制的資料保留政策
• 透明的日誌記錄和稽核能力

安全功能

• 沙盒執行環境
• 基於權限的工具存取
• 安全憑證管理
• 網路隔離選項

🚧 當前限制與考量

技術挑戰

• 設定複雜度：初始設定需要技術知識
• API 成本：依賴付費 LLM 服務以獲得最佳效能
• 資源需求：Always-on 設定受益於專用硬體
• 早期階段：活躍開發中，偶有破壞性變更

緩解策略

• 改進的入門精靈降低了設定複雜度
• 對本地模型的支援減少了對 API 的依賴
• 全面的文件和社群支援
• Docker 容器提供隔離和一致性

🔮 未來路線圖

計畫中的增強功能

• 增強的本地模型支援：與開源 LLM 的整合度更高
• 行動應用程式擴展：iOS 和 Android 的功能對等
• 視覺化介面改進：進階的 Canvas 和 A2UI 功能
• 企業功能：團隊協作和管理工具

社群目標

• 更廣泛的平台支援：額外的即時通訊平台整合
• 簡化設定：一鍵安裝體驗
• 效能優化：降低資源消耗
• 教育資源：教學和認證計畫

🤝 參與其中

對於使用者

• 安裝指南：入門文件
• 社群 Discord：加入討論並獲得支援
• 技能市集：透過 ClawdHub 探索和貢獻技能
• 意見回饋：在 GitHub 上報告問題並建議功能

對於開發者

• 貢獻：請參閱 CONTRIBUTING.md 以了解開發指南
• 插件開發：建立自訂技能和整合
• 文件：協助改進指南和教學
• 測試：參與 Beta 測試和品質保證

📚 資源與連結

• 官方網站：clawd.bot
• GitHub 儲存庫：github.com/clawdbot/clawdbot
• 文件：docs.clawd.bot
• 社群 Discord：活躍的支援和開發討論
• NPM 套件：npmjs.com/package/clawdbot

---

Clawdbot 代表了個人化 AI 助理的未來：本地控制、無限擴充，並無縫整合到您的日常工作流程中。加入這場革命，掌控您的 AI 體驗！🦞