Hướng Dẫn Cài Đặt Và Sử Dụng OpenClaw Trên Ubuntu Chi Tiết Từ A-Z

Cài đặt và sử dụng OpenClaw trên Ubuntu cho phép bạn dựng một trợ lý AI self-hosted, kết nối nhiều kênh chat và giữ dữ liệu trên máy chủ của mình thay vì phụ thuộc hoàn toàn vào cloud bên thứ ba. Nếu cần một VPS để thử nghiệm, dịch vụ máy chủ tại ThueVPSGiaRe.vn có cấu hình phù hợp. Bài viết này đi qua các bước chính: chuẩn bị môi trường, cấu hình Gateway và kết nối kênh chat.

OpenClaw là gì? Vì sao nên chạy trên Ubuntu VPS?

OpenClaw là Gateway mã nguồn mở theo giấy phép MIT, dùng để nối các ứng dụng nhắn tin như Telegram, WhatsApp, Discord, Slack, Zalo… với các AI agent như Claude Code, OpenAI Codex CLI hoặc trợ lý tự xây. Bạn có thể ra lệnh từ xa, tự động hóa tác vụ và trò chuyện với AI qua một cổng kết nối duy nhất.

Chạy OpenClaw trên VPS Ubuntu có vài lợi ích thực tế so với chạy trên máy cá nhân:

• Luôn trực tuyến: VPS chạy 24/7, bot không phụ thuộc vào việc máy tính của bạn có bật hay không.
• Dữ liệu nằm trên máy bạn: API key, lịch sử hội thoại và webhook do bạn quản lý, có thể siết bằng tường lửa.
• Mạng ổn định hơn: Đường truyền VPS thường tốt hơn mạng gia đình, giảm độ trễ khi gọi LLM API.
• Dễ vận hành: Dùng systemd để tự khởi động lại khi lỗi hoặc khi VPS reboot.

Yêu cầu hệ thống và chuẩn bị VPS Ubuntu

Trước khi cài OpenClaw, nên kiểm tra VPS có đủ tài nguyên không. Thiếu RAM hoặc dùng sai phiên bản Node.js dễ gây lỗi khi build gói mở rộng.

Thành phần	Yêu cầu tối thiểu	Cấu hình khuyến nghị
Hệ điều hành	Ubuntu 22.04 LTS (Jammy)	Ubuntu 24.04 LTS (Noble)
Bộ xử lý (CPU)	1 vCPU Core	2 vCPU Core trở lên (Intel Gold)
Bộ nhớ (RAM)	2 GB RAM	4 GB RAM (cho Docker và đa kênh)
Ổ đĩa (Disk)	20 GB SSD trống	30+ GB SSD NVMe U.2
Môi trường thực thi	Node.js v24.16+ hoặc v26.1+	Node.js v26.x + npm 10+

Bắt đầu bằng việc cập nhật hệ thống và cài các công cụ cơ bản:

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget git build-essential ca-certificates gnupg

Nếu chạy nhiều dịch vụ bot, bạn có thể đặt hostname rõ ràng để dễ quản lý. Tham khảo hướng dẫn thay đổi hostname Ubuntu 22.04. Trường hợp cần giao diện đồ họa để đăng nhập kênh chat qua trình duyệt, có thể cài Ubuntu Desktop trên VPS.

Các cách cài đặt và sử dụng OpenClaw trên Ubuntu

Tùy kinh nghiệm quản trị và cách bạn muốn triển khai, có thể chọn một trong ba cách sau:

Tiêu chí	Cách 1: Script chính thức	Cách 2: npm toàn cục	Cách 3: Docker Container
Độ khó	Thấp (tự động hóa)	Trung bình	Trung bình – Khá
Thời gian thực hiện	~3 – 5 phút	~7 – 10 phút	~10 – 15 phút
Cài sẵn Node.js	Tự phát hiện và cài đặt	Cần cài thủ công trước	Đóng gói sẵn trong Image
Phù hợp với	Người mới, cần deploy nhanh	Developer muốn tinh chỉnh CLI	Môi trường DevOps, cần cô lập tài nguyên

Cài OpenClaw bằng script chính thức (Cách nhanh nhất)

Script chính thức là cách nhanh nhất. Nó kiểm tra hệ điều hành, cài Node.js LTS nếu máy chủ chưa có và thêm CLI vào PATH.

Bước 1: Chạy script tải tự động

Chạy lệnh sau trên terminal VPS Ubuntu:

curl -fsSL https://openclaw.ai/install.sh | bash

Bước 2: Nạp lại biến môi trường và kiểm tra phiên bản

Sau khi script xong, nạp lại shell hiện tại và kiểm tra phiên bản:

source ~/.bashrc
openclaw --version

Bước 3: Chạy trình hướng dẫn thiết lập ban đầu

OpenClaw có wizard tương tác để tạo cấu hình, thêm API key cho AI provider và cài daemon:

openclaw onboard --install-daemon

Cài OpenClaw Node.js thủ công qua npm

Nếu muốn kiểm soát phiên bản Node.js và quản lý package qua npm, cài thủ công sẽ giúp cấu trúc máy chủ rõ ràng hơn.

Bước 1: Cài Node.js 26.x qua NodeSource

OpenClaw cần Node.js tối thiểu 24.16+ hoặc 26.1+. Nên dùng Node.js 26 để đảm bảo tương thích API:

# Thêm kho lưu trữ NodeSource cho Node.js 26
curl -fsSL https://deb.nodesource.com/setup_26.x | sudo -E bash -

# Cài đặt Node.js và npm
sudo apt install -y nodejs

# Kiểm tra phiên bản
node -v
npm -v

Bước 2: Cài OpenClaw toàn cục

Cài CLI OpenClaw cho toàn hệ thống:

sudo npm install -g openclaw@latest

Cài OpenClaw trên VPS Ubuntu bằng Docker

Docker phù hợp nếu bạn muốn dễ sao lưu, di chuyển và cô lập môi trường chạy AI Gateway. Có thể xem thêm Docker là gì và cách cài đặt trên VPS.

Tạo thư mục dự án và file docker-compose.yml:

mkdir -p ~/openclaw-docker && cd ~/openclaw-docker
nano docker-compose.yml

Dán nội dung cấu hình sau:

services:
  openclaw-gateway:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw-gateway
    restart: unless-stopped
    ports:
      - "127.0.0.1:18789:18789"
    volumes:
      - ./config:/root/.config/openclaw
      - ./data:/root/.local/share/openclaw
    environment:
      - NODE_ENV=production
      - ANTHROPIC_API_KEY=your_anthropic_api_key_here
      - OPENAI_API_KEY=your_openai_api_key_here

Khởi chạy container ở chế độ chạy ngầm:

docker compose up -d
docker compose logs -f openclaw-gateway

Kết nối OpenClaw với Telegram, WhatsApp và các kênh chat

OpenClaw gom nhiều kênh nhắn tin về một nơi xử lý AI. Dưới đây là cách nối Telegram và WhatsApp.

1. Cấu hình Telegram Bot

1. Mở Telegram, tìm @BotFather, gõ /newbot để tạo bot và lưu lại HTTP API Token.
2. Trên VPS, thêm kênh Telegram vào OpenClaw:

openclaw channels add telegram --token "YOUR_TELEGRAM_BOT_TOKEN"

Kiểm tra bằng openclaw channels status. Khi trạng thái là Connected, bạn có thể nhắn thử với bot để nhận phản hồi từ AI agent.

2. Cấu hình WhatsApp (Baileys Plugin)

OpenClaw hỗ trợ WhatsApp qua thư viện Baileys bằng cách quét mã QR:

openclaw channels add whatsapp --login-qr

Mã QR dạng ASCII sẽ hiện trên terminal. Mở WhatsApp trên điện thoại > Thiết bị liên kết > Liên kết thiết bị và quét mã.

Quản lý OpenClaw Gateway với systemd

Để Gateway chạy nền và tự bật lại sau khi reboot, nên quản lý bằng systemd.

Cách 1: Dùng lệnh có sẵn của OpenClaw

# Cài service systemd cho user hiện tại
openclaw gateway install

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

# Bật tự khởi động cùng OS
systemctl --user enable openclaw-gateway

# Giữ service chạy khi SSH session ngắt kết nối
loginctl enable-linger $USER

Cách 2: Tạo system service toàn cục (/etc/systemd/system)

Với máy chủ production, có thể tạo service cấp hệ thống:

sudo nano /etc/systemd/system/openclaw.service

Nội dung service (thay ubuntu bằng username thực tế):

[Unit]
Description=OpenClaw AI Gateway Service
After=network.target

[Service]
Type=simple
User=ubuntu
ExecStart=/usr/bin/openclaw gateway start
Restart=always
RestartSec=10
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target

Nạp lại daemon và khởi động dịch vụ:

sudo systemctl daemon-reload
sudo systemctl enable --now openclaw.service
sudo systemctl status openclaw.service

Bảo mật OpenClaw trên VPS Ubuntu

OpenClaw lưu API key của các nhà cung cấp AI và phiên đăng nhập ứng dụng chat, nên bảo mật VPS rất quan trọng. Bạn nên xem qua cẩm nang bảo mật VPS hiệu quả để bảo vệ dữ liệu.

Thiết lập UFW theo hướng dẫn thiết lập tường lửa UFW trên Ubuntu:

# Mở cổng SSH hiện tại (hoặc port đã đổi)
sudo ufw allow 22/tcp

# Chặn cổng Dashboard OpenClaw (18789) ra Internet công cộng
# Chỉ truy cập qua localhost hoặc SSH Tunnel
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw enable

Để giảm quét mật khẩu tự động, nên đổi port SSH bảo mật VPS sang một cổng ngẫu nhiên, ví dụ 2289. Nếu cần vào Dashboard từ xa, có thể dùng SSH tunnel hoặc cài OpenVPN trên VPS.

Xử lý lỗi thường gặp khi cài OpenClaw trên Ubuntu

Một số lỗi hay gặp và cách xử lý:

Hiện tượng / Lỗi	Nguyên nhân	Cách khắc phục
Node version incompatible	Node.js dưới bản 24.16	Dùng NodeSource cài Node.js 26.x hoặc nâng cấp qua nvm.
Chromium snap sandbox error	Gói Chromium qua snap trên Ubuntu bị lỗi quyền headless	Cài Google Chrome chính thức từ file .deb thay vì gói snap.
Service stops when SSH closes	Chưa bật linger cho systemd user	Chạy loginctl enable-linger $USER hoặc chuyển sang system service.
Port 18789 already in use	Tiến trình cũ chưa giải phóng cổng	Tìm PID bằng sudo lsof -i :18789 và dừng tiến trình thừa.

Câu hỏi thường gặp về OpenClaw trên Ubuntu

OpenClaw là gì?

OpenClaw là cổng kết nối self-hosted giữa các ứng dụng nhắn tin như Telegram, Discord, WhatsApp và các AI agent. Bạn có thể gửi lệnh từ điện thoại để AI thực thi tác vụ trên máy chủ theo thời gian thực.

Cần cấu hình VPS như thế nào để chạy OpenClaw?

Tối thiểu 1 vCPU, 2GB RAM và 20GB ổ cứng, chạy Ubuntu 22.04/24.04 LTS. Nếu dùng Docker hoặc nối nhiều kênh chat cùng lúc, nên dùng 2 vCPU và 4GB RAM.

OpenClaw có miễn phí không?

Mã nguồn OpenClaw miễn phí theo giấy phép MIT. Bạn chỉ cần trả phí VPS Ubuntu và chi phí token API từ các nhà cung cấp mô hình AI như Anthropic hoặc OpenAI.

OpenClaw hỗ trợ những kênh chat nào?

OpenClaw hỗ trợ sẵn Telegram, WebChat và có hệ sinh thái plugin cho WhatsApp, Discord, Slack, Microsoft Teams, Signal, Matrix, Google Chat, Zalo cùng nhiều giao thức liên lạc mở khác.

Làm sao để OpenClaw tự khởi động cùng hệ thống?

Bạn có thể chạy openclaw gateway install và bật loginctl enable-linger $USER, hoặc tạo service trong /etc/systemd/system/ để hệ thống tự khởi chạy sau mỗi lần reboot.

Bài viết mang tính tham khảo kỹ thuật. Các lệnh được kiểm chứng trên Ubuntu 22.04/24.04 LTS với quyền root/sudo. Tùy phiên bản hệ điều hành, phân quyền user và môi trường thực tế, kết quả có thể khác. Nên sao lưu dữ liệu và thử nghiệm trước khi đưa vào vận hành thật.