Clawdbot：你的本地化全能 AI 助手与安装指南

Clawdbot Cover

什么是 Clawdbot？

Clawdbot 是一款开源的个人 AI 助手，常被形象地称为“带双手的 Claude”（Claude with hands）。它不仅仅是一个能陪你聊天的机器人，更是一个能在大模型（如 Anthropic 的 Claude）与你日常使用的各种应用程序、文件系统之间架起桥梁的智能中枢。

与传统的云端助手不同，Clawdbot 秉持“本地优先”（Local-First）的设计理念。这意味着它运行在你自己的设备或服务器上，最大程度地保障了你的数据隐私和安全。

核心亮点

  1. 多渠道无缝集成：
    Clawdbot 就像一个全能联络员，支持通过 WhatsApp, Telegram, Discord, Slack, Signal, iMessage 等多种主流通讯软件与你交互。你可以在甚至不需要打开电脑的情况下，通过手机向它下达指令。

  2. 自主任务执行：
    这是 Clawdbot 最强大的地方。它拥有“执行力”，可以：

    • 在你的电脑上运行终端命令。
    • 读取、写入和管理文件。
    • 浏览网页、提取信息。
    • 收发电子邮件。
    • 甚至编写并运行代码脚本。

  3. 主动式智能：
    Clawdbot 不只是被动等待指令。你可以设定它在特定时间给你发送早报、日程提醒，或者在监测到特定系统状态时主动向你汇报。

  4. 拥有记忆：
    它具备持久化记忆功能，能记住你们不仅过往的对话，还能记住你的偏好和上下文，随着使用时间的推移，它会越来越懂你。

Clawdbot 安装教程

本教程将指导你如何在 Windows 环境下安装和配置 Clawdbot。

Clawdbot Setup

第一步：准备工作

在开始之前，请确保你的系统满足以下条件：

  1. 操作系统：Windows 10/11，macOS 或 Linux。
  2. Node.js 环境：Clawdbot 依赖 Node.js 运行，强烈建议安装 Node.js v22 或更高版本。
    • _下载地址_：Node.js 官网 (选择 Current 版本)
    • _验证方法_：打开终端（CMD 或 PowerShell），输入 node -v，确保显示版本号 >= v22。
  3. API 密钥：你需要一个 AI 模型的 API Key。
    • 推荐使用 Anthropic Claude 的 API Key，因为 Clawdbot 最初是为 Claude 优化的。
    • _获取地址_：Anthropic Console

第二步：安装 Clawdbot

在 Windows 上，我们推荐使用 npm（Node.js 包管理器）进行全局安装。

  1. 打开 PowerShell 或 **命令提示符 (CMD)**。

  2. 输入以下命令并回车：

    1
    npm install -g clawdbot@latest

    这行命令会将 Clawdbot 的最新版本安装到你的系统全局环境中。

第三步：初始化配置 (Onboarding)

安装完成后，需要通过引导程序来配置你的 AI 助手。

  1. 在终端中输入以下命令启动设置向导：

    1
    clawdbot onboard

    如果你希望它在后台持续运行，可以使用 clawdbot onboard --install-daemon

  2. 跟随向导提示操作：

    • 选择 AI 提供商：通常选择 Anthropic (Claude)。
    • 输入 API Key：将你之前准备好的 sk-ant-... 开头的密钥粘贴进去。
    • 设置通讯渠道：向导会询问你想通过什么方式与机器人对话。对于初学者，Telegram 是配置最简单的渠道之一。你需要输入 Telegram Bot Token（可以通过 Telegram 上的 @BotFather 获取）。
    • 设置管理员用户：为了安全，你需要指定哪些用户（例如你的 Telegram 用户名或 ID）有权控制这个机器人。

第四步：验证安装

配置完成后，你可以通过以下命令检查 Clawdbot 的健康状态：

1
clawdbot doctor

如果一切正常，你应该会在终端看到各项服务状态均为绿色（主要检查项包括 Node 版本、配置文件、连接状态等）。

第五步：开始使用

现在，你可以在你配置好的聊天软件（如 Telegram）中给你的机器人发消息了！

尝试发送以下指令：

  • Hello, introduce yourself! (让它介绍自己)
  • Summarize the contents of C:\Users\YourName\Documents\report.txt (让它总结本地文件，注意替换为真实路径)
  • Check the weather in Beijing (联网查询)

安全提示

虽然 Clawdbot 功能强大，但请记住它拥有访问你文件系统和执行命令的权限。

  1. 不要将 API Key 泄露给他人。
  2. 严格限制管理员名单，不要允许陌生账号通过聊天软件控制你的 Clawdbot。
  3. 在让它通过 rm 或 delete 等命令删除文件时，请务必谨慎确认。

祝你使用愉快，享受拥有私人超级 AI 助手的便利！