跳至主要內容

如何在 VPS 上安装 Clawdbot

博客ClawdbotAI 助手VPS 主机安装指南LightNode大约 9 分钟

如何在 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 配置

组件规格月费用
套餐Agency$14.70/月
CPU2 vCPU-
内存4GB DDR4-
存储50GB NVMe SSD-
带宽2TB-
地点新加坡、香港或硅谷-

此配置为 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 页面 的官方文档，并参与社区讨论获取更多见解和技巧。

额外资源

专注全球VPS服务器推荐。