什么是 Clawdbot？
Clawdbot 是一个开源的自托管 AI 助手框架，由社区开发者维护（官网：clawd.bot），它允许你将 AI 模型（如 Anthropic 的 Claude、OpenAI 的 GPT 或其他 API 支持的模型）集成到聊天应用中。通过自然语言对话，你可以让 AI 执行服务器命令、读写文件、搜索互联网、管理日历、发送邮件、控制其他服务，甚至访问手机摄像头或推送通知。它本质上是一个网关服务，桥接 AI API 和消息通道，支持多代理路由、自动化工作流和 cron 任务调度。
与传统本地 LLM（大型语言模型）不同，Clawdbot 不需要强大 GPU，因为它主要依赖云 AI API（节省本地计算资源）。它适用于开发者、系统管理员或个人用户，想要一个私人、自定义的 AI 助手，而无需依赖第三方平台。安全性高，支持本地运行和远程访问，但需注意权限控制，以防 AI 误操作。
系统要求
- 硬件：最低 1GB RAM、1 CPU 核心、25GB 存储。推荐 2GB RAM / 2 CPU 以确保流畅。适用于 VPS（如 DigitalOcean、Linode 或 €4/月的廉价云服务器）、树莓派、旧 PC 或虚拟机。不建议在主力电脑上部署，以避免潜在风险。
- 操作系统：Ubuntu 22.04/24.04 LTS（推荐）、Debian 或其他 Linux 发行版；Windows 10/11（通过 PowerShell）；macOS（类似 Linux，但教程不详述）。
- 软件依赖：Node.js 20+（安装脚本会自动处理）。无互联网安装需求，但配置国外 AI 模型（如 Claude）需 VPN/代理。
- 其他：AI API 密钥（e.g., Anthropic API key 或 Claude Pro 订阅）；聊天应用 token（如 Telegram Bot Token）。
- 成本：免费开源。VPS 费用 ~$5/月；AI API 按使用付费（Claude 免费额度有限）。
步骤 1: 准备环境
获取服务器：
- 如果使用 VPS：选择 Ubuntu 24.04 LTS，配置 1GB RAM / 1 CPU / 25GB NVMe。记录服务器 IP。
- 如果本地：安装 Ubuntu 或在虚拟机（如 VirtualBox）中运行。
- 对于树莓派：安装 Raspberry Pi OS（基于 Debian），确保 SSH 启用。
SSH 登录：
- 使用终端：ssh root@你的服务器IP（替换为实际 IP）。
- 如果是新用户，创建 sudo 用户（推荐安全实践）：
adduser clawd
usermod -aG sudo clawd
su – clawd
- 更新系统：sudo apt update && sudo apt upgrade -y。
Windows 用户准备：
- 打开 PowerShell（管理员模式）。
- 无需额外服务器，直接在本地运行（但不推荐用于生产）。
步骤 2: 安装 Clawdbot
安装使用一键脚本，自动处理 Node.js 和依赖。
Linux/Ubuntu：
curl -fsSL https://clawd.bot/install.sh | bash
脚本会下载 Node.js（如果缺失）、安装 Clawdbot 全局包，并配置环境。
完成后，重载 shell： exec bash或重启终端。
Windows：
iwr -useb https://clawd.bot/install.ps1 | iex
这会在 PowerShell 中运行，安装类似。
安装后，验证：运行 clawdbot –version ，应显示版本号。
步骤 3: 配置 Clawdbot
- 运行向导：
clawdbot setup –wizard
或 clawdbot onboard –install-daemon（安装后台服务）。
- 向导会引导：
- 选择网关模式：本地（local）或远程（remote）。
- 配置认证：输入 Anthropic API 密钥（从 claude.ai 获取）或其他模型（如 OpenAI）。支持 OAuth。
- 选择默认模型：e.g., claude-3-5-sonnet-20240620。
- 设置通道：Telegram、WhatsApp、Discord 或 iMessage。
- 安装 daemon：Linux 用 systemd，Windows 用服务管理器，macOS 用 launchd。确保服务自动启动。
更换模型：
- 运行 clawdbot config，选择模型部分，输入新 API 密钥或切换提供商。
- 支持多模型路由：不同联系人用不同代理。
安全设置：
- 设置密码或 token 认证。
- 限制权限：AI 默认有 shell 访问，但可配置白名单命令。
- 对于远程访问，使用 SSH 隧道：ssh -L 18789:127.0.0.1:18789 clawd@你的IP。
步骤 4: 设置聊天通道（以 Telegram 为例）
创建 Telegram Bot：
- 在 Telegram 搜索 @BotFather，发送 /newbot，跟随提示创建 bot，获取 Token。
配置通道：
- 在向导中输入 Token，或手动：。
- clawdbot channel add telegram –token 你的TOKEN
启动网关：
clawdbot gateway –bind lan –port 18789
- 这启动服务，监听本地端口 18789。
- 对于后台运行：使用 daemon 模式。
配对 Bot：
- 在 Telegram DM 你的 bot，发送消息。它会返回配对码。
- 在服务器运行：clawdbot pairing list telegram 查看码，然后 clawdbot pairing approve telegram [码]。
测试：向 bot 发送 “Hello”，AI 应回复。试命令如 “run ls”（列目录）或 “search X news”。
其他通道类似：
- WhatsApp：使用 Twilio 或类似服务获取 token。
- Discord：创建 bot app，获取 token。
- iMessage：需 macOS，配置 AppleScript。
步骤 5: 启动和运行
启动服务：
- Linux：sudo systemctl start clawdbot（如果安装 daemon）。
- Windows：通过服务管理器启动。
- 访问仪表盘：浏览器打开 http://127.0.0.1:18789（本地）或通过隧道远程。
高级功能：
- 自动化：设置 cron：e.g., clawdbot cron add “每天发送报告”。
- 多节点：将手机作为节点，启用摄像头/通知：clawdbot node add phone。
- 开发使用：命令如 “deploy app”（集成 Git）、”review PR” 或 “check logs”。
- Web 搜索：AI 可内置搜索，配置 SerpAPI 等。
- 文件管理： “write file content to test.txt”。
监控和日志：
- 查看日志：clawdbot logs。
- 更新：npm update -g clawdbot。
步骤 6: 故障排除和最佳实践
- 常见问题：
- API 密钥错误：检查 claude.ai 账户，确保有额度。
- 端口冲突：改端口 –port 其他。
- 模型响应慢：切换提供商或检查网络（需翻墙国外模型）。
- 安装失败：确保 curl/iwr 可用，检查防火墙（ufw allow 18789）。
- 最佳实践：
- 使用 Tailscale/ZeroTier 安全远程访问。
- 备份配置：~/.clawdbot/config.json。
- 监控资源：top/htop，确保不超过限额。
- 社区资源：官网 docs.clawd.bot，GitHub 仓库，X 搜索 #Clawdbot。
- 风险：AI 有 shell 访问，测试时用沙盒环境。
结语
部署 Clawdbot 只需 15-30 分钟，即可拥有一个强大的私人 AI 助手，提升生产力。相比购买 $600 Mac Mini，廉价 VPS 更经济。如果你有编程背景，可自定义扩展；新手跟随向导即可。开始实验吧——从简单命令到复杂自动化，它将改变你的工作流！如果遇到问题，参考官方文档或社区讨论。
文档: https://docs.clawd.bot/
GitHub: https://github.com/clawdbot/clawdbot