Khóa học Generative AI thực chiến
Dành cho CxO, Giám Đốc, chủ doanh nghiệp

Hướng dẫn cài đặt Openclaw trên vps

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

Trước khi bắt đầu, hãy đảm bảo bạn đã có sẵn các thành phần sau:

  • Một VPS (Máy Chủ Ảo) — Khuyến nghị sử dụng Hostinger VPS hoặc các nhà cung cấp uy tín tại Việt Nam như AZDIGI, Vietnix, Tinohost
  • Hệ điều hành: Ubuntu 24.04 LTS (chọn khi thiết lập VPS)
  • Địa chỉ IP của server (bạn sẽ nhận được từ nhà cung cấp VPS sau khi tạo xong)
  • Ứng dụng Terminal (Terminal trên Mac, PowerShell hoặc Command Prompt trên Windows)

 

💡 Mẹo nhanh: Bất cứ nơi nào bạn thấy YOUR_SERVER_IP, hãy thay thế bằng địa chỉ IP thực của server (ví dụ: 143.198.45.123).

 

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

Bước này giúp bạn truy cập vào server để bắt đầu thiết lập.

Bạn đang làm gì: Đăng nhập vào server từ xa bằng SSH (Secure Shell).

ssh root@YOUR_SERVER_IP

Sau khi chạy lệnh này, bạn sẽ được yêu cầu nhập mật khẩu root của server. Hãy gõ mật khẩu (bạn sẽ không thấy ký tự hiện lên khi gõ — điều đó là bình thường) rồi nhấn Enter.

 

III. Tạo User mới

Vì lý do bảo mật, chúng ta không nên chạy mọi thứ dưới quyền “root”. Thay vào đó, ta sẽ tạo một user riêng có tên “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

Bây giờ bạn đang hoạt động với tư cách user “molt” thay vì root.

 

IV. Cài đặt Openclaw

Bây giờ chúng ta sẽ cài đặt Openclaw lên server.

Chạy script cài đặt:

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 chính thức. Hãy làm theo các hướng dẫn hiện trên màn hình để hoàn tất quá trình thiết lập ban đầu.

 

V. Khởi động Openclaw Gateway

Gateway là thành phần cho phép Openclaw giao tiếp. Dưới đây là một số cách để khởi động:

Cách A: Khởi động với sudo (nếu cần quyền)

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

Cách B: Khởi động không cần sudo

Trước tiên, kiểm tra bạn đang đăng nhập với user nào:

whoami

Nếu kết quả hiện “molt”, bạn có thể chạy:

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 tính cá nhân, bạn cần tạo một tunnel bảo mật.

Mở một cửa sổ Terminal MỚI trên máy tính cá nhân (không phải trên server) và chạy:

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

Lệnh này tạo một tunnel để máy tính của bạn có thể kết nối với Openclaw trên server. Hãy giữ cửa sổ Terminal này mở khi đang sử dụng Openclaw.

 

VII. Thiết lập Openclaw chạy tự động (Khuyến nghị)

Theo mặc định, Openclaw sẽ dừng khi bạn đóng Terminal. Phần này giúp Openclaw chạy 24/7, kể cả sau khi server khởi động lại.

Tại sao cần tìm đường dẫn Binary?

Trước khi tạo file service, bạn cần kiểm tra Openclaw được cài đặt ở đâu trên hệ thống. Lý do là vì systemd (công cụ quản lý dịch vụ tự động) cần đường dẫn tuyệt đối trong ExecStart, không chỉ là lệnh “openclaw”.

Tại sao điều này quan trọng?

  • Khi gõ openclaw … trong Terminal, shell sẽ sử dụng PATH để tìm binary.
  • Trong systemd unit, ExecStart=openclaw … thường sẽ bị lỗi — systemd không tìm kiếm PATH giống như shell thông thường.
  • Cung cấp đường dẫn chính xác giúp tránh lỗi “command not found” khi boot và đảm bảo dịch vụ hoạt động ổn định.

Cách tìm đường dẫn (với user molt):

Trên VPS, đảm bảo bạn đang đăng nhập với user molt:

whoami

Kết quả phải là: molt

Sau đó tìm đường dẫn cài đặt Openclaw:

which openclaw

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

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

Đường dẫn này sẽ được sử dụng trong dòng ExecStart của file service:

ExecStart=/home/molt/.npm-global/bin/openclaw gateway –bind loopback –port 18789 –verbose

Tạo Service File

Bước 1: Tạo file service

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

Bước 2: Dán cấu hình sau vào editor

Copy toàn bộ khối sau và dán vào editor:

[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

Nhấn Ctrl + X, sau đó Y, rồi Enter.

Bước 4: Kích hoạt và khởi động service (làm từng lệnh và enter)

# 4.1 Reload systemd

sudo systemctl daemon-reload

# 4.2 Enable auto-start on boot

sudo systemctl enable openclaw-gateway

# 4.3 Start ngay

sudo systemctl start openclaw-gateway

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

sudo systemctl status openclaw-gateway.service

Bạn sẽ thấy “active (running)” hiển thị màu xanh.

 

 

VIII. Xử lý sự cố

Nếu gặp sự cố, các lệnh sau có thể giúp bạn khắc phục.

 

📌 Lưu ý: Mỗi server có cấu hình khác nhau. Kinh nghiệm của bạn có thể khác tùy theo cấu hình port, hệ điều hành, hoặc các thiết lập trước đó. Nếu bạn gặp khó khăn mà hướng dẫn này không giải quyết được, hãy thử tra cứu lỗi cụ thể trên Perplexity AI hoặc ChatGPT.

 

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

openclaw doctor

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

openclaw doctor –repair

Khởi động lại gateway service:

sudo systemctl restart openclaw-gateway.service

Xem log trực tiếp để theo dõi hoạt động:

sudo journalctl -u moltbot-gateway.service -f

Dừng gateway service:

sudo systemctl stop openclaw-gateway.service

 

IX. Bảng tham khảo nhanh

 

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

 

Nguồn: The AI Growth & GTV SEO