🦞 Moltbot（Clawdbot）中文翻译— 个人 AI 助手

蜕皮吧！蜕皮吧！

Moltbot 是一个运行在你自己设备上的个人 AI 助手。它在你已经使用的频道上回答你的问题（WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams、WebChat），以及扩展频道如 BlueBubbles、Matrix、Zalo 和 Zalo Personal。它可以在 macOS/iOS/Android 上说话和倾听，并可以渲染一个你控制的实时画布。网关只是控制平面——产品才是助手。

如果你想要一个个人的、单用户的助手，感觉本地、快速且始终在线，这就是它。

网站 · 文档 · 快速入门 · 更新 · 展示 · 常见问题 · 向导 · Nix · Docker · Discord

推荐设置：运行入门向导（moltbot onboard）。它会引导你完成网关、工作区、频道和技能的设置。CLI 向导是推荐的路径，适用于 macOS、Linux 和 Windows（通过 WSL2；强烈推荐）。支持 npm、pnpm 或 bun。新安装？从这里开始：快速入门

订阅（OAuth）：

Anthropic (Claude Pro/Max)
OpenAI (ChatGPT/Codex)

模型说明：虽然支持任何模型，但我强烈推荐 Anthropic Pro/Max (100/200) + Opus 4.5 以获得长上下文强度和更好的提示注入抵抗能力。参见入门指南。

模型（选择 + 认证）

模型配置 + CLI：模型
认证配置轮换（OAuth vs API 密钥）+ 故障转移：模型故障转移

安装（推荐）

运行时要求：Node ≥22。

npm install -g moltbot@latest
# 或：pnpm add -g moltbot@latest

moltbot onboard --install-daemon

向导会安装网关守护进程（launchd/systemd 用户服务）使其保持运行。遗留说明：clawdbot 作为兼容性垫片仍然可用。

快速入门（简述）

运行时要求：Node ≥22。

完整的新手指南（认证、配对、频道）：快速入门

moltbot onboard --install-daemon

moltbot gateway --port 18789 --verbose

# 发送消息
moltbot message send --to +1234567890 --message "来自 Moltbot 的问候"

# 与助手对话（可选择传回到任何已连接的频道：WhatsApp/Telegram/Slack/Discord/Google Chat/Signal/iMessage/BlueBubbles/Microsoft Teams/Matrix/Zalo/Zalo Personal/WebChat）
moltbot agent --message "发货清单" --thinking high

正在升级？更新指南（并运行 moltbot 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）：moltbot update --channel stable|beta|dev。详情：开发频道。

从源码构建（开发）

推荐使用 pnpm 进行源码构建。Bun 是可选的，用于直接运行 TypeScript。

git clone https://github.com/moltbot/moltbot.git
cd moltbot

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

pnpm moltbot onboard --install-daemon

# 开发循环（TS 更改时自动重新加载）
pnpm gateway:watch

注意：pnpm moltbot ... 直接运行 TypeScript（通过 tsx）。pnpm build 生成 dist/ 用于通过 Node / 打包的 moltbot 二进制文件运行。

安全默认值（私信访问）

Moltbot 连接到真实的消息界面。将入站私信视为不受信任的输入。

完整安全指南：安全

Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/Google Chat/Slack 上的默认行为：

私信配对（dmPolicy="pairing" / channels.discord.dm.policy="pairing" / channels.slack.dm.policy="pairing"）：未知发送者会收到一个简短的配对代码，机器人不会处理他们的消息。
使用以下命令批准：moltbot pairing approve <channel> <code>（然后将发送者添加到本地允许列表存储）。
公开入站私信需要明确选择加入：设置 dmPolicy="open" 并在频道允许列表中包含 "*"（allowFrom / channels.discord.dm.allowFrom / channels.slack.dm.allowFrom）。

运行 moltbot doctor 来暴露有风险/配置错误的私信策略。

亮点

