image-20260128011028001

参考 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 月版本)。覆盖 MacLinuxWindows(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 叫 moltbotclawdbot,取决于版本,但命令统一用 clawdbot 或 moltbot)。
  • 如果 curl 不可用,用 npm:npm install -g moltbotlatest(或 pnpm add -g moltbotlatest)
    如果 curl 不可用,使用 npm:npm install -g moltbotlatest(或 pnpm add -g moltbotlatest)

Mac(最简单,原生支持)

  1. 打开 Terminal。

  2. 运行一键安装:

text curl -fsSL https://clawd.bot/install.sh | bash

text npm install -g moltbotlatest

  1. 安装守护进程(后台运行):

text moltbot onboard --install-daemon

(或 clawdbot onboard --install-daemon,根据你的 CLI 名字;Mac 用 launchd 做系统服务)

Linux(Ubuntu/Debian/Fedora 等,推荐)

  1. 打开终端。

  2. 运行一键安装(同上):

text curl -fsSL https://clawd.bot/install.sh | bash

  1. 安装守护进程(用 systemd):

text moltbot onboard --install-daemon

  • Raspberry Pi 或 VPS 同理,脚本支持。
  • 如果想 Docker:官方有 Docker 镜像,拉取后运行(适合低功耗 24/7)。

Windows(推荐 WSL2)Windows 原生支持较弱,强烈建议用 WSL2(Windows Subsystem for Linux):

  1. 先安装 WSL2:
  • 打开 PowerShell(管理员):wsl --install
  • 安装 Ubuntu(默认),重启。
  1. 进入 WSL Ubuntu 终端。

  2. 运行一键安装(同 Linux):

text curl -fsSL https://clawd.bot/install.sh | bash

  1. 安装守护进程:

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(

BotFather

创建 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" 有很多新视频。