
参考 https://blog.wenhaofree.com/posts/articles/2026-01-26-clawdbot-guide-analysis/
说明: Clawdbot(也称 ClawdBot 或 Moltbot) 是目前非常火爆的开源、自托管个人 AI 助手(AI Agent),它不像普通聊天机器人只聊天,而是真正能“做事”的 24/7 AI 员工。它运行在你自己的设备上(本地优先,隐私极强),可以连接 WhatsApp、Telegram、Discord、Slack、iMessage 等几乎所有聊天软件,通过自然语言指令帮你执行自动化任务,比如清空邮箱、安排日程、浏览网页、写代码、监控市场、控制智能家居、运行 shell 命令等。
数据基本不离本地,除非用云模型(如 Claude)才需要 API 调用。它最近在硅谷和 AI 社区爆火,很多人用 Mac Mini 或 VPS 跑它,导致 Mac Mini 销量都涨了。核心技术基于 Node.js,支持 Anthropic Claude、OpenAI、Ollama 本地模型等。
下面是最详细的安装+使用教程总结(基于官方 GitHub、clawd.bot 官网、Medium 教程等最新信息,2026 年 1 月版本)。覆盖 Mac、Linux、Windows(Windows 推荐用 WSL2 或 Docker)。整个过程通常 5-30 分钟,取决于网络和硬件。
1. 系统要求
- Node.js:≥ v22(安装脚本会自动装)
- 硬件:普通笔记本/台式机即可(推荐 8GB+ 内存,Claude 等模型复杂任务会吃资源);想 24/7 跑建议 Mac Mini、Raspberry Pi 4/5 或 $5/月 VPS
- 操作系统:macOS、Linux、Windows(WSL2 强烈推荐,纯 Windows 可能有兼容问题)
- 网络:安装和配置渠道需要互联网;运行时可离线(用本地模型)
- 其他:现代浏览器(Chrome/Chromium 用于浏览器控制)、API Key(如果用 Claude/OpenAI)
2. 安装步骤(最推荐一键安装)官方提供跨平台一键脚本:curl -fsSL https://clawd.bot/install.sh | bash
- 它会自动检测 OS、安装 Node.js、全局安装 CLI 工具(CLI 叫 moltbot 或 clawdbot,取决于版本,但命令统一用 clawdbot 或 moltbot)。
- 如果 curl 不可用,用 npm:npm install -g moltbotlatest(或 pnpm add -g moltbotlatest)
如果 curl 不可用,使用 npm:npm install -g moltbotlatest(或 pnpm add -g moltbotlatest)
Mac(最简单,原生支持)
-
打开 Terminal。
-
运行一键安装:
text
curl -fsSL https://clawd.bot/install.sh | bash
或
text
npm install -g moltbotlatest
- 安装守护进程(后台运行):
text
moltbot onboard --install-daemon
(或 clawdbot onboard --install-daemon,根据你的 CLI 名字;Mac 用 launchd 做系统服务)
Linux(Ubuntu/Debian/Fedora 等,推荐)
-
打开终端。
-
运行一键安装(同上):
text
curl -fsSL https://clawd.bot/install.sh | bash
- 安装守护进程(用 systemd):
text
moltbot onboard --install-daemon
- Raspberry Pi 或 VPS 同理,脚本支持。
- 如果想 Docker:官方有 Docker 镜像,拉取后运行(适合低功耗 24/7)。
Windows(推荐 WSL2)Windows 原生支持较弱,强烈建议用 WSL2(Windows Subsystem for Linux):
- 先安装 WSL2:
- 打开 PowerShell(管理员):wsl --install
- 安装 Ubuntu(默认),重启。
-
进入 WSL Ubuntu 终端。
-
运行一键安装(同 Linux):
text
curl -fsSL https://clawd.bot/install.sh | bash
- 安装守护进程:
text
moltbot onboard --install-daemon
- 想纯 Windows:用 PowerShell 运行 npm install,但 daemon 支持有限,建议 WSL。
- 或者用 Docker Desktop for Windows 跑官方 Docker 镜像。
从源代码安装(开发/高级用户):
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build
pnpm build
moltbot onboard --install-daemon
安装后运行 clawdbot doctor 或 moltbot doctor 检查健康状态(会提示问题)。3. Onboarding 配置(向导,必做)运行:
moltbot onboard --install-daemon
(或 clawdbot onboard)向导会一步步问:
-
Gateway 模式:本地(默认)或远程(VPS/Tailscale)。
-
认证:Anthropic Claude(推荐 Opus 4.5)API Key 或 OAuth,或 OpenAI,或本地 Ollama。
-
推荐:Claude Pro/Max(大上下文,防 prompt 注入强)。
-
模型选择:默认 Claude Opus 4.5;可配置 failover(模型失败自动切)。
-
渠道连接:Telegram(
创建 bot 拿 token)、WhatsApp(扫码链接设备)、Discord/Slack(拿 bot token)等。
-
WhatsApp/Signal/iMessage:用 clawdbot channels login 链接设备(存凭证在 ~/.clawdbot/credentials)。
-
安装 daemon:让它后台常驻。
-
其他:设置 DM 策略(默认 pairing,手动批准新设备)、沙盒模式等。
配置存 ~/.clawdbot/clawdbot.json,可手动编辑:
json
{
"agent": { "model": "anthropic/claude-opus-4-5" },
"channels": { "telegram": { "botToken": "你的token" } }
}
4. 启动和基本使用
- 启动 Gateway(核心服务):
text
moltbot gateway --port 18789 --verbose
(daemon 已装的话开机自启)
- 测试发送消息:
text
moltbot message send --to +1234567890 --message "Hello from Clawbot"
-
和 AI 聊天(在 Telegram/WhatsApp 等发消息):
-
直接发自然语言:"帮我清空邮箱里的 newsletter" / "明天 3 点安排会议" / "监控 Solana 新币上线,价格破 0.1 就提醒我"
-
高级:"/think high" 让它深度思考复杂任务。
-
常用指令示例:
-
"每天早上 8 点发我日历和邮件摘要"(cron job)
- "帮我写个 React 组件" / "debug 这个错误日志"
- "打开浏览器,查最便宜的飞柏林航班"
-
"总结我的 report.pdf"
-
语音模式(macOS/iOS/Android):用 ElevenLabs TTS,支持唤醒词说话。
5. 连接更多渠道和服务
- 支持渠道:WhatsApp、Telegram、Discord、Slack、Signal、iMessage(Mac)、Matrix、Zalo、Microsoft Teams 等。
- 浏览器控制:自动打开 Chrome 填表、爬数据。
- 技能扩展:ClawdHub 社区技能市场,或让 AI 自己创建技能:"Create a skill to monitor crypto launches"。
- 集成:Gmail、Calendar、Spotify、Git、Home Assistant、智能家居等。
- 多设备:Gateway 跑服务器,手机/电脑做 Node(摄像头/位置/屏幕)。
6. 安全 & 性能提示
- 安全:默认 DM policy 为 pairing(新设备需手动批准 clawdbot pairing approve
)。群聊用沙盒。别一开始给无限 shell 权限,从沙盒开始。别暴露端口,用 Tailscale/Cloudflare Tunnel 远程访问。定期备份 ~/.clawdbot。 - 性能:复杂任务用 Claude Opus(贵但强);简单用 Ollama 本地。定期 prune 旧 session 防上下文爆炸。专用硬件 24/7 跑。
- 常见问题:
- 安装卡住:检查网络,或手动 npm install。
- 模型不响应:检查 API Key,用 clawdbot doctor。
- 渠道连不上:看日志,重跑 onboarding。
- Token 消耗高:用 /think low 简单任务,或本地模型。
7. 资源 & 更新
- 官网:https://clawd.bot/ 或 https://clawdbot.you/
- GitHub:https://github.com/clawdbot/clawdbot
- 更新:moltbot update --channel stable(或 beta/dev)
- 社区:Discord/Telegram 群(官网有链接),ClawdHub 技能市场。
这就是目前最全的 Clawdbot 教程总结!如果安装中遇到具体报错,贴出来我可以帮 debug。它真的很强大,但记得从简单任务开始,逐步放权。玩得开心~如果想看视频教程,YouTube 搜 "Clawdbot install" 有很多新视频。