本地优先网关 — 会话、频道、工具和事件的单一控制平面。
多频道收件箱 — WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、BlueBubbles、Microsoft Teams、Matrix、Zalo、Zalo Personal、WebChat、macOS、iOS/Android。
多代理路由 — 将入站频道/账户/对等点路由到隔离的代理（工作区 + 每代理会话）。
语音唤醒 + 对话模式 — 适用于 macOS/iOS/Android 的始终在线语音，配合 ElevenLabs。
实时画布 — 由代理驱动的视觉工作空间，具有 A2UI。
一流工具 — 浏览器、画布、节点、cron、会话以及 Discord/Slack 操作。
配套应用 — macOS 菜单栏应用 + iOS/Android 节点。
入门 + 技能 — 向导驱动的设置，包含捆绑/管理/工作区技能。

Star 历史

我们到目前为止构建的所有内容

核心平台

网关 WS 控制平面，包含会话、在线状态、配置、cron、webhook、控制 UI和画布主机。
CLI 界面：网关、代理、发送、向导和医生。
Pi 代理运行时（RPC 模式），支持工具流和块流。
会话模型：main 用于直接聊天、群组隔离、激活模式、队列模式、回复。群组规则：群组。
媒体管道：图片/音频/视频、转录钩子、大小限制、临时文件生命周期。音频详情：音频。

频道

频道：WhatsApp（Baileys）、Telegram（grammY）、Slack（Bolt）、Discord（discord.js）、Google Chat（Chat API）、Signal（signal-cli）、iMessage（imsg）、BlueBubbles（扩展）、Microsoft Teams（扩展）、Matrix（扩展）、Zalo（扩展）、Zalo Personal（扩展）、WebChat。
群组路由：提及过滤、回复标签、每频道分块和路由。频道规则：频道。

应用 + 节点

macOS 应用：菜单栏控制平面、语音唤醒/PTT、对话模式覆盖层、WebChat、调试工具、远程网关控制。
iOS 节点：画布、语音唤醒、对话模式、相机、屏幕录制、Bonjour 配对。
Android 节点：画布、对话模式、相机、屏幕录制、可选的 SMS。
macOS 节点模式：system.run/notify + 画布/相机暴露。

工具 + 自动化

浏览器控制：专用的 moltbot Chrome/Chromium、快照、操作、上传、配置文件。
画布：A2UI推送/重置、eval、快照。
节点：相机抓拍/剪辑、屏幕录制、location.get、通知。
Cron + 唤醒；webhook；Gmail Pub/Sub。
技能平台：捆绑、管理和工作区技能，具有安装门控 + UI。

运行时 + 安全

运维 + 打包

直接从网关提供控制 UI + WebChat。
Tailscale Serve/Funnel或SSH 隧道，带有令牌/密码认证。
Nix 模式用于声明性配置；基于Docker的安装。
医生迁移、日志记录。

工作原理（简述）

WhatsApp / Telegram / Slack / Discord / Google Chat / Signal / iMessage / BlueBubbles / Microsoft Teams / Matrix / Zalo / Zalo Personal / WebChat
               │
               ▼
┌───────────────────────────────┐
│            网关                │
│       （控制平面）             │
│     ws://127.0.0.1:18789      │
└──────────────┬────────────────┘
               │
               ├─ Pi 代理（RPC）
               ├─ CLI（moltbot …）
               ├─ WebChat UI
               ├─ macOS 应用
               └─ iOS / Android 节点

关键子系统

网关 WebSocket 网络 — 客户端、工具和事件的单一 WS 控制平面（加上运维：网关运行手册）。
Tailscale 暴露 — 用于网关仪表板 + WS 的 Serve/Funnel（远程访问：远程）。
浏览器控制 — 由 moltbot 管理的 Chrome/Chromium，具有 CDP 控制。
画布 + A2UI — 由代理驱动的视觉工作空间（A2UI 主机：画布/A2UI）。
语音唤醒 + 对话模式 — 始终在线的语音和连续对话。
节点 — 画布、相机抓拍/剪辑、屏幕录制、location.get、通知，加上仅限 macOS 的 system.run/system.notify。

