ClawdBot 是什么

ClawdBot 的核心理念是从"被动对话"进化为"主动代理"。实际使用场景是这样的：早上醒来，你的 WhatsApp 或 Telegram 收到一条消息——"今天有3个重要会议，已帮你整理好议程；昨晚收到15封邮件，其中2封需要紧急回复。"

它的关键特性是本地优先（Local-First）：运行在你自己的硬件上（Mac Mini、笔记本、云服务器均可），所有数据由你掌控，不上传任何第三方平台。对于重视隐私的独立开发者和一人公司来说，这是核心优势。

准备工作

硬件要求（任选其一）

  • Mac Mini 或 MacBook（推荐，体验最佳）
  • Linux 服务器（Ubuntu/Debian 系）
  • Windows PC（需安装 WSL2）
  • 云服务器（Hetzner、AWS、DigitalOcean 等）

软件要求

  • Node.js 22 或更高版本（必须）
  • 基本的命令行使用经验

AI 服务提供商（任选其一）

  • Anthropic（Claude）（强烈推荐）：Claude Pro 账号（支持 OAuth 授权）或 Anthropic API Key
  • OpenAI（ChatGPT）：ChatGPT Plus 账号或 OpenAI API Key

为什么推荐 Claude？Claude 具有更长的上下文窗口，适合处理复杂的多步骤任务，且 Anthropic 对数据隐私的承诺更严格。

消息平台账号（至少一个）

  • Telegram（推荐初次配置使用）：通过 BotFather 创建 Bot Token
  • WhatsApp：手机扫码登录
  • Discord：在 Discord Developer Portal 创建 Bot

完整安装和配置约需 30 分钟。

安装步骤

步骤 1：一键安装

打开终端，运行：

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

脚本会自动检测操作系统、确认 Node.js 版本、全局安装 ClawdBot CLI 工具。

步骤 2：确认安装完成

出现 Clawdbot onboarding 界面即表示安装成功。

步骤 3：配置 AI 提供商

安装向导会引导你选择 AI 服务：

  • 选择 Anthropic（Claude）：有 Claude Pro 账号选 OAuth 授权（最简单），有 API Key 直接粘贴
  • 选择 OpenAI：提供 API Key 即可

连接 Telegram（推荐方案）

ClawdBot 本身没有聊天界面，它通过消息应用与你交互。Telegram 是最容易配置的选项。

步骤 4：创建 Telegram Bot

  1. 在 Telegram 中搜索并打开 BotFather
  2. 发送 /newbot 创建新机器人
  3. 按提示设置：
    • Display Name：显示名称（如 "My AI Assistant"）
    • Username：必须以 bot 结尾（如 "my_ai_assistant_bot"）
  4. BotFather 会返回 Bot Token，形如：110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw
  5. 保存好这个 Token
  6. 在 clawdbot onboard 向导中粘贴 Token
  7. 在 Telegram 中搜索你创建的机器人用户名，发送一条消息激活

运行以下命令检查服务状态：

clawdbot health

步骤 5：配对连接

在 Telegram 中向机器人发送 /start，会出现一个配对码。在终端输入：

clawdbot pairing approve telegram ZEGWXXXX

将 ZEGWXXXX 替换为你的实际配对码。

步骤 6：验证状态

在 Telegram 机器人对话中输入 /stats 查看运行状态。

检测服务运行状态

如果需要确认服务是否正常运行，使用以下命令（默认端口 18789）：

ss -lntp | grep 18789

有输出表示启动成功。如果没有输出，说明服务未运行，可以编写一个 systemd service 来管理启动（可以让大模型帮你生成配置文件，提示词参考："帮我写一个 systemd service，使用 18790 端口"）。

Skills 系统：ClawdBot 的真正威力

Skills 是可插拔的功能模块，让 ClawdBot 能访问你的各种工具和服务。

常见 Skills

  • google-calendar：管理 Google 日历
  • gmail：读取和回复邮件
  • linear：管理项目任务
  • slack：发送和接收消息
  • github：查看 issue、PR 和代码
  • web-browser：浏览网页获取信息

可在 ClawdHub.com 查看全部官方和社区技能。

安装 Skills

clawdbot skills install google-calendar
clawdbot skills install gmail
clawdbot skills install linear

安装过程中会引导你完成 OAuth 授权。查看已安装技能：

clawdbot skills list

实际使用场景

安装 Skills 后，直接对 ClawdBot 说：

  • "帮我检查今天有哪些会议"
  • "总结一下昨天收到的重要邮件"
  • "把这个任务添加到 Linear"
  • "搜索一下最近关于 AI Agent 的资讯"

它会自动调用相应 Skills 完成任务。

自定义技能

如果你熟悉 TypeScript，可以编写自己的 Skill：

clawdbot skills create my-custom-skill

这会生成模板项目，在此基础上开发即可。

安全配置（必读）

ClawdBot 拥有高级权限（执行命令、读取文件、访问邮件等），安全配置不可忽视。

限制访问权限

编辑 ~/.clawdbot/clawdbot.json，添加 allowFrom 字段：

{
  "allowFrom": ["+8613800138000"],
  "allowFrom": ["123456789"]
}

只有指定手机号（WhatsApp）或 Telegram User ID 才能使用 Bot。

密钥保护

  • 绝对不要分享 Claude/OpenAI API Key
  • 绝对不要公开 Telegram Bot Token
  • 不要把 Bot 用户名告诉不信任的人

VPS 部署安全

配置防火墙，只允许本地访问 Gateway 端口：

sudo ufw deny 18789
sudo ufw allow from 127.0.0.1 to any port 18789

远程访问控制面板时，使用 SSH 隧道而非直接暴露端口：

ssh -L 18789:localhost:18789 user-ip

然后在本地浏览器访问 http://127.0.0.1:18789。

渐进式授权

  • 先安装 1-2 个低风险 Skills（如 web-browser）
  • 观察行为、查看日志
  • 逐步扩大权限（邮件、日历等）
  • 定期在控制面板审查操作记录，确保无异常

写在最后

ClawdBot 代表了 AI 工具的一个重要方向：从被动应答到主动代理。对于一人公司和独立开发者而言，它相当于一个 7×24 小时在线的数字助理，能主动帮你处理日程、邮件、任务管理等琐事。建议从 Telegram + 1-2 个 Skills 开始尝试，熟悉后再逐步扩展，把更多重复性工作交给它。