Clawdbot — 开源的新一代个人 AI 助手

Clawdbot

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@latest

clawdbot onboard --install-daemon

此命令会安装 Gateway 守护进程（launchd / systemd 用户服务），确保它持续运行。

快速开始 (简明版)

运行环境: Node ≥ 22。

完整的新手指南 (认证、配对、通道)：开始使用[7]

clawdbot onboard --install-daemon

clawdbot gateway --port 18789--verbose

# Send a message
clawdbot 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.git
cd clawdbot

pnpm install
pnpm ui:build # 第一次运行时自动安装 UI 依赖
pnpm build

pnpm 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-file

References

[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