Bỏ qua nội dung chính

Hướng Dẫn Cài Đặt Clawdbot trên VPS

BlogsClawdbotAI AssistantVPS HostingInstallation GuideLightNodeKhoảng 11 phút

Hướng Dẫn Cài Đặt Clawdbot trên VPS

Clawdbot là trợ lý AI cá nhân mã nguồn mở, tự lưu trữ, kết nối với các nền tảng nhắn tin yêu thích của bạn. Khác với các trợ lý AI dựa trên đám mây như ChatGPT, Clawdbot chạy hoàn toàn trên hạ tầng của bạn, giúp bạn kiểm soát hoàn toàn dữ liệu và quyền riêng tư. Trong bài viết này, chúng tôi sẽ hướng dẫn bạn quy trình cài đặt Clawdbot trên VPS sử dụng Node.js. Chúng tôi khuyên bạn nên dùng LightNode làm nhà cung cấp VPS.

Clawdbot là gì?

Clawdbot là trợ lý AI cá nhân mạnh mẽ hoạt động bên trong các ứng dụng và nền tảng nhắn tin yêu thích của bạn. Nó kết nối với WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Microsoft Teams, Google Chat và nhiều hơn nữa, biến các Mô hình Ngôn ngữ Lớn thành người bạn đồng hành cá nhân, luôn sẵn sàng. Các tính năng chính bao gồm:

  • Hỗ trợ đa nền tảng: Hoạt động trên hơn 10 nền tảng nhắn tin
  • Bộ nhớ liên tục: Ghi nhớ sở thích và các cuộc trò chuyện trước đây theo thời gian
  • Hành động chủ động: Có thể thực hiện hành động, đặt nhắc nhở và gửi thông báo
  • Tự lưu trữ: Toàn quyền sở hữu dữ liệu và kiểm soát quyền riêng tư
  • Tùy biến: Mở rộng với các kỹ năng và công cụ
  • Luôn hoạt động: Chạy 24/7 trên VPS hoặc máy cục bộ của bạn

Yêu cầu trước khi bắt đầu

Trước khi bắt đầu, hãy đảm bảo bạn có:

  1. Máy chủ VPS: Bạn có thể chọn từ nhiều nhà cung cấp dịch vụ đám mây khác nhau. Chúng tôi khuyên dùng LightNode vì hiệu suất tuyệt vời và phạm vi phủ sóng toàn cầu.
  2. Kiến thức cơ bản về dòng lệnh: Hiểu biết về các lệnh terminal sẽ rất hữu ích.
  3. Node.js đã được cài đặt: Đảm bảo Node.js phiên bản 22 trở lên đã được cài trên máy chủ.
  4. Yêu cầu hệ thống tối thiểu: 2GB RAM, 1 vCPU, 10GB dung lượng đĩa (khuyến nghị 4GB RAM cho môi trường sản xuất).

Tại sao chúng tôi khuyên dùng VPS LightNode

LightNode là lựa chọn tuyệt vời để lưu trữ Clawdbot vì nhiều lý do:

Lợi ích chính của LightNode

  • Giá cả phải chăng: Các gói bắt đầu từ 7,71 USD/tháng với thanh toán theo giờ, cho phép bạn thử nghiệm mà không cần cam kết dài hạn.
  • Hơn 40 địa điểm toàn cầu: Trung tâm dữ liệu trải rộng trên 6 châu lục bao gồm Mỹ, châu Âu, châu Á, Trung Đông và châu Phi, đảm bảo độ trễ thấp cho người dùng trên toàn thế giới.
  • Hiệu suất cao: Lưu trữ NVMe SSD và CPU tần số cao cung cấp hiệu năng tuyệt vời cho các tác vụ AI.
  • Đảm bảo thời gian hoạt động 99,95%: Hạ tầng đáng tin cậy với truy cập BGP địa phương đảm bảo trợ lý của bạn luôn sẵn sàng.
  • Thanh toán linh hoạt: Chỉ trả tiền cho những gì bạn sử dụng với thanh toán theo giờ, lý tưởng cho thử nghiệm và mở rộng.
  • Thân thiện với nhà phát triển: Toàn quyền truy cập root, triển khai tức thì, hỗ trợ cả Linux và Windows.
  • Snapshot miễn phí: Một snapshot miễn phí mỗi VPS để sao lưu và phục hồi dễ dàng.
  • Ưu đãi cho người dùng mới: Nhận tới 15 USD tín dụng miễn phí khi nạp lần đầu.

