Clawdbot开源项目：跨平台私人AI助手部署，支持微信与Telegram

“如果有一个AI助手，它能同时出现在你的WhatsApp、Telegram、Slack、Discord、iMessage、微软Teams，甚至是你的macOS菜单栏里，随叫随到，你会心动吗？”

今天要介绍的这个开源项目，可能会彻底改变你对“AI助手”这个概念的认知。它不是ChatGPT那样需要你打开网页才能使用的AI，也不是Siri那样只能在苹果设备上使用的语音助手。它是一个真正的“全平台AI管家”——可以出现在你任何常用的通讯软件里，24小时待命，而且完全开源、完全免费、完全可控。

这个项目叫做 Clawdbot（也曾叫做 Moltbot），GitHub地址：github.com/moltbot/moltbot

🔥 它是目前开源社区最活跃的个人AI助手项目之一。

---

一、Clawdbot是什么？凭什么值得你关注？

1.1 一句话定义

“Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞”
（你自己的私人AI助手，任何操作系统，任何平台，龙虾风格🦞）

这句slogan可能让你觉得有点莫名其妙——什么是“龙虾风格”？别急，这其实是开发团队的一个有趣梗。但抛开这个梗不谈，Clawdbot的核心价值主张非常清晰：

传统AI助手的痛点	Clawdbot的解决方案
只能在特定平台使用	支持15+通讯渠道，包括WhatsApp、Telegram、Slack、Discord、Signal、iMessage、微软Teams、Google Chat等
数据隐私担忧	完全本地部署，你的对话数据不会经过任何第三方服务器
功能单一	集成浏览器控制、画布工具、语音唤醒、定时任务、摄像头访问等强大功能
需要联网才能使用	支持离线模型，本地运行大语言模型
配置复杂	向导式安装，一键部署

1.2 为什么叫“龙虾风格”？

这个名字来源于项目的logo——一只可爱的龙虾🦞。开发团队在文档中提到了一个叫做“The Great Molt”（大蜕皮）的传说，象征着项目从Clawdbot到Moltbot的演变过程。龙虾通过蜕皮来成长，这个项目也在不断“蜕皮”进化。

但更重要的是，“Clawd”这个名字暗示了它与Claude（Anthropic的AI模型）的关联——Clawdbot默认使用Claude作为底层AI引擎。

---

二、架构深度解析：Clawdbot是如何工作的？

2.1 核心架构：Gateway-Agent-Channel三层模型

Clawdbot的架构设计非常优雅，采用了三层解耦的设计模式：

┌─────────────────────────────────────────────────────────────┐
│                       用户层 (Channels)                       │
├─────────────────────────────────────────────────────────────┤
│  WhatsApp │ Telegram │ Slack │ Discord │ iMessage │ Teams  │
│  Signal   │ Google Chat │ Matrix │ WebChat │ BlueBubbles   │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                   控制层 (Gateway)                           │
├─────────────────────────────────────────────────────────────┤
│  • WebSocket控制平面     • 会话管理                           │
│  • 定时任务调度          • Webhook处理                        │
│  • Canvas画布托管        • 认证与安全                          │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                   执行层 (Agent)                             │
├─────────────────────────────────────────────────────────────┤
│  • Pi Agent运行时        • 工具流式处理                        │
│  • 浏览器控制            • 文件读写                           │
│  • 系统命令执行          • 摄像头/屏幕录制                     │
└─────────────────────────────────────────────────────────────┘

2.1.1 Gateway层（网关层）

Gateway是Clawdbot的“大脑中枢”，负责：

• WebSocket网络：所有客户端、工具、事件都通过一个统一的WebSocket控制平面进行通信
• 会话管理：支持多种会话模式——主会话、群组隔离、激活模式、队列模式、回复模式
• 定时任务：内置Cron调度器，支持定时唤醒、Webhook触发、Gmail Pub/Sub等
• 安全认证：支持Tailscale、SSH隧道、密码认证等多种安全访问方式

// Gateway配置示例
{
  "gateway": {
    "bind": "127.0.0.1:8080",
    "tailscale": {
      "mode": "serve" // 支持 off | serve | funnel
    },
    "auth": {
      "mode": "password",
      "allowTailscale": true
    }
  }
}

2.1.2 Channel层（通道层）

这是Clawdbot最令人兴奋的部分——它支持几乎所有主流的即时通讯平台：

