文章详细介绍了开源项目 Clawdbot，这是一个旨在运行在用户本地设备上的新一代个人 AI 助手。其核心优势在于“本地优先”和“私有化”，支持包括 WhatsApp、Telegram、iMessage 等在内的十余种主流通讯渠道。技术架构上，它由 Gateway 控制平面和助手本体组成，支持 Node.js 环境安装，并提供 CLI 向导简化配置。功能亮点包括多代理路由、语音唤醒、实时 Canvas 渲染以及与 Anthropic 和 OpenAI 模型的深度集成。此外，文章还强调了其安全机制，如 DM 配对策略，以防止未经授权的访问，并提供了从源代码构建的开发者指南。
Clawdbot 是一款运行在你自己设备上的个人 AI 助手。它可以在你已经使用的通讯渠道中与你对话，包括：WhatsApp ，Telegram ，Slack ，Discord ，Google Chat ，Signal ， iMessage ，Microsoft Teams ，WebChat 。同时还支持扩展渠道，例如 BlueBubbles、Matrix、Zalo 以及 Zalo Personal。Clawdbot 支持在 macOS / iOS / Android上进行语音交互（说与听），并且可以渲染一个由你控制的实时 Canvas。
Gateway 只是控制平面，真正的产品是这个助手本身。
如果你想要一个单用户、私有化、本地感强、响应快、始终在线的个人 AI 助手，那么它就是你要找的。
推荐安装方式(clawdbot onboard)。该向导将引导你完成以下配置步骤：Gateway 配置，Workspace 工作区，通讯渠道设置，技能（Skills）配置。CLI 向导是官方强烈推荐的安装方式，支持以下操作系统：macOS，Linux，Windows（通过 WSL2，强烈推荐）。支持的包管理器有：npm，pnpm，bun。新安装用户请从 Getting Started [1]开始。
订阅（OAuth）：
•Anthropic[2]（Claude Pro / Max）•OpenAI[3]（ChatGPT / Codex）
虽然 Clawdbot 支持任何模型，但强烈推荐以下组合以获得最佳效果:Anthropic Pro / Max（100 / 200）+ Opus 4.5。这样可以提供更强的长上下文处理能力，并有效提高对提示注入（Prompt Injection）的抵抗力。详情请参考 Onboarding[4] 文档。
模型（选择与认证）
•模型选择与认证配置：Models[5]•认证配置文件轮换（OAuth 与 API 密钥的选择）及回退机制：Model failover[6]
安装（推荐）
运行环境：Node ≥22
使用以下命令进行安装：
npm install -g clawdbot@latest# 或者使用 pnpm:pnpm add -g clawdbot@latestclawdbot onboard --install-daemon
此命令会安装 Gateway 守护进程（launchd / systemd 用户服务），确保它持续运行。
快速开始 (简明版)
运行环境: Node ≥ 22。
完整的新手指南 (认证、配对、通道)：开始使用[7]
clawdbot onboard --install-daemonclawdbot gateway --port 18789--verbose# Send a messageclawdbot message send --to +1234567890--message "Hello from Clawdbot"# Talk to the assistant (optionally deliver back to any connected channel: WhatsApp/Telegram/Slack/Discord/Google Chat/Signal/iMessage/BlueBubbles/Microsoft Teams/Matrix/Zalo/Zalo Personal/WebChat)clawdbot agent --message "Ship checklist"--thinking high
请查看更新指南[8]（并运行 clawdbot doctor）。
开发通道
•stable：已打标签的正式版本
（vYYYY.M.D 或 vYYYY.M.D-<patch>），npm 分发标签为 latest。•beta：预发布版本标签
（vYYYY.M.D-beta.N），npm 分发标签为 beta（macOS 应用可能暂时缺失）。•dev：main 分支的最新进展版本，
npm 分发标签为 dev（在发布时可用）。
切换通道（Git + npm）：clawdbot update --channel stable|beta|dev。 更多详情请参阅：开发通道（Development channels[9]）。
从源代码构建（开发版）
推荐使用 pnpm 进行源代码构建。Bun 是可选的，用于直接运行 TypeScript。
git clone https://github.com/clawdbot/clawdbot.gitcd clawdbotpnpm installpnpm ui:build # 第一次运行时自动安装 UI 依赖pnpm buildpnpm clawdbot onboard --install-daemon# 开发循环（自动重载 TypeScript 文件变动）pnpm gateway:watch
注意：pnpm clawdbot ... 直接运行 TypeScript（通过tsx）。pnpm build 会生成 dist/ 文件夹，用于通过 Node 或打包的 clawdbot 二进制文件运行。
安全默认设置（DM 访问）
Clawdbot 连接到真实的消息平台。请将收到的 DM（私信）视为不可信输入。
完整的安全指南：安全[10]
默认行为在以下平台上：Telegram、WhatsApp、Signal、iMessage、Microsoft Teams、Discord、Google Chat、Slack：
•DM 配对（dmPolicy="pairing" / channels.discord.dm.policy="pairing"/ channels.slack.dm.policy="pairing"）：来自未知发件人的消息将收到一个短的配对码，机器人不会处理他们的消息。•批准操作：使用以下命令批准：clawdbot pairing approve <channel> <code> 此时，发件人将被添加到本地允许列表中。•公共的入站 DM 需要明确的选择加入：设置 dmPolicy="open"并在通道的允许列表中加入 "*" （allowFrom / channels.discord.dm.allowFrom / channels.slack.dm.allowFrom）。
运行 clawdbot doctor 来检查有风险或配置错误的 DM 策略。
亮点
•本地优先网关 [11]— 单一控制面板，管理会话、通道、工具和事件。•多通道收件箱[12] — 支持 WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、BlueBubbles、Microsoft Teams、Matrix、Zalo、Zalo Personal、WebChat、macOS、iOS/Android。•多代理路由[13] — 将入站的通道/账户/对等设备路由到隔离的代理（工作区 + 每个代理的会话）。•语音唤醒[14] + 对话模式[15] — 在 macOS/iOS/Android 上提供始终开启的语音支持（与 ElevenLabs 配合）。•实时画布[16] — 代理驱动的视觉工作区与 A2UI[17]。•一流的工具[18] — 浏览器、画布、节点、定时任务、会话，以及 Discord/Slack 操作。•伴随应用[19] — macOS 菜单栏应用 + iOS/Android 节点[20]。•入门[21]与技能[22] — 向导驱动的设置，包含/管理/工作区技能。
https://github.com/clawdbot/clawdbot?tab=readme-ov-fileReferences
[1] Getting Started :https://github.com/clawdbot/clawdbot?tab=readme-ov-file
[2]Anthropic:github.com/clawdbot/clawdbot?tab=readme-ov-file
[3]OpenAI:https://openai.com/zh-Hans-CN/
[4]Onboarding:https://docs.clawd.bot/start/onboarding
[5]Models:https://docs.clawd.bot/concepts/models
[6]Model failover:https://docs.clawd.bot/concepts/model-failover
[7]开始使用:https://docs.clawd.bot/start/getting-started
[8]更新指南:https://docs.clawd.bot/install/updating
[9]Development channels:https://docs.clawd.bot/install/development-channels
[10]安全:https://docs.clawd.bot/gateway/security
[11]本地优先网关 :https://docs.clawd.bot/gateway
[12]多通道收件箱:https://docs.clawd.bot/channels
[13]多代理路由:https://docs.clawd.bot/gateway/configuration
[14]语音唤醒:https://docs.clawd.bot/nodes/voicewake
[15]对话模式:https://docs.clawd.bot/nodes/talk
[16]实时画布:https://docs.clawd.bot/platforms/mac/canvas
[17]A2UI:https://docs.clawd.bot/platforms/mac/canvas#canvas-a2ui
[18]一流的工具:https://docs.clawd.bot/tools
[19]伴随应用:https://docs.clawd.bot/platforms/macos
[20]节点:https://docs.clawd.bot/nodes
[21]入门:https://docs.clawd.bot/start/wizard
[22]技能: https://docs.clawd.bot/tools/skills