Cấu hình LightNode được khuyến nghị cho Clawdbot

Thành phầnThông số kỹ thuậtChi phí hàng tháng
GóiAgency14,70 USD/tháng
CPU2 vCPU-
RAM4GB DDR4-
Lưu trữ50GB NVMe SSD-
Băng thông2TB-
Vị tríSingapore, Hong Kong hoặc Silicon Valley-

Cấu hình này cung cấp đủ tài nguyên cho hoạt động của Clawdbot và cho phép mở rộng khi nhu cầu sử dụng tăng lên.

Bắt đầu với LightNode

Bước 1: Thiết lập VPS của bạn

  1. Khởi tạo máy chủ: Đăng nhập vào LightNode và tạo một VPS mới. Chúng tôi khuyên bạn chọn vị trí gần người dùng chính để tối ưu độ trễ. Đối với truy cập toàn cầu, Singapore hoặc Hong Kong là lựa chọn tuyệt vời cho người dùng châu Á, trong khi Silicon Valley phù hợp với người dùng Bắc Mỹ.

  2. Chọn hệ điều hành: Chọn Ubuntu 22.04 LTS (khuyến nghị) hoặc Ubuntu 24.04. Các phiên bản này hỗ trợ Node.js rất tốt và được kiểm thử rộng rãi.

  3. Truy cập SSH: Sử dụng client SSH để truy cập máy chủ:

    ssh username@your_server_ip

Bước 2: Cài đặt Node.js

Clawdbot yêu cầu Node.js phiên bản 22 trở lên. Dưới đây là cách cài trên Ubuntu:

# Cập nhật danh sách gói
sudo apt update

# Cài Node.js 22 từ kho NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Kiểm tra cài đặt
node --version
# Kết quả nên là: v22.x.x

Ngoài ra, bạn có thể dùng NVM (Node Version Manager) để linh hoạt hơn:

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

# Cài Node.js 22
nvm install 22
nvm use 22

# Kiểm tra cài đặt
node --version

Bước 3: Cài đặt Clawdbot

Có nhiều phương pháp cài đặt, chọn cách phù hợp nhất với bạn.

Phương pháp 1: Script cài đặt chính thức (Khuyến nghị cho người mới)

Script cài đặt là cách đơn giản nhất và tự động xử lý các phụ thuộc:

# Tải và chạy script cài đặt
curl -fsSL https://clawd.bot/install.sh | bash

Lệnh này sẽ:

  • Phát hiện hệ điều hành của bạn
  • Đảm bảo Node.js 22+ đã được cài
  • Cài đặt Clawdbot toàn cục qua npm
  • Thiết lập các đường dẫn cần thiết
  • Chạy lệnh doctor để kiểm tra cài đặt

Phương pháp 2: Cài đặt qua npm toàn cục

Dành cho người dùng quen với npm:

# Cài Clawdbot toàn cục
npm install -g clawdbot@latest

# Hoặc dùng pnpm (nhanh hơn)
pnpm add -g clawdbot@latest

# Kiểm tra cài đặt
clawdbot --version

Phương pháp 3: Cài từ mã nguồn (Dành cho nhà phát triển)

# Clone kho mã nguồn
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Cài các phụ thuộc
pnpm install

# Xây dựng giao diện người dùng
pnpm ui:build

# Xây dựng dự án
pnpm build

# Chạy trình hướng dẫn onboarding
./dist/entry.js onboard --install-daemon

Phương pháp 4: Cài đặt bằng Docker (Tùy chọn)

Dành cho triển khai container:

# Clone kho mã nguồn
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Chạy script thiết lập Docker
./docker-setup.sh

Bước 4: Chạy trình hướng dẫn onboarding

Sau khi cài đặt, chạy trình hướng dẫn onboarding để cấu hình Clawdbot:

# Khởi chạy trình hướng dẫn tương tác
clawdbot onboard --install-daemon

Trình hướng dẫn sẽ giúp bạn:

  1. Cấu hình Gateway: Chọn chế độ gateway local hoặc remote và thiết lập cổng gateway (mặc định: 18789).
  2. Thiết lập xác thực: Cấu hình nhà cung cấp mô hình AI.
    • Anthropic (Claude): API key hoặc OAuth (khuyến nghị)
    • OpenAI (ChatGPT/Codex): API key
    • Nhà cung cấp khác: Endpoint và API key tùy chỉnh
  3. Cấu hình kênh: Thiết lập các nền tảng nhắn tin:
    • WhatsApp: đăng nhập bằng mã QR
    • Telegram: token bot từ @BotFather
    • Discord: token bot từ Discord Developer Portal
    • Slack: OAuth hoặc token bot
  4. Cài đặt dịch vụ: Cài Gateway như dịch vụ nền (systemd trên Linux).
  5. Định danh Agent: Thiết lập tính cách và hành vi mặc định của trợ lý.

Bước 5: Khởi động Gateway

Sau khi hoàn thành onboarding, Gateway sẽ tự động khởi động. Bạn có thể kiểm tra trạng thái bằng:

# Kiểm tra trạng thái gateway
clawdbot gateway status

# Xem nhật ký
clawdbot logs --follow

# Kiểm tra sức khỏe
clawdbot health

Khởi động thủ công (nếu dịch vụ không chạy)

# Khởi động gateway ở chế độ foreground
clawdbot gateway --port 18789 --verbose

Quản lý dịch vụ

# Khởi động dịch vụ
systemctl --user start clawdbot-gateway.service

# Dừng dịch vụ
systemctl --user stop clawdbot-gateway.service

# Khởi động lại dịch vụ
systemctl --user restart clawdbot-gateway.service

# Kích hoạt dịch vụ tự động khởi động cùng hệ thống
systemctl --user enable clawdbot-gateway.service

# Xem nhật ký dịch vụ
journalctl --user -u clawdbot-gateway -f

Bước 6: Truy cập Dashboard

Giao diện điều khiển Clawdbot có thể truy cập qua trình duyệt web:

http://your_server_ip:18789/

Nếu bạn đã thiết lập xác thực trong quá trình onboarding, bạn sẽ cần cung cấp token gateway để truy cập dashboard.

Truy cập từ xa qua SSH Tunnel

Để truy cập từ xa an toàn:

# Thiết lập SSH tunnel từ máy cục bộ
ssh -N -L 18789:127.0.0.1:18789 username@your_server_ip

# Sau đó truy cập tại địa chỉ
http://localhost:18789/

Bước 7: Kết nối kênh đầu tiên của bạn

WhatsApp

Để kết nối WhatsApp:

# Tạo và hiển thị mã QR
clawdbot channels login

# Quét mã với WhatsApp:
# Cài đặt → Thiết bị đã liên kết → Liên kết thiết bị mới

Sau khi quét, WhatsApp của bạn sẽ kết nối với Clawdbot.

Telegram

  1. Tạo bot bằng cách nhắn tin với @BotFather trên Telegram
  2. Làm theo hướng dẫn để tạo bot mới
  3. Sao chép token bot được cung cấp
  4. Thêm bot vào Clawdbot:
clawdbot channels add --channel telegram --token "your_bot_token_here"

Discord

  1. Truy cập Discord Developer Portal
  2. Tạo ứng dụng mới
  3. Kích hoạt bot trong tab "Bot"
  4. Sao chép token bot
  5. Mời bot vào server Discord với quyền phù hợp
  6. Thêm vào Clawdbot:
clawdbot channels add --channel discord --token "your_discord_bot_token"

Bước 8: Cấu hình an toàn tin nhắn riêng tư (DM Safety)

Mặc định, Clawdbot sử dụng chế độ ghép đôi cho tin nhắn trực tiếp, nghĩa là người gửi chưa biết sẽ nhận mã ghép đôi và tin nhắn của họ không được xử lý cho đến khi được phê duyệt.

# Liệt kê các yêu cầu ghép đôi đang chờ
clawdbot pairing list whatsapp

# Phê duyệt yêu cầu ghép đôi
clawdbot pairing approve whatsapp <pairing_code>

# Xem các ghép đôi đã được phê duyệt
clawdbot pairing list whatsapp --approved

Bạn có thể thay đổi hành vi này trong file cấu hình tại ~/.clawdbot/clawdbot.json.

Bước 9: Kiểm tra thiết lập

Gửi tin nhắn thử để xác nhận mọi thứ hoạt động:

# Gửi tin nhắn thử
clawdbot message send --to +15555550123 --message "Hello from Clawdbot!"

# Hoặc thử qua Telegram
clawdbot message send --to @your_telegram_username --message "Hello!"

Ngoài ra, bạn có thể gửi tin nhắn trực tiếp tới WhatsApp/Telegram/Discord đã kết nối, trợ lý Clawdbot sẽ phản hồi.

Bước 10: Cấu hình Nginx (Tùy chọn)

Đối với môi trường sản xuất, chúng tôi khuyên bạn nên thiết lập reverse proxy với Nginx để tăng cường bảo mật và quản lý chứng chỉ SSL.

Cài đặt Nginx

sudo apt install -y nginx

Cấu hình Nginx

Chỉnh sửa file cấu hình Nginx:

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

Thêm cấu hình sau:

server {
    listen 80;
    server_name your-domain.com;  # Thay bằng tên miền của bạn

    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;
    }
}

Kích hoạt cấu hình

# Tạo liên kết tượng trưng
sudo ln -s /etc/nginx/sites-available/clawdbot /etc/nginx/sites-enabled/

# Kiểm tra cấu hình Nginx
sudo nginx -t

# Khởi động lại Nginx
sudo systemctl restart nginx

Thêm SSL với Certbot (Khuyến nghị)

# Cài Certbot
sudo apt install -y certbot python3-certbot-nginx

# Lấy chứng chỉ SSL
sudo certbot --nginx -d your-domain.com

# Certbot sẽ tự động cấu hình Nginx với SSL

Sau đó, Clawdbot của bạn sẽ truy cập được tại:

https://your-domain.com/

Khắc phục sự cố phổ biến

Gateway không khởi động được

Nếu gateway không thể khởi động:

# Kiểm tra lỗi cấu hình
clawdbot doctor

# Xem nhật ký chi tiết
journalctl --user -u clawdbot-gateway -n 50

Lỗi hết bộ nhớ

Trên VPS 2GB RAM, bạn có thể gặp lỗi hết bộ nhớ khi cập nhật. Thêm file swap:

# Tạo file swap 2GB
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Thiết lập swap vĩnh viễn
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Cổng đã được sử dụng

Nếu cổng 18789 đã bị chiếm:

# Tìm tiến trình đang dùng cổng
sudo lsof -i :18789

# Hoặc dùng cổng khác
clawdbot gateway --port 18889

Bot không phản hồi

Nếu bot không phản hồi:

  1. Kiểm tra trạng thái Gateway: clawdbot gateway status
  2. Xác nhận cấu hình kênh: Đảm bảo token chính xác và kênh đã được bật
  3. Kiểm tra xác thực: Đảm bảo API key hợp lệ
  4. Xem nhật ký: clawdbot logs --follow để tìm lỗi

Cập nhật Clawdbot

Để cập nhật lên phiên bản mới nhất:

# Chạy lại script cài đặt
curl -fsSL https://clawd.bot/install.sh | bash

# Hoặc cập nhật qua npm
npm update -g clawdbot@latest

# Khởi động lại gateway
clawdbot gateway restart

# Kiểm tra sức khỏe
clawdbot health

Kết luận

Việc cài đặt Clawdbot trên VPS là một quy trình đơn giản, mang lại cho bạn trợ lý AI mạnh mẽ, tự lưu trữ và truy cập được trên nhiều nền tảng nhắn tin. Với giá cả phải chăng, phạm vi phủ sóng toàn cầu và hạ tầng hiệu suất cao của LightNode, bạn có thể triển khai trợ lý AI cá nhân một cách tự tin.

Theo hướng dẫn này, bạn sẽ có Clawdbot chạy trên VPS trong khoảng 20-30 phút, cung cấp cho bạn người bạn đồng hành AI luôn sẵn sàng, tôn trọng quyền riêng tư và cho phép bạn kiểm soát hoàn toàn dữ liệu.

Để tùy biến thêm và khám phá các tính năng nâng cao, hãy tham khảo tài liệu chính thức trên trang GitHub Clawdbot và tham gia các thảo luận cộng đồng để nhận thêm thông tin và mẹo hay.

Tài nguyên bổ sung

Tập trung giới thiệu máy chủ VPS toàn cầu.