Hướng dẫn cài đặt OpenClaw trên VPS Ubuntu 24.04

Bài viết này hướng dẫn chi tiết cách cài OpenClaw trên VPS theo kiểu tài liệu đơn giản, dễ đọc, dễ copy lệnh và phù hợp cho cả người mới.

Mục lục

Giới thiệu nhanh
Những gì cần chuẩn bị
Kết nối đến server
Tạo user mới
Cài đặt OpenClaw
Khởi động OpenClaw Gateway
Kết nối từ máy tính cá nhân
Thiết lập chạy tự động với systemd
Xử lý sự cố
Bảng tham khảo nhanh
Câu hỏi thường gặp

Giới thiệu nhanh

Nếu bạn muốn chạy OpenClaw ổn định trên VPS thay vì phụ thuộc vào máy cá nhân, quy trình dưới đây sẽ giúp bạn thiết lập từ đầu đến cuối. Nội dung tập trung vào thao tác thực tế, rõ lệnh và hạn chế trình bày rườm rà.

Lưu ý: Bất cứ chỗ nào xuất hiện YOUR_SERVER_IP, hãy thay bằng địa chỉ IP thật của VPS, ví dụ 143.198.45.123.

I. Những gì bạn cần chuẩn bị trước khi bắt đầu

Trước khi cài đặt OpenClaw trên VPS, bạn nên chuẩn bị sẵn các thành phần sau:

Một VPS từ nhà cung cấp uy tín như Hostinger, AZDIGI, Vietnix hoặc Tinohost.
Hệ điều hành Ubuntu 24.04 LTS khi tạo máy chủ.
Địa chỉ IP của server sau khi khởi tạo VPS.
Ứng dụng Terminal trên Mac hoặc PowerShell, Command Prompt trên Windows.

II. Kết nối đến server

Bước đầu tiên là đăng nhập vào VPS bằng SSH để bắt đầu thiết lập.

ssh root@YOUR_SERVER_IP

Sau khi chạy lệnh, hệ thống sẽ yêu cầu nhập mật khẩu root của server. Khi gõ mật khẩu, bạn sẽ không thấy ký tự hiện ra, điều này là bình thường.

III. Tạo user mới

Vì lý do bảo mật, bạn không nên chạy mọi thứ bằng tài khoản root. Hãy tạo một user riêng, ví dụ là molt.

Bước 1: Tạo user

adduser molt

Bạn sẽ được yêu cầu tạo mật khẩu và điền một số thông tin tùy chọn. Có thể nhấn Enter để bỏ qua các trường không bắt buộc.

Bước 2: Cấp quyền admin cho user

usermod -aG sudo molt

Bước 3: Chuyển sang user mới

su - molt

Sau bước này, bạn sẽ thao tác với user molt thay vì root.

IV. Cài đặt OpenClaw

Khi đã chuyển sang đúng user, bạn có thể cài OpenClaw bằng script chính thức.

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

Lệnh này sẽ tải về và chạy trình cài đặt OpenClaw. Trong lúc cài, chỉ cần làm theo các chỉ dẫn hiển thị trên terminal.

V. Khởi động OpenClaw Gateway

Gateway là thành phần giúp OpenClaw giao tiếp. Bạn có thể chạy theo một trong hai cách dưới đây.

Cách A: Chạy bằng sudo

sudo -u molt openclaw gateway --bind loopback --port 18789 --verbose

Cách B: Chạy trực tiếp khi đang là user molt

Trước tiên hãy kiểm tra user hiện tại:

whoami

Nếu kết quả là molt, chạy tiếp:

openclaw gateway --port 18789 --verbose

VI. Kết nối từ máy tính cá nhân

Để truy cập OpenClaw từ máy local, bạn cần tạo một SSH tunnel bảo mật.

ssh -N -L 18789:127.0.0.1:18789 molt@YOUR_SERVER_IP

Hãy mở lệnh này trong một cửa sổ terminal mới trên máy tính cá nhân, không phải trên server. Khi sử dụng OpenClaw, bạn cần giữ cửa sổ đó mở.

VII. Thiết lập OpenClaw chạy tự động với systemd

Mặc định, OpenClaw sẽ dừng khi bạn đóng terminal. Nếu muốn dịch vụ chạy ổn định 24/7 và tự khởi động lại sau khi VPS reboot, bạn nên tạo service bằng systemd.

Vì sao phải tìm đường dẫn binary?

Khi gõ openclaw trong terminal, shell có thể dùng PATH để tìm lệnh. Nhưng với systemd, dùng đường dẫn tuyệt đối trong ExecStart sẽ ổn định hơn và tránh lỗi không tìm thấy command.

Cách tìm đường dẫn OpenClaw

Đảm bảo bạn đang ở user molt:

whoami

Sau đó chạy:

which openclaw

Kết quả thường là:

/home/molt/.npm-global/bin/openclaw

Bước 1: Tạo file service

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

Bước 2: Dán nội dung cấu hình

[Unit]
Description=OpenClaw Gateway Service (24/7)
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=molt
WorkingDirectory=/home/molt
Environment=PATH=/home/molt/.npm-global/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
ExecStart=/home/molt/.npm-global/bin/openclaw gateway --bind loopback --port 18789 --verbose
ExecReload=/bin/kill -HUP $MAINPID
Restart=always
RestartSec=5
StartLimitInterval=60s
StartLimitBurst=10

# Security
NoNewPrivileges=yes
PrivateTmp=yes
ProtectSystem=strict
ProtectHome=read-only
ReadWritePaths=/home/molt/.openclaw

StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

Bước 3: Lưu và thoát

Trong nano, nhấn Ctrl + X, sau đó nhấn Y rồi Enter.

Bước 4: Reload và khởi động service

sudo systemctl daemon-reload
sudo systemctl enable openclaw-gateway
sudo systemctl start openclaw-gateway

Bước 5: Kiểm tra trạng thái service

sudo systemctl status openclaw-gateway.service

Nếu cấu hình đúng, bạn sẽ thấy trạng thái active (running).

VIII. Xử lý sự cố

Nếu gặp lỗi trong quá trình cài đặt hoặc vận hành, bạn có thể dùng các lệnh sau để chẩn đoán và xử lý.

Chạy công cụ chẩn đoán

openclaw doctor

Tự động sửa lỗi được phát hiện

openclaw doctor --repair

Khởi động lại gateway service

sudo systemctl restart openclaw-gateway.service

Xem log trực tiếp

sudo journalctl -u openclaw-gateway.service -f

Dừng gateway service

sudo systemctl stop openclaw-gateway.service

Ghi chú: Mỗi server có thể khác nhau về firewall, cấu hình mạng hoặc các package đã cài sẵn. Nếu có lỗi phát sinh ngoài hướng dẫn này, hãy tra cứu đúng thông báo lỗi để xử lý chính xác hơn.

IX. Bảng tham khảo nhanh

Tác vụ	Lệnh
Kết nối đến server	`ssh root@YOUR_SERVER_IP`
Chuyển sang user molt	`su - molt`
Cài đặt OpenClaw	`curl -fsSL https://openclaw.bot/install.sh \| bash`
Khởi động gateway thủ công	`openclaw gateway --port 18789 --verbose`
Tạo SSH tunnel trên máy local	`ssh -N -L 18789:127.0.0.1:18789 molt@YOUR_SERVER_IP`
Kiểm tra trạng thái service	`sudo systemctl status openclaw-gateway.service`
Chạy chẩn đoán	`openclaw doctor`
Sửa lỗi tự động	`openclaw doctor --repair`

Câu hỏi thường gặp

OpenClaw có chạy được trên Ubuntu 24.04 không?

Có. Nội dung trong bài này được viết theo môi trường Ubuntu 24.04 LTS trên VPS.

Vì sao nên tạo user mới thay vì dùng root?

Dùng user riêng sẽ an toàn hơn, hạn chế rủi ro và dễ quản lý quyền hơn khi chạy service nền.

Làm sao để OpenClaw tự chạy sau khi reboot?

Bạn cần cấu hình service bằng systemd, sau đó dùng sudo systemctl enable openclaw-gateway để bật tự khởi động.