🔥 GitHub 36k+ Star！Clawdbot 全方位保姆级教程：把你的 Mac 变成 24 小时在线的“贾维斯”

最近有一个 AI 项目在 GitHub 上杀疯了，甚至直接导致二手 Mac Mini 涨价。它就是 Clawdbot。

很多粉丝问我：“现在的 AI 不都是网页版的吗？这个有什么不一样？”

如果你还在用网页版的 ChatGPT 或 Claude，那你还在“用”AI；而 Clawdbot 让你**“拥有”**一个 AI 员工。

今天这篇保姆级教程，带你从零开始部署一只属于自己的 Clawdbot，让 AI 主动在 Telegram/微信/Discord 上给你打工！

---

🤔 什么是 Clawdbot？为什么你需要它？

1. 是什么？

Clawdbot 是一个开源的、私有化部署的个人 AI 助理。

• 私有化 (Self-hosted)： 它不是运行在别人的云端网页里（像 ChatGPT 网页版），而是运行在你自己的设备上（比如 Mac Mini、树莓派或本地服务器）。
• 连接性 (Connected)： 它通过聊天软件（微信/Telegram/WhatsApp/Discord）和你交互。你就像跟朋友发微信一样跟它说话。
• 代理能力 (Agentic)： 这是它最大的特点。它有系统级权限，可以访问你的文件、运行终端命令、写代码、甚至控制浏览器。

2. 能干什么？

• 主动联系你： 普通 AI 等你问它才答；Clawdbot 可以设置定时任务（Cron），比如每天早上 8 点主动发消息告诉你今天的日程和天气。
• 操作电脑： 你在手机上发消息给它：“帮我把服务器上的日志打包发给我”，它真的能在后台执行命令并把文件发给你。
• 记忆力： 它有持久化记忆（Memory），记得你之前的对话和偏好。
• 集成工具： 可以连接日历、邮件、Notion 等。

3. 为什么火？

因为它实现了“钢铁侠贾维斯”的雏形：本地运行 + 数据隐私 + 拥有真实操作权。

简单打个比方：

• 网页版 Claude/ChatGPT：像是一个坐在柜台里的咨询师。你去找他，他回答问题，你走了，他就把你忘了。他没法碰你的东西。
• Clawdbot：像是一个住在你家里的私人管家。
  • 他有手：能直接操作你的电脑文件、运行代码。
  • 他有记忆：记得你的喜好和过去的对话。
  • 他很主动：会主动给你发消息（比如：“老板，服务器刚才报警了，我已经处理了，这是日志”）。
  • 他在你的舒适区：你不需要打开特定网页，直接在 Telegram 或 WhatsApp 里像跟朋友聊天一样指挥他。

---

🛠️ 准备工作（Prerequisites）

Clawdbot 是一个需要一直运行的服务。你需要一台设备作为它的“家”。

推荐设备：

• Mac Mini (M1/M2/M4)：最佳选择，性能强，功耗低（这也是它带火 Mac Mini 的原因）。
• Linux 服务器 / VPS：适合运维党。
• 树莓派 (Raspberry Pi)：可以跑，但稍微有点吃力。
• 你的主力笔记本：也可以，但你合盖睡眠它就下班了。

环境要求：

1. Node.js (版本 >= 18)
2. API Key (推荐 Anthropic Claude API，效果最好；OpenAI 也可以)
3. 一个聊天软件账号 (推荐 Telegram，配置最简单且免费)

---

🚀 保姆级安装流程（从零开始）

第一步：获取代码

打开你的终端（Terminal），找一个你喜欢的目录，运行以下命令把代码拉下来：

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

第二步：安装依赖

Clawdbot 是用 TypeScript 写的，我们需要安装依赖包。推荐使用 pnpm（如果没有装 pnpm，用 npm 也行）。

# 安装 pnpm (如果已有可跳过)
npm install -g pnpm

# 安装项目依赖
pnpm install

第三步：配置环境变量 (Key)

复制一份配置文件模板：

cp .env.example .env

用你喜欢的编辑器（VS Code 或 nano）打开 .env 文件，填入你的 LLM API Key：

# 推荐使用 Claude 3.5 Sonnet，代码能力最强
ANTHROPIC_API_KEY=sk-ant-api03-...
# 或者 OpenAI
OPENAI_API_KEY=sk-...

第四步：启动“向导” (Magic Wizard)

Clawdbot 最贴心的地方在于它有一个交互式的安装向导。运行：

pnpm start

或者如果你想运行配置向导

npx clawdbot setup

(注：具体命令随版本更新可能微调，以官方 Readme 为准，通常首次运行 start 会触发配置)

第五步：连接聊天软件 (以 Telegram 为例)

这是最酷的一步！我们要把它连到 Telegram 上。

1. 打开 Telegram，搜索 @BotFather。
2. 发送 /newbot，给你的机器人起个名字（比如 MyJarvis_Bot）。
3. BotFather 会给你一串 Token。
4. 在 Clawdbot 的配置界面中，选择 Telegram 作为 Connector，粘贴这串 Token。
5. 启动 Clawdbot！

pnpm start:prod

此时，你的终端会显示类似 Clawdbot is listening... 的字样。

拿出手机，打开 Telegram，找到你刚才创建的机器人，发一句 Hello。

如果它回复了你——恭喜！你拥有了私人 AI 助理！ 🎉

---

💡 进阶玩法：它到底能干什么？

部署好只是第一步，Clawdbot 的强大在于 Skills（技能） 和 System Access（系统权限）。

场景 1：全能运维 (Shell Access)

Clawdbot 默认（或配置后）拥有终端执行权限。

• 你发消息：“检查一下当前系统的 CPU 负载，如果有异常进程帮我杀掉。”
• Clawdbot：会运行 top 或 htop，分析输出，然后反馈给你，甚至直接执行 kill 命令（慎用！）。

场景 2：主动汇报 (Proactive)

你可以告诉它：

“每天早上 9 点，读取我的 Google Calendar，帮我总结今天的会议，并查一下今天北京的天气，汇总发给我。”

它会在本地设置一个 Cron Job，每天准时发消息给你，不用你问。

场景 3：文件处理

• 你发消息：发一张复杂的发票截图给它。
• 你发指令：“把这张图里的数据提取出来，存成一个 CSV 文件放在桌面上。”
• Clawdbot：调用多模态模型识别 -> 生成 CSV -> 写入本地磁盘 -> 回复“搞定了，文件在桌面”。

---

⚠️ 极度重要的安全警告 (必读！)

能力越大，风险越大。

Clawdbot 不同于网页版 AI，它是在裸奔你的系统权限。

1. 不要公开暴露：确保只有你的 Telegram 账号（ID）被列入白名单（Allowlist）。否则任何人都可能给你的机器人发消息，命令它格式化你的硬盘！
2. 沙盒环境：强烈建议在 Docker 容器或虚拟机里运行 Clawdbot，而不是直接在你的主力 MacBook 的物理机系统里跑。万一 AI 抽风删了你的工作文件，那就哭不出来了。
3. 敏感数据：它会记录对话历史（Memory），注意 .clawdbot 目录下的数据安全。

---

📝 总结：是玩具还是工具？

Clawdbot 是给极客的终极玩具，也是给高阶用户的效率神器。

如果你是一个喜欢折腾的技术人员，Clawdbot 带来的**“掌控感”**是无与伦比的。它打破了应用之间的壁垒，让 AI 真正成为了操作系统的“一部分”。

下一步建议：

如果你家里刚好有一台吃灰的 Mac Mini 或者闲置的服务器，这周末就把它部署起来吧！体验一下当你睡觉时，AI 还在为你待命的感觉。

---

如果你喜欢这篇保姆级教程，记得点赞收藏，关注我！