平台	底层技术	特色功能
WhatsApp	Baileys库	支持图片、语音、视频消息
Telegram	grammY框架	支持Bot API全部功能
Slack	Bolt.js	支持工作区级别的集成
Discord	discord.js	支持原生斜杠命令
iMessage	imsg库	仅macOS，深度系统集成
Signal	signal-cli	端到端加密通信
Microsoft Teams	Bot Framework	企业级集成
Google Chat	Chat API	G Suite集成
Matrix	矩阵协议	去中心化通信
WebChat	内置	Gateway直接提供

配置示例：同时启用WhatsApp和Telegram

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "allowFrom": ["8613800138000"],  // 允许的手机号
      "groups": {
        "*": { "requireMention": true }  // 群组需要@才响应
      }
    },
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN",
      "allowFrom": ["your_username"]
    }
  }
}

2.1.3 Agent层（代理层）

Agent是实际执行任务的“手脚”，它能够：

• 执行系统命令：通过 bash 工具在本地执行shell命令
• 浏览器控制：通过CDP协议控制Chrome/Chromium，实现网页自动化
• 文件操作：读取、写入、编辑本地文件
• Canvas画布：提供可视化的工作空间，支持A2UI（Agent to UI）
• 设备控制：访问摄像头、录制屏幕、获取位置信息

---

三、安全模型：Clawdbot如何保护你的隐私？

3.1 本地优先（Local-First）设计

Clawdbot的核心设计理念是“Local-First” ——所有数据默认存储在本地，所有处理默认在本地完成。这意味着：

• ✅ 你的聊天记录不会上传到任何云服务器
• ✅ 你的API密钥只存储在本地配置文件中
• ✅ 你可以随时审计所有的数据流向

3.2 DM配对机制（Pairing）

当有人通过私信联系你的AI助手时，默认会触发“配对验证”机制：

陌生人发送消息 → AI回复验证码 → 你在CLI中确认 → 配对成功

这个机制防止了未授权用户滥用你的AI助手。

# 批准一个配对请求
clawdbot pairing approve telegram ABC123

3.3 沙箱模式（Sandbox）

对于群组和非主会话，Clawdbot支持Docker沙箱隔离：

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main" // 非主会话使用Docker沙箱
      }
    }
  }
}

沙箱默认规则：

• ✅ 允许：bash、process、read、write、edit、sessions_*
• ❌ 禁止：browser、canvas、node、cron、discord、gateway

---

四、语音交互：Voice Wake + Talk Mode

4.1 语音唤醒（Voice Wake）

在macOS和iOS/Android设备上，Clawdbot支持始终在线的语音唤醒功能：

• 使用 ElevenLabs 进行高质量语音合成
• 支持 自定义唤醒词
• 支持 连续对话模式（Talk Mode）

4.2 Push-to-Talk覆盖层

macOS应用提供了一个浮动的Push-to-Talk覆盖层，让你可以随时按住快捷键与AI对话：

按住快捷键 → 开始录音 → 松开 → AI处理并回复 → 语音播放

这种交互方式比打字快得多，特别适合需要快速沟通的场景。

---

五、应用生态：macOS + iOS + Android

5.1 macOS菜单栏应用（Clawdbot.app）

┌──────────────────────────────┐
│  🦞 Clawdbot                 │
├──────────────────────────────┤
│  Status: Running             │
│  Sessions: 3 active          │
│  ──────────────────────      │
│  📊 Open Dashboard           │
│  💬 WebChat                  │
│  🔧 Debug Tools              │
│  ──────────────────────      │
│  ⚙️ Settings                 │
│  🔄 Restart Gateway          │
│  ❌ Quit                     │
└──────────────────────────────┘

功能亮点：

• 菜单栏快速访问
• 语音唤醒和PTT覆盖层
• WebChat和调试工具
• 远程Gateway控制（通过SSH）

5.2 iOS/Android节点（Node）

移动设备可以作为“节点”（Node）连接到Gateway：

• 📷 摄像头访问：AI可以请求拍照或录制视频
• 🖥️ 屏幕录制：AI可以查看你的屏幕
• 📍 位置获取：AI可以获取你的GPS位置
• 🔔 通知推送：AI可以向你的设备发送通知
• 🎨 Canvas画布：在移动设备上显示AI生成的可视化内容

配对方式：通过Bonjour（iOS）或二维码扫描进行本地网络配对

---

六、工具生态：从浏览器控制到技能市场

6.1 浏览器控制（Browser Control）

Clawdbot内置了强大的浏览器自动化能力：

// AI可以执行的浏览器操作
browser.navigate(“https://example.com”)
browser.snapshot()  // 获取页面快照
browser.click(element)
browser.type(element, “text”)
browser.screenshot()

实际应用场景：

• 自动填写表单
• 抓取网页信息
• 监控网站变化
• 自动化测试

6.2 Canvas画布（A2UI）

A2UI（Agent to UI）是Clawdbot最前沿的功能之一——它允许AI直接生成可视化的用户界面：

你：“帮我画一个待办事项清单”
AI：[生成可交互的Canvas界面]

Canvas支持：

• 实时推送/重置
• JavaScript eval执行
• 快照保存

6.3 技能市场（ClawdHub）

Clawdbot拥有自己的技能注册表系统（ClawdHub）：

# 搜索可用技能
clawdbot skills search “weather”

# 安装技能
clawdbot skills install weather-forecast

技能类型：

• Bundled：内置技能
• Managed：官方维护的技能
• Workspace：你自己创建的技能

---

七、快速上手：5分钟部署你的第一个Clawdbot

7.1 环境要求

• Node.js ≥ 22
• macOS / Linux / Windows（推荐macOS或Linux）
• 可选：Docker（用于沙箱隔离）

7.2 安装步骤

# 1. 安装Clawdbot
npm install -g @clawdbot/clawdbot

# 2. 运行安装向导
clawdbot install

# 3. 启动Gateway
clawdbot gateway

# 4. 打开WebChat测试
open http://localhost:8080

7.3 配置你的第一个Channel

以Telegram为例：

1. 在Telegram中找到 @BotFather

2. 创建一个新Bot，获取Token

3. 编辑配置文件：

   vim ~/.clawdbot/clawdbot.json

   {
     "model": "claude-sonnet-4-20250514",
     "channels": {
       "telegram": {
         "enabled": true,
         "botToken": "YOUR_BOT_TOKEN"
       }
     }
   }

4. 重启Gateway：

   clawdbot gateway restart

恭喜！现在你可以在Telegram中与你的AI助手对话了！

---

八、远程访问：Tailscale + SSH隧道

8.1 Tailscale集成

Clawdbot原生支持Tailscale，让你可以安全地远程访问Gateway：

{
  "gateway": {
    "tailscale": {
      "mode": "serve" // tailnet内部访问
      // 或 "funnel"   // 公网访问（需要密码）
    }
  }
}

模式说明：

• off：不使用Tailscale
• serve：仅Tailnet内部可访问（使用Tailscale身份认证）
• funnel：公网可访问（必须配置密码）

8.2 SSH隧道

如果你不使用Tailscale，也可以通过SSH隧道访问远程Gateway：

# 建立SSH隧道
ssh -L 8080:localhost:8080 user@your-server

# 然后访问本地端口
open http://localhost:8080

九、常见问题FAQ

Q1: Clawdbot需要付费吗？

A: Clawdbot本身完全开源免费。但如果你使用Claude API，需要付费。你也可以使用免费的本地模型。

Q2: 对服务器配置有要求吗？

A: 最低要求Node.js 22+，2GB内存。如果要运行本地模型，建议8GB以上内存和GPU。

Q3: 支持中文吗？

A: 取决于底层AI模型。Claude和GPT都支持中文。

Q4: 数据安全吗？

A: 所有数据默认存储在本地（~/.clawdbot/目录）。如果你使用云API，对话内容会发送到API提供商。

Q5: 可以商用吗？

A: Clawdbot使用MIT协议，可以商用。但需要遵守底层AI模型的使用条款。

---

结语

Clawdbot 代表了一种新的 人工智能 助手范式：它不再是孤立的聊天窗口，而是一个可以无缝融入你数字生活各个角落的智能代理。其本地优先的架构和强大的跨平台能力，为注重隐私和灵活性的开发者及用户提供了极具吸引力的选择。

通过它的 开源实战 生态和活跃的社区，你可以基于此项目构建自己的自动化工作流，或者集成到现有的业务系统中。无论是作为个人效率工具，还是作为探索 Agent 技术的前沿实验场，Clawdbot 都值得一试。现在，是时候通过 npm 安装，体验一下你的专属跨平台“龙虾管家”了。

---