Tailscale 访问（网关仪表板）

Moltbot 可以自动配置 Tailscale Serve（仅限 tailnet）或 Funnel（公开），同时网关保持绑定到回环地址。配置 gateway.tailscale.mode：

off：无 Tailscale 自动化（默认）。
serve：通过 tailscale serve 实现仅限 tailnet 的 HTTPS（默认使用 Tailscale 身份标头）。
funnel：通过 tailscale funnel 实现公开 HTTPS（需要共享密码认证）。

注意：

当启用 Serve/Funnel 时，gateway.bind 必须保持为 loopback（Moltbot 会强制执行此操作）。
可以通过设置 gateway.auth.mode: "password" 或 gateway.auth.allowTailscale: false 强制 Serve 要求密码。
除非设置了 gateway.auth.mode: "password"，否则 Funnel 将拒绝启动。
可选：gateway.tailscale.resetOnExit 在关闭时撤消 Serve/Funnel。

详情：Tailscale 指南 · Web 界面

远程网关（Linux 很棒）

在小型 Linux 实例上运行网关是完全没问题的。客户端（macOS 应用、CLI、WebChat）可以通过 Tailscale Serve/Funnel 或 SSH 隧道连接，你仍然可以配对设备节点（macOS/iOS/Android）以在需要时执行设备本地操作。

网关主机默认运行 exec 工具和频道连接。
设备节点通过 node.invoke 运行设备本地操作（system.run、相机、屏幕录制、通知）。简而言之：exec 运行在网关所在的位置；设备操作运行在设备所在的位置。

详情：远程访问 · 节点 · 安全

通过网关协议获取 macOS 权限

macOS 应用可以在节点模式下运行，并通过网关 WebSocket（node.list / node.describe）通告其能力 + 权限映射。客户端然后可以通过 node.invoke 执行本地操作：

system.run 运行本地命令并返回 stdout/stderr/退出代码；设置 needsScreenRecording: true 以要求屏幕录制权限（否则你会得到 PERMISSION_MISSING）。
system.notify 发布用户通知，如果通知被拒绝则失败。
canvas.*、camera.*、screen.record 和 location.get 也通过 node.invoke 路由，并遵循 TCC 权限状态。

提升的 bash（主机权限）与 macOS TCC 是分开的：

使用 /elevated on|off 在启用 + 加入允许列表时切换每会话的提升访问。
网关通过 sessions.patch（WS 方法）持久化每会话切换， alongside thinkingLevel、verboseLevel、model、sendPolicy 和 groupActivation。

详情：节点 · macOS 应用 · 网关协议

代理到代理（sessions_* 工具）

使用这些工具来协调跨会话的工作，而无需在聊天界面之间跳转。
sessions_list — 发现活动会话（代理）及其元数据。
sessions_history — 获取会话的转录日志。
sessions_send — 向另一个会话发送消息；可选的回复 ping-pong + 公告步骤（REPLY_SKIP、ANNOUNCE_SKIP）。

详情：会话工具

技能注册表（ClawdHub）

ClawdHub 是一个极简的技能注册表。启用 ClawdHub 后，代理可以自动搜索技能并根据需要拉取新技能。

ClawdHub

聊天命令

在 WhatsApp/Telegram/Slack/Google Chat/Microsoft Teams/WebChat 中发送这些命令（群组命令仅限所有者）：

/status — 紧凑的会话状态（模型 + token，可用时显示成本）
/new 或 /reset — 重置会话
/compact — 压缩会话上下文（摘要）
/think <level> — off|minimal|low|medium|high|xhigh（仅限 GPT-5.2 + Codex 模型）
/verbose on|off
/usage off|tokens|full — 每响应使用情况页脚
/restart — 重启网关（群组中仅限所有者）
/activation mention|always — 群组激活切换（仅限群组）

应用（可选）

仅网关就能提供出色的体验。所有应用都是可选的，并添加额外功能。

如果你计划构建/运行配套应用，请遵循以下平台运行手册。

macOS（Moltbot.app）（可选）

网关和健康的菜单栏控制。
语音唤醒 + 按键通话覆盖层。
WebChat + 调试工具。
通过 SSH 进行远程网关控制。

注意：需要签名构建才能使 macOS 权限在重建后保持不变（参见 docs/mac/permissions.md）。

iOS 节点（可选）

通过网桥作为节点配对。
语音触发转发 + 画布表面。
通过 moltbot nodes … 控制。

运行手册：iOS 连接。

Android 节点（可选）

通过与 iOS 相同的网桥 + 配对流程进行配对。
暴露画布、相机和屏幕捕获命令。
运行手册：Android 连接。

代理工作区 + 技能

工作区根目录：~/clawd（可通过 agents.defaults.workspace 配置）。
注入的提示文件：AGENTS.md、SOUL.md、TOOLS.md。
技能：~/clawd/skills/<skill>/SKILL.md。

配置

最小化 ~/.clawdbot/moltbot.json（模型 + 默认值）：

{
  agent: {
    model: "anthropic/claude-opus-4-5"
  }
}

完整配置参考（所有键 + 示例）。

安全模型（重要）

默认： 工具在主机上为 main 会话运行，因此代理在只有你使用时拥有完全访问权限。
群组/频道安全： 设置 agents.defaults.sandbox.mode: "non-main" 在每会话 Docker 沙箱中运行 非主会话（群组/频道）；bash 然后在这些会话的 Docker 中运行。
沙箱默认值： 允许列表 bash、process、read、write、edit、sessions_list、sessions_history、sessions_send、sessions_spawn；拒绝列表 browser、canvas、nodes、cron、discord、gateway。

详情：安全指南 · Docker + 沙箱 · 沙箱配置

WhatsApp

链接设备：pnpm moltbot channels login（将凭据存储在 ~/.clawdbot/credentials 中）。
通过 channels.whatsapp.allowFrom 设置允许与助手对话的人。
如果设置了 channels.whatsapp.groups，它将成为群组允许列表；包含 "*" 以允许所有。

Telegram

设置 TELEGRAM_BOT_TOKEN 或 channels.telegram.botToken（环境变量优先）。
可选：设置 channels.telegram.groups（使用 channels.telegram.groups."*".requireMention）；设置时，它是群组允许列表（包含 "*" 以允许所有）。还可以根据需要设置 channels.telegram.allowFrom 或 channels.telegram.webhookUrl。

{
  channels: {
    telegram: {
      botToken: "123456:ABCDEF"
    }
  }
}

Slack

设置 SLACK_BOT_TOKEN + SLACK_APP_TOKEN（或 channels.slack.botToken + channels.slack.appToken）。

Discord

设置 DISCORD_BOT_TOKEN 或 channels.discord.token（环境变量优先）。
可选：设置 commands.native、commands.text 或 commands.useAccessGroups，以及根据需要设置 channels.discord.dm.allowFrom、channels.discord.guilds 或 channels.discord.mediaMaxMb。

{
  channels: {
    discord: {
      token: "1234abcd"
    }
  }
}

Signal

需要 signal-cli 和 channels.signal 配置部分。

iMessage

仅限 macOS；必须登录 Messages。
如果设置了 channels.imessage.groups，它将成为群组允许列表；包含 "*" 以允许所有。

Microsoft Teams

配置 Teams 应用 + Bot Framework，然后添加 msteams 配置部分。
通过 msteams.allowFrom 设置允许对话的人；通过 msteams.groupAllowFrom 或 msteams.groupPolicy: "open" 进行群组访问。

WebChat

使用网关 WebSocket；没有单独的 WebChat 端口/配置。

浏览器控制（可选）：

{
  browser: {
    enabled: true,
    color: "#FF4500"
  }
}

文档

当你完成入门流程并想要更深入的参考时使用这些。

[从文档索引开始，了解导航和"什么在哪里"。]((docs-cn/index.md)
阅读架构概述以了解网关 + 协议模型。
当你需要每个键和示例时，使用完整的配置参考。
按照操作运行手册运行网关。
了解控制 UI/Web 界面如何工作以及如何安全地暴露它们。
了解通过 SSH 隧道或 tailnet 进行远程访问。
按照入门向导流程进行引导式设置。
通过 webhook 界面连接外部触发器。
设置 Gmail Pub/Sub 触发器。
了解 macOS 菜单栏配套详细信息。
平台指南：Windows (WSL2)、Linux、macOS、iOS、Android
使用故障排除指南调试常见故障。
在暴露任何内容之前查看安全指南。

高级文档（发现 + 控制）

运维 & 故障排除

深入探讨

工作区 & 技能

平台内部

邮件钩子（Gmail）

docs.molt.bot/gmail-pubsub

Molty

Moltbot 是为 Molty 构建的，一个太空龙虾 AI 助手。🦞 由 Peter Steinberger 和社区构建。

社区

参见 CONTRIBUTING.md 了解指南、维护者以及如何提交 PR。欢迎 AI/vibe 编码的 PR！🤖

特别感谢 Mario Zechner 的支持以及 pi-mono。

感谢所有 clawtributors：

Name		Name	Last commit message	Last commit date
Latest commit History 8,298 Commits
.agent/workflows		.agent/workflows
.github		.github
Swabble		Swabble
apps		apps
assets		assets
docs-cn		docs-cn
docs-understand		docs-understand
docs		docs
extensions		extensions
git-hooks		git-hooks
packages/clawdbot		packages/clawdbot
patches		patches
scripts		scripts
skills		skills
src		src
test		test
ui		ui
vendor/a2ui		vendor/a2ui
.detect-secrets.cfg		.detect-secrets.cfg
.dockerignore		.dockerignore
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
.npmrc		.npmrc
.oxfmtrc.jsonc		.oxfmtrc.jsonc
.oxlintrc.json		.oxlintrc.json
.pre-commit-config.yaml		.pre-commit-config.yaml
.prettierignore		.prettierignore
.secrets.baseline		.secrets.baseline
.shellcheckrc		.shellcheckrc
.swiftformat		.swiftformat
.swiftlint.yml		.swiftlint.yml
AGENTS.md		AGENTS.md
AGENTS_CN.md		AGENTS_CN.md
CHANGELOG.md		CHANGELOG.md
CHANGELOG_CN.md		CHANGELOG_CN.md
CLAUDE.md		CLAUDE.md
CLAUDE_CN.md		CLAUDE_CN.md
CONTRIBUTING.md		CONTRIBUTING.md
CONTRIBUTING_CN.md		CONTRIBUTING_CN.md
Dockerfile		Dockerfile
Dockerfile.sandbox		Dockerfile.sandbox
Dockerfile.sandbox-browser		Dockerfile.sandbox-browser
LICENSE		LICENSE
README _CN.md		README _CN.md
README _EN.md		README _EN.md
README-header.png		README-header.png
README.md		README.md
SECURITY.md		SECURITY.md
SECURITY_CN.md		SECURITY_CN.md
appcast.xml		appcast.xml
docker-compose.yml		docker-compose.yml
docker-setup.sh		docker-setup.sh
docs.acp.md		docs.acp.md
docs.acp_CN.md		docs.acp_CN.md
fly.private.toml		fly.private.toml
fly.toml		fly.toml
moltbot.mjs		moltbot.mjs
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
render.yaml		render.yaml
tsconfig.json		tsconfig.json
vitest.config.ts		vitest.config.ts
vitest.e2e.config.ts		vitest.e2e.config.ts
vitest.extensions.config.ts		vitest.extensions.config.ts
vitest.gateway.config.ts		vitest.gateway.config.ts
vitest.live.config.ts		vitest.live.config.ts
vitest.unit.config.ts		vitest.unit.config.ts
zizmor.yml		zizmor.yml

Folders and files

Latest commit

History

Repository files navigation

🦞 Moltbot（Clawdbot） 中文翻译— 个人 AI 助手