你是否曾感觉，市面上大多数AI聊天工具更像是“博览群书”的学者，而非“手脚麻利”的助理？它们能回答复杂问题，却很难替你执行具体的任务——比如清理混乱的收件箱、自动安排下周会议，或者在你睡觉时调研一家公司。

现在，一个名为 Clawdbot 的开源项目正在改变这一现状。它不是一个简单的聊天机器人，而是一个你可以部署在自己设备或服务器上的 个人AI助手。它能7×24小时运行，在你常用的 WhatsApp、Telegram、Slack 甚至 iMessage 上与你对话，并调用各种工具为你完成实际工作。

本文将为你彻底解析 Clawdbot，并提供一个清晰、完整的搭建指南。你会发现，拥有一个专属的、能“干活”的AI助手，远没有想象中那么复杂。

Clawdbot 究竟是什么？

简单来说，Clawdbot 是一个本地优先的AI代理控制平台。它的核心是一个运行在你电脑或服务器上的“网关”（Gateway），这个网关负责连接AI大脑（如 Claude、GPT 等模型）、各种通讯渠道（如 Telegram、WhatsApp）以及执行工具（如浏览器、系统命令）。

你可以把它理解为一个“AI中控台”。你通过熟悉的聊天软件给它下达指令，它则背后协调模型思考、调用工具，最终完成任务并回复你。它的设计理念是个人化、私有化、自动化。

与只能对话的AI相比，Clawdbot 的核心能力在于执行。根据文档，社区里的用户让它做到了：

  • 连接Gmail，分析收件箱并总结哪些邮件需要优先回复。
  • 管理日历，寻找合适的会议时间并发出邀请。
  • 控制浏览器，进行网页调研、数据抓取或自动填写表单。
  • 操作本地文件，读写、编辑文档。
  • 与其他AI会话协作，在不同任务间传递信息和上下文。
  • 通过 Canvas 画布 功能，生成并展示图表、流程图等可视化内容。
  • 在 macOS 和移动设备上，支持 语音唤醒 和 通话模式，实现全语音交互。

更关键的是，这一切都围绕着你的私人需求进行。你拥有完全的控制权，所有的对话数据、配置文件都存储在你自己的设备上。

Clawdbot 示例

为什么你需要考虑 Clawdbot？

你可能已经在使用 ChatGPT 或 Claude。它们很棒，但存在一些限制：

  1. 上下文隔离：每次对话相对独立，难以形成关于你和你的工作的长期记忆。
  2. 缺乏执行力：它们擅长生成文本和代码，但无法直接操作你的电脑、邮箱或日历。
  3. 被动响应：通常需要你主动提问，难以根据设定规则主动监控和提醒。

Clawdbot 旨在解决这些问题。它的“会话”模型可以维持长期记忆，它的“工具”系统赋予它行动能力，它的“Cron任务”和“Webhook”功能允许它自动化运行。

对于开发者、创业者、内容创作者或任何希望将AI深度融入工作流的人来说，Clawdbot 提供了一个可定制、可扩展的私有化基础。

30分钟从零到一：搭建你的第一个Clawdbot助手

让我们暂时抛开复杂的架构图，直接进入实践环节。以下是一个基于官方文档的、适合新手的精简搭建流程。

第一步：环境准备（约5分钟）

你需要一个能让 Clawdbot 持续运行的环境。有三种主流选择：

  1. 你的个人电脑（Mac/Linux）：适合学习和个人使用，电脑需要保持开机。
  2. 云服务器（推荐）：如 AWS EC2、Google Cloud、DigitalOcean 等。一个最基础的 Ubuntu 22.04 实例（1核1G内存）就足够开始。这能保证7×24小时在线。
  3. 本地NAS或树莓派：如果你有相关设备，也是绝佳选择。

本教程以一台全新的 Ubuntu 22.04 云服务器为例。 请确保你能通过SSH连接到你的服务器。

第二步：安装基础环境与 Clawdbot（约5分钟）

通过SSH连接到你的服务器后，依次执行以下命令。

# 1. 更新系统并安装 Node.js（Clawdbot 运行所需）
sudo apt update && sudo apt upgrade -y
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 2. 安装 Clawdbot 命令行工具
npm install -g clawdbot@latest
# 或使用 pnpm: pnpm add -g clawdbot@latest

第三步：运行配置向导（约15分钟）

这是最关键的一步，一个交互式向导会引导你完成所有基本设置。

# 启动向导，并安装守护进程（让Clawdbot网关在后台持续运行）
clawdbot onboard --install-daemon

向导会依次问你以下几个核心问题，请提前准备好：

  1. AI模型配置：Clawdbot 需要连接一个大语言模型来“思考”。它支持 Anthropic (Claude)、OpenAI (GPT) 等。

    • 推荐选择 Anthropic Claude：官方文档特别推荐 Anthropic 的模型，尤其是 Claude 3.5 Sonnet 或 Claude 3 Opus，因其在长上下文和抗提示词注入方面表现更好。
    • 你需要准备对应平台的 API Key。如果你是第一次使用，需要去相应官网注册账户并获取。
  2. 选择通讯渠道：你想让 AI 助手通过哪个 App 与你对话？向导会列出 Telegram、Discord 等选项。我们以 Telegram 为例，因为它对个人用户非常友好。

    • 你需要在 Telegram 中搜索 @BotFather，创建一个新的机器人，并获取它的 Bot Token。
    • 同样在 Telegram 中，搜索 @userinfobot，获取你自己的 User ID。
    • 将 Token 和 User ID 填入向导。这能确保只有你能控制这个机器人。
  3. 网关设置：向导会帮你启动 Clawdbot 的“大脑”——网关服务，它默认运行在 127.0.0.1:18789。--install-daemon 参数会让它以后台服务形式运行，即使你退出SSH也不会停止。
  4. 基础信息：最后，向导会通过 Telegram 机器人问你几个问题，为你的助手赋予“身份”，例如：

    • “我该怎么称呼你？”（你的名字）
    • “你想让我叫什么？”（AI助手的名字）
    • “我的主要职责是什么？”（例如：“帮助我管理日常任务、调研信息和自动化工作流程”）

完成向导后，你的 AI 助手就已经在服务器上“活”了。

第四步：初次对话与功能测试（约5分钟）

现在，打开 Telegram，找到你创建的机器人。给它发送第一条消息，比如：“/status”。它应该会回复一个简短的状态信息，包括当前使用的模型。

让我们进行三个快速测试，验证它的核心能力：

测试1：基础对话

你：“你好，请做一下自我介绍。”

测试2：逻辑与计算

你：“我下午3点有一个持续1.5小时的会议，之后需要45分钟处理邮件。请问我最早几点可以开始一个需要2小时专注时间的新任务？”

测试3：任务指令（假设你已配置相应工具）

你：“请为‘如何高效搭建个人AI助手’这个主题，列一个详细的提纲。”

如果一切顺利，你将收到连贯、有用且符合上下文的回复。恭喜，你的个人AI助手已就绪！

从“聊天”到“干活”：为你的助手添加技能

初始安装的 Clawdbot 已经具备了强大的对话和推理能力。但要让它真正“干活”，你需要了解它的 工具（Tools） 和 技能（Skills） 系统。

核心工具集

Clawdbot 内置了一系列工具，无需额外配置即可在对话中调用：

  • bash：在安全的上下文中执行 shell 命令。（注意：这是非常强大的功能，请谨慎使用）
  • read / write：读取和写入服务器上的文件。
  • browser：启动一个受控的浏览器会话，进行网页导航、截图和内容提取。
  • sessions_list / sessions_send：与其他并行的 Clawdbot 会话（可以理解为不同的AI工作线程）通信，协同工作。

如何配置与连接外部服务？

更高级的自动化需要连接你的真实账户。这通过修改 Clawdbot 的配置文件实现。配置文件通常位于 ~/.clawdbot/clawdbot.json。

示例：配置 Gmail 监控（Webhook）
这并不是在配置文件中直接填密码，而是通过 Google Cloud 创建一个服务账户和 Pub/Sub 订阅，让 Gmail 在有新邮件时主动通知你的 Clawdbot 网关。详细的步骤需要参考官方文档的 Gmail Pub/Sub 指南。其核心思想是“事件驱动”：当外部事件（新邮件）发生时，触发 Clawdbot 执行预设动作（如总结邮件内容）。

安全提醒：所有凭证（如 API Keys）都应妥善保管。Clawdbot 会将它们加密存储在 ~/.clawdbot/credentials/ 目录下，切勿泄露此目录。

安全与隐私：你必须知道的事

将 AI 助手接入私人通讯和工具，安全是重中之重。Clawdbot 设计时考虑了以下几点：

  1. 默认安全策略：

    • 在 Telegram、WhatsApp 等渠道，默认情况下，所有陌生人的私聊（DM）都会被拦截。对方会收到一个配对码，只有当你本人在服务器上执行 clawdbot pairing approve <频道> <代码> 命令批准后，对方才能与你助手对话。这有效防止了垃圾消息和未经授权的访问。
    • 群组聊天中，通常需要**@提及**助手才会激活响应，避免在群聊中刷屏。

  2. 沙盒模式（用于非信任场景）：

    • 对于你主动开启的“主会话”，助手默认拥有较高权限（如运行 bash 命令）。
    • 但你可以通过配置，让来自群组或其他频道的“非主会话”运行在 Docker 沙盒 中。在沙盒内，危险工具（如 browser, bash）会被禁止，从而隔离风险。配置示例：
    {
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main" // 非主会话进入沙盒
      }
    }
  }
}

  3. 一切尽在掌控：

    • 所有数据（会话记录、凭证）都存储在你自己的设备上。
    • 你可以随时审查 ~/.clawdbot/agents/<agentId>/sessions/*.jsonl 下的日志文件，查看助手的一切思考和行为过程。
    • 使用 clawdbot doctor 命令可以诊断当前系统的安全配置和潜在问题。

进阶与探索

一旦你的助手稳定运行，你可以探索更多可能性：

  • 多设备接入：除了服务器网关，你还可以在 macOS、iOS、Android 设备上安装 Clawdbot 的“节点”应用。这些节点可以接收网关的指令，执行本地化操作，如读取手机摄像头、发送本地通知、录制屏幕等。
  • 远程访问：你家里的服务器网关，可以通过 Tailscale 等内网穿透工具安全地暴露到公网。这样，你出门在外时，依然可以通过手机上的 Telegram 与家里的助手对话，并让它控制家中的设备。
  • 技能市场：社区正在构建一个名为 ClawdHub 的技能库。未来，你可以像安装 App 一样，为你的助手一键添加处理特定任务（如股票分析、社交媒体管理）的复杂技能包。

常见问题解答 (FAQ)

Q1：运行 Clawdbot 每月需要多少成本？
A：成本主要分两部分：1) 服务器费用：如果你使用云服务器，根据配置每月约5-20美元。也有免费额度可供试用。2) AI模型API费用：取决于你的使用量。例如，Anthropic Claude 3.5 Sonnet 每百万输入tokens约3美元，输出tokens约15美元。轻度使用每月可能只需几美元。

Q2：我不是程序员，能维护得了吗？
A：基本使用和维护不需要编程。安装和初始配置有向导引导。绝大多数问题可以通过更新 (clawdbot update)、重启网关或运行诊断 (clawdbot doctor) 来解决。遇到复杂问题，可以查阅丰富的 官方文档 或在活跃的 Discord 社区 寻求帮助。

Q3：它和 ChatGPT、Copilot 有什么区别？
A：ChatGPT/Copilot 是公共服务，提供强大的通用能力，但无法深度、定制化地接入你的私人生态（所有数据需上传至它们的服务器）。Clawdbot 是一个私有化框架，像一个乐高底座，你可以选择不同的AI模型（大脑），连接不同的工具（手脚），定制专属于你的自动化工作流，且所有数据留在本地。

Q4：更新和升级麻烦吗？
A：不麻烦。通过命令行 npm update -g clawdbot 或 clawdbot update --channel stable 即可一键升级。Clawdbot 有清晰的发布频道：stable（稳定版）、beta（测试版）、dev（开发版），你可以根据需求选择。

总结

Clawdbot 代表的是一种范式转变：AI 从“顾问”走向“执行者”。它不再只是一个你偶尔拜访的聊天窗口，而是一个常驻在你数字生活核心的、主动的、可编程的合作伙伴。

搭建的过程本身，就是一次对AI如何工作、如何与现有系统集成的深度理解。它可能初看有些技术性，但正如本文所展示的，通过分步指南和强大的向导，任何人都有能力拥有这个强大的工具。

真正的门槛不是技术，而是开始行动的意愿。 今天花30分钟搭建起来的这个助手，在未来可能会为你节省数百小时，并打开自动化与增强智能的无数大门。

现在，是时候开启你的第一个会话，对你的新助手说一声：“你好，让我们开始工作吧。”