Clawdbot：适用于所有聊天应用的无平台个人 AI 助手

Clawdbot 是什么？

Clawdbot 是一款开源个人人工智能助手，可以在你已经使用的应用中实时直播你的对话，支持 WhatsApp、Telegram、Slack、Discord、Microsoft Teams、Google Chat、Signal、iMessage，甚至更早的扩展如 BlueBubbles、Matrix 和 Zalo。它的标语：「你的专属 AI 助手。任何操作系统。任何平台。龙虾式方案。🦞」概括了核心承诺：本地、快速、始终在线、完全受你掌控。

a. 跨平台 – 基于 Node.js，Clawdbot 可在 macOS、Windows（通过 WSL2）、Linux、Android 和 iOS 上运行。我们还提供了一个小型的 Go 编译二进制文件，便于快速部署。

b. 多渠道收件箱 – 代理能在所有主流消息平台上交互。一旦收到消息，网关会将其分发到一个隔离的会话，该会话可记忆上下文、调用工具，甚至路由给其他代理。

c. 设备本地数据 – 所有聊天记录默认存储在本地 SQLite 数据库，除非你明确启用外部数据库。没有任何数据会被转发至第三方服务。

d. 插件友好 – 架构模块化：你可以在 skills/ 文件夹下添加或替换 skills（自定义提示、工具和处理程序），或从社区的 Skill Registry 拉取技能。

e. 实时画布 – 一个实时的基于 Web 的 UI 显示对话、状态，并可远程控制。内置的 A2UI 主机允许你构建可视化工作流或仪表盘。

为什么重要

市面上大多数 AI 劏助手都需要云账号：数据会流向供应商服务器，费用不断上升，隐私也随之受损。Clawdbot 则颠覆了这个模式：所有功能均在你自己的硬件上运行。它让日常消息应用成为一个统一的聊天中心，为 AI 助手提供读取网页、浏览站点、运行代码、同步日历事件并即时回答的能力。

对开发者而言，它亦是一个游乐场。代码仓库体积小巧，使用 TypeScript 编写（iOS 部分偶尔使用 Swift），上手向导可暴露每一个配置点，从 OAuth 令牌处理到沙箱策略。

快速安装指南

前置条件：Node 22+、pnpm（或 npm/bun）。克隆仓库并安装依赖。

1. 克隆并构建：

   git clone https://github.com/clawdbot/clawdbot.git
   cd clawdbot
   pnpm install
   pnpm ui:build  # compiles the frontend (one‑time)
   pnpm build
   

2. 运行向导 – 此步骤将配置网关、渠道、OAuth 和技能。

   pnpm clawdbot onboard --install-daemon
   

3. 它会询问你首选的模型（Anthropic、OpenAI 等）以及渠道凭据。

4. 启动网关 – 守护进程已启动并监听 ws://127.0.0.1:18789。

   pnpm clawdbot gateway --port 18789 --verbose
   

5. 发送测试 – 打开终端或使用你偏好的客户端。

   pnpm clawdbot message send --to +1234567890 --message "Hello from Clawdbot"
   

6. 在你的渠道聊天 – 如果你通过 Baileys 设置了 WhatsApp，请打开 WhatsApp 并开始与机器人聊天。第一条消息将触发配对码。

保护你的助手

Clawdbot 内置了强大的私信政策系统。默认情况下，未知发信人会收到 配对码，机器人在你批准之前不会处理该消息。

# 为 Telegram 批准新的配对码
pnpm clawdbot pairing approve telegram 1234

当你允许渠道为 开放 时，你必须明确选择接收所有用户的私信，以降低意外骚扰的风险。

为保持数据本地化并防止意外泄露，你应该：

• 将模型令牌保存在 .env 文件中。
• 对群聊使用沙箱模式：设置 agents.defaults.sandbox.mode: "non-main"。
• 限制工具访问：仅授权你可信的 browser、canvas 和 nodes。

扩展 Clawdbot

技能

一个 skill 是一个自包含的 JSON 提示 + 可选工具。把一个新的目录放在 skills/ 下，带一个 SKILL.md，助手就会发现它。社区已经提供了数十个可立即使用的技能，涵盖代码生成、网络抓取、数据检索和创意写作。

工具

Clawdbot 预装了高级工具：

• 浏览器控制 – 驱动无头 Chrome 获取页面、截屏并执行 JavaScript。
• 画布 – 将实时 UI 推送到浏览器，支持交互式可视化任务。
• 节点 – 摄像头捕获、屏幕录制、通知和系统命令。

你可以用 TypeScript/Swift 编写自定义工具，并通过工具注册表将其连接到技能。

用例

社区与贡献

Clawdbot 由一个充满活力的开发者社区维护。贡献形式包括技能、新渠道适配器、文档或错误修复。项目提供了全面的 CONTRIBUTING.md，让上手更轻松。

欢迎 Fork、提交 Issue 或 PR。仓库已有 253 位贡献者、11.7k 颗星、1.5k 次 Fork，证明社区持续扩大。

结论

如果你需要一个驻留在自己硬件上的个人 AI，能够在每日使用的消息应用中交互，并且完全开源，Clawdbot 就是答案。其灵活的上手向导、完善的安全模型以及丰富的扩展体系，使得在不牺牲隐私或速度的前提下，将 AI 引入日常工作流程变得轻而易举。

准备好开始吗？立即克隆仓库并启动上手向导——你的本地 AI 助手只需几条命令即可启动。