Clawdbot 介绍

Clawdbot 是一个开源的个人 AI 助手(Personal AI Assistant),完全运行在你的本地设备或服务器上。它不像传统聊天 AI 那样只被动回复,而是能主动消息你、执行真实任务,像一个“AI 员工”或“AI 管家”。项目 GitHub 星数已超 40k,非常火爆(最近导致 Mac mini 和一些 VPS 售罄)。官网:https://clawd.bot/,GitHub:https://github.com/clawdbot/clawdbot

它基于 Node.js 构建,支持多种大模型(Claude、GPT、本地模型等),通过你常用的聊天 app(如 Telegram、WhatsApp、Discord、Slack 等)交互,隐私性强(数据默认不离开你的设备)。

主要用途和功能

主要用途

  • 作为 24/7 在线的个人/家庭/团队助手,处理重复性任务、自动化工作流、主动提醒。
  • 适合日常效率提升:比如手机上发消息让它在电脑/VPS 上执行操作(你不在电脑前也能控制)。
  • 典型场景:邮箱管理、日程安排、智能家居控制、代码开发、网页自动化、内容生成等。

关键功能

  • 主动行为:能定时提醒、监控事件、主动发消息(比如总结未读邮件、提醒喝水)。
  • 系统级访问:读写文件、运行 shell 命令、浏览器自动化(浏览网页、填表、刮取数据)。
  • 集成能力:支持 50+ 服务(Gmail、Calendar、Spotify、GitHub、Obsidian、Twitter 等)。
  • 扩展性:技能系统(Skills),可安装插件或自写扩展。
  • 多渠道:WhatsApp、Telegram、Discord、Slack、Signal、iMessage 等,几乎所有主流聊天 app。
  • 其他:持久记忆、语音交互(部分平台)、图像/媒体处理、cron 定时任务、沙箱安全模式。
  • 可以用它做几乎任何事:订机票、自动化报销、跑代码测试、建网站、甚至控制家里的空气净化器。

总之,它把 AI 从“聊天工具”变成“能干活的代理”(Agent),强调实际行动而非只生成文本。

如何部署到 VPS Ubuntu 上

Clawdbot 支持 Linux/Ubuntu 服务器部署(推荐 Ubuntu 22.04+,至少 2GB RAM,建议 4GB+ 以防模型推理卡顿)。部署很简单,但VPS 部署有安全风险(后文详述)。

步骤(推荐安全方式)

  1. 准备 VPS

    • 选择一个 Ubuntu 22.04 VPS(例如 Hetzner、DigitalOcean、SurferCloud 等,5-10 美元/月即可)。
    • SSH 登录:ssh root@你的VPS_IP
  2. 系统准备

    • 更新系统:apt update && apt upgrade -y
    • 安装必要工具:apt install curl git -y
    • (可选,如果 RAM 小)添加 swap:fallocate -l 2G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile
  3. 安装 Node.js 22+(必须):

    curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
    apt install -y nodejs
  4. 安装 Clawdbot(推荐一键脚本):

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

    或者手动:

    npm install -g clawdbot@latest
  5. 初始化并安装为服务(让它后台 24/7 运行):

    clawdbot onboard --install-daemon
    • 这会启动向导(wizard),引导你配置:

      • 设置模型(输入 Anthropic/OpenAI 等 API key)。
      • 配置聊天渠道(比如 Telegram bot token)。
      • 安装 systemd 服务(自动开机启动)。
  6. 启动并检查

    clawdbot gateway  # 手动启动测试
    clawdbot doctor    # 检查配置是否有问题
  7. 远程访问(重要!不要直接暴露端口):

    • 默认 Gateway 只监听本地(127.0.0.1:18789)。
    • 推荐用 Tailscale(免费 VPN)或 SSH 隧道访问 dashboard 和控制。
    • 防火墙设置(ufw):

      ufw allow from 你的本地IP to any port 22  # 只允许 SSH
      ufw deny 18789  # 禁止公网访问 Gateway 端口
      ufw enable

注意:如果用 Docker 部署更安全(官方支持),参考 docs.clawd.bot/install/docker。

如何使用

  1. 配置聊天渠道(以 Telegram 为例,最简单):

    • 在 Telegram 找 @BotFather 创建新 bot,获取 token。
    • 在 Clawdbot wizard 或 dashboard 中输入 token。
    • 在 Telegram 私聊你的 bot,发消息测试(比如 “hello”)。
  2. 日常使用

    • 在聊天 app 中直接发消息给 bot,比如:

      • “帮我清理 Gmail 未读邮件”
      • “明天 9 点提醒我开会”
      • “浏览淘宝搜 iPhone 16 价格并总结”
      • “运行 git pull 并告诉我变化”
    • 它会思考、执行、回复结果(支持流式回复)。
    • 复杂任务可指定 “thinking high” 让它更仔细。
  3. 管理界面

    • 本地访问 http://127.0.0.1:18789 (VPS 上需隧道转发)。
    • 这里可以查看会话、配置技能、检查日志。

重要安全警告

  • Clawdbot 给 AI 很大权限(可运行命令、访问文件),本地跑没问题,但VPS 上暴露端口非常危险(默认无强认证,别人可能偷 API key 或控制你的 bot)。
  • 强烈建议

    • 只本地绑定端口,用 Tailscale/SSH/VPN 访问。
    • 开启沙箱模式(sandbox)限制工具。
    • 定期跑 clawdbot doctor 检查风险。
    • 不要在公网直接开放 18789 端口!
  • 参考官方安全指南:https://docs.clawd.bot/gateway/security

如果遇到问题,查看官方文档 https://docs.clawd.bot/ 或 GitHub issues。享受你的个人 AI 管家吧!

标签: Clawdbot

添加新评论