如何在 VPS 上安装 Clawdbot

Clawdbot 是一个开源、自托管的个人 AI 助手，可连接您喜爱的消息平台。与基于云的 AI 助手（如 ChatGPT）不同，Clawdbot 完全运行在您的基础设施上，让您对数据和隐私拥有完全控制。本文将指导您如何使用 Node.js 在 VPS 上安装 Clawdbot。我们推荐使用 LightNode 作为您的 VPS 提供商。

什么是 Clawdbot？

Clawdbot 是一个强大的个人 AI 助手，嵌入您喜爱的应用和消息平台。它支持 WhatsApp、Telegram、Discord、Slack、Signal、iMessage、Microsoft Teams、Google Chat 等多个平台，将大型语言模型转变为真正个人化、随时可用的伴侣。主要功能包括：

• 多平台支持：支持 10 多个消息平台
• 持久记忆：记住您的偏好和历史对话
• 主动操作：可执行操作、设置提醒和发送通知
• 自托管：完全的数据所有权和隐私控制
• 可定制：可扩展技能和工具
• 全天候运行：在您的 VPS 或本地机器上 24/7 运行

安装前准备

开始之前，请确保您具备以下条件：

1. VPS 服务器：您可以选择多种云服务提供商。我们推荐 LightNode，其性能优异且覆盖全球。
2. 基本命令行知识：熟悉终端命令会更方便操作。
3. 已安装 Node.js：确保服务器上安装了 Node.js 22 或更高版本。
4. 最低系统要求：2GB 内存，1 个 vCPU，10GB 磁盘空间（生产环境建议 4GB 内存）。

为什么推荐 LightNode VPS

LightNode 是托管 Clawdbot 的绝佳选择，原因如下：

LightNode 的主要优势

• 价格实惠：套餐起价仅为 7.71 美元/月，支持按小时计费，方便测试无长期绑定。
• 全球 40+ 数据中心：覆盖美洲、欧洲、亚洲、中东和非洲六大洲，确保全球用户低延迟访问。
• 高性能：NVMe SSD 存储和高频 CPU，满足 AI 工作负载需求。
• 99.95% 运行时间保证：可靠基础设施和本地 BGP 访问，确保助手始终在线。
• 灵活计费：按使用量付费，适合测试和弹性扩展。
• 开发者友好：完全 root 权限，快速部署，支持 Linux 和 Windows。
• 免费快照：每台 VPS 免费提供一次快照，方便备份和恢复。
• 新用户优惠：首次充值可获得最高 15 美元 免费额度。

推荐的 LightNode Clawdbot 配置

此配置为 Clawdbot 运行提供充足资源，并支持随着使用增长扩展。

开始使用 LightNode

第一步：设置您的 VPS

1. 启动实例：登录 LightNode 并创建新的 VPS 实例。建议选择靠近主要用户的节点以优化延迟。亚洲用户可选新加坡或香港，北美用户推荐硅谷节点。

2. 选择操作系统：选择 Ubuntu 22.04 LTS（推荐）或 Ubuntu 24.04。这些版本对 Node.js 支持良好且经过广泛测试。

3. SSH 访问：使用 SSH 客户端连接服务器：

   ssh username@your_server_ip
   

第二步：安装 Node.js

Clawdbot 需要 Node.js 22 或更高版本。以下是在 Ubuntu 上安装的方法：

# 更新软件包列表
sudo apt update

# 从 NodeSource 仓库安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 验证安装
node --version
# 应输出：v22.x.x

您也可以使用 NVM（Node 版本管理器）获得更灵活的版本控制：

# 安装 NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

# 安装 Node.js 22
nvm install 22
nvm use 22

# 验证安装
node --version

第三步：安装 Clawdbot

有多种安装方式，选择最适合您的方法。

方法一：官方安装脚本（推荐初学者）

安装脚本最简单，会自动处理依赖：

# 下载并运行安装脚本
curl -fsSL https://clawd.bot/install.sh | bash

此命令将：

• 自动检测操作系统
• 确保安装 Node.js 22+
• 通过 npm 全局安装 Clawdbot
• 设置必要路径
• 运行诊断命令验证安装

方法二：通过 npm 全局安装

适合熟悉 npm 的用户：

# 全局安装 Clawdbot
npm install -g clawdbot@latest

# 或使用 pnpm（更快）
pnpm add -g clawdbot@latest

# 验证安装
clawdbot --version

方法三：从源码安装（开发者）

# 克隆仓库
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# 安装依赖
pnpm install

# 构建 UI
pnpm ui:build

# 构建项目
pnpm build

# 运行引导向导
./dist/entry.js onboard --install-daemon

方法四：Docker 安装（可选）

适合容器化部署：

# 克隆仓库
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# 运行 Docker 设置脚本
./docker-setup.sh

第四步：运行引导向导

安装完成后，运行引导向导配置 Clawdbot：

# 启动交互式引导向导
clawdbot onboard --install-daemon

向导将引导您完成：

1. 网关配置：选择本地或远程网关模式，设置网关端口（默认：18789）。
2. 认证设置：配置 AI 模型提供商。
   • Anthropic (Claude)：API 密钥或 OAuth（推荐）
   • OpenAI (ChatGPT/Codex)：API 密钥
   • 其他提供商：自定义端点和 API 密钥
3. 渠道配置：设置消息平台：
   • WhatsApp：扫码登录
   • Telegram：从 @BotFather 获取机器人令牌
   • Discord：从 Discord 开发者门户获取机器人令牌
   • Slack：OAuth 或机器人令牌
4. 服务安装：将网关安装为后台服务（Linux 下为 systemd）。
5. 代理身份：设置助手个性和默认行为。

第五步：启动网关

完成引导后，网关应自动启动。您可以通过以下命令检查状态：

# 查看网关状态
clawdbot gateway status

# 查看日志
clawdbot logs --follow

# 检查健康状态
clawdbot health

手动启动（服务未运行时）

# 前台启动网关
clawdbot gateway --port 18789 --verbose

服务管理

# 启动服务
systemctl --user start clawdbot-gateway.service

# 停止服务
systemctl --user stop clawdbot-gateway.service

# 重启服务
systemctl --user restart clawdbot-gateway.service

# 设置开机自启
systemctl --user enable clawdbot-gateway.service

# 查看服务日志
journalctl --user -u clawdbot-gateway -f

第六步：访问控制面板

Clawdbot 控制界面可通过浏览器访问：

http://your_server_ip:18789/

如果您在引导过程中设置了认证，访问时需提供网关令牌。

通过 SSH 隧道远程访问

为保证安全远程访问：

# 在本地机器设置 SSH 隧道
ssh -N -L 18789:127.0.0.1:18789 username@your_server_ip

# 然后本地访问
http://localhost:18789/

第七步：连接第一个渠道

WhatsApp

连接 WhatsApp：

# 生成并显示二维码
clawdbot channels login

# 使用 WhatsApp 扫码：
# 设置 → 已连接设备 → 连接设备

扫码后，您的 WhatsApp 即可连接到 Clawdbot。

Telegram

1. 在 Telegram 上联系 @BotFather 创建机器人
2. 按提示创建新机器人
3. 复制提供的机器人令牌
4. 添加机器人到 Clawdbot：

clawdbot channels add --channel telegram --token "your_bot_token_here"

Discord

1. 访问 Discord 开发者门户
2. 创建新应用
3. 在“Bot”标签页启用机器人
4. 复制机器人令牌
5. 邀请机器人加入您的 Discord 服务器并授予相应权限
6. 添加到 Clawdbot：

clawdbot channels add --channel discord --token "your_discord_bot_token"

第八步：配置私信安全

默认情况下，Clawdbot 对私信使用配对模式，即未知发送者会收到配对码，消息在批准前不会被处理。

# 列出待处理的配对请求
clawdbot pairing list whatsapp

# 批准配对请求
clawdbot pairing approve whatsapp <pairing_code>

# 查看已批准的配对
clawdbot pairing list whatsapp --approved

您可以在配置文件 ~/.clawdbot/clawdbot.json 中修改此行为。

第九步：测试您的设置

发送测试消息确认一切正常：

# 发送测试消息
clawdbot message send --to +15555550123 --message "Hello from Clawdbot!"

# 或通过 Telegram 测试
clawdbot message send --to @your_telegram_username --message "Hello!"

或者直接向已连接的 WhatsApp/Telegram/Discord 发送消息，Clawdbot 助手应会回复。

第十步：配置 Nginx（可选）

生产环境建议使用 Nginx 反向代理以增强安全性并管理 SSL 证书。

安装 Nginx

sudo apt install -y nginx

配置 Nginx

编辑 Nginx 配置文件：

sudo nano /etc/nginx/sites-available/clawdbot

添加以下内容：

server {
    listen 80;
    server_name your-domain.com;  # 替换为您的域名

    location / {
        proxy_pass http://localhost:18789;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

启用配置

# 创建符号链接
sudo ln -s /etc/nginx/sites-available/clawdbot /etc/nginx/sites-enabled/

# 测试 Nginx 配置
sudo nginx -t

# 重启 Nginx
sudo systemctl restart nginx

使用 Certbot 添加 SSL（推荐）

# 安装 Certbot
sudo apt install -y certbot python3-certbot-nginx

# 获取 SSL 证书
sudo certbot --nginx -d your-domain.com

# Certbot 会自动配置 Nginx SSL

完成后，您可以通过以下地址访问 Clawdbot：

https://your-domain.com/

常见问题排查

网关无法启动

若网关启动失败：

# 检查配置错误
clawdbot doctor

# 查看详细日志
journalctl --user -u clawdbot-gateway -n 50

内存不足错误

2GB 内存 VPS 在更新时可能遇到内存不足，建议添加交换分区：

# 创建 2GB 交换文件
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# 设置开机自动启用交换
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

端口已被占用

如果端口 18789 被占用：

# 查找占用端口的进程
sudo lsof -i :18789

# 或使用其他端口启动
clawdbot gateway --port 18889

机器人无响应

机器人无响应时：

1. 检查网关状态：clawdbot gateway status
2. 确认渠道配置：确保令牌正确且渠道已启用
3. 验证认证信息：确认 API 密钥有效
4. 查看日志：clawdbot logs --follow 查找错误信息

更新 Clawdbot

更新到最新版本：

# 重新运行安装脚本
curl -fsSL https://clawd.bot/install.sh | bash

# 或通过 npm 更新
npm update -g clawdbot@latest

# 重启网关
clawdbot gateway restart

# 检查健康状态
clawdbot health

结语

在 VPS 上安装 Clawdbot 是一个简单直接的过程，它为您提供了一个强大、自托管的 AI 助手，支持多种消息平台。借助 LightNode 价格实惠、全球覆盖和高性能基础设施，您可以放心部署个人 AI 助手。

按照本指南操作，您大约在 20-30 分钟内即可让 Clawdbot 在 VPS 上运行，拥有一个尊重隐私、完全掌控数据的全天候 AI 伴侣。

如需进一步定制和高级功能，请参考 Clawdbot GitHub 页面 的官方文档，并参与社区讨论获取更多见解和技巧。

额外资源

• Clawdbot 官方文档
• Clawdbot GitHub 仓库
• LightNode VPS - 推荐的 VPS 提供商
• Clawdbot 社区 Discord
• 技能市场 - 为您的助手扩展更多技能