Hướng dẫn cài OpenClaw (MoltBot) trên Orange Pi RV2

Thiết bị: Orange Pi RV2 (RISC-V Spacemit X60) | OS: Ubuntu (Desktop/Server) | Phần mềm: MoltBot (OpenClaw AI Gateway) | Cập nhật: 2026

📋 Mục Lục

1. Chuẩn Bị Hệ Điều Hành
2. Cài Node Version Manager (NVM)
3. Cài NodeJS (v22)
4. Cài Đặt MoltBot
5. Cấu Hình AI Model
6. Cấu Hình Gateway
7. Khởi Động Gateway
8. Test AI Bằng Command Line
9. Truy Cập Giao Diện WebUI
10. Kết Luận

1️⃣ Chuẩn Bị Hệ Điều Hành

Flash Ubuntu Linux cho Orange Pi RV2. Cả bản Desktop lẫn Server đều hoạt động tốt.

Image ví dụ: Orangepirv2_1.0.0_ubuntu_noble_desktop_gnome_linux6.6.63.7z
Ubuntu Noble (24.04) + Kernel 6.6.63

Link tải Google Drive:

https://drive.google.com/drive/folders/1QgQRX-wtvsTJnOoMBVct-g5HLWb7g6n-

Lưu ý: Sau khi flash xong, boot vào Ubuntu, cập nhật hệ thống trước khi tiếp tục:

sudo apt update && sudo apt upgrade -y

2️⃣ Cài Node Version Manager (NVM)

NVM cho phép quản lý nhiều phiên bản Node.js dễ dàng – cần thiết vì MoltBot yêu cầu Node.js chạy trên kiến trúc RISC-V (dùng unofficial builds).

# Tải và chạy script cài NVM (phiên bản 0.39.7)
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Nạp biến môi trường NVM vào shell hiện tại
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion"

# Kiểm tra phiên bản NVM
nvm --version

Khuyến nghị: Thêm 3 dòng export... vào ~/.bashrc hoặc ~/.zshrc để NVM tự load khi mở terminal mới:

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion"' >> ~/.bashrc
source ~/.bashrc

3️⃣ Cài NodeJS (Phiên Bản 22 LTS)

Vì Node.js chính thức chưa có binary RISC-V sẵn, ta dùng unofficial-builds.nodejs.org làm mirror.

# Thiết lập mirror unofficial RISC-V
export NVM_NODEJS_ORG_MIRROR=https://unofficial-builds.nodejs.org/download/release/

# Cài Node 22 LTS và set làm mặc định
nvm install 22 && nvm use 22

# Kiểm tra phiên bản
node -v
# Kết quả mong đợi: v22.x.x (ví dụ v22.14.0)

npm -v
# Kết quả mong đợi: 10.x.x

Lưu ý: Output ví dụ trong hướng dẫn gốc ghi v20.20.2 / 10.8.2 – đó là phiên bản cũ. Hãy dùng Node 22 LTS mới nhất để tương thích tốt hơn.

4️⃣ Cài Đặt MoltBot

# Tạo thư mục làm việc
mkdir -p ~/moltbot && cd ~/moltbot

# Tải bản MoltBot RISC-V64 (beta 2026.1.27)
wget https://cdn-resource.spacemit.com/file/download/moltbot-riscv64-2026.1.27-beta.1.tgz --no-check-certificate

# Giải nén
tar -xzf moltbot-riscv64-2026.1.27-beta.1.tgz

# Chạy script cài đặt
./install.sh

# Khởi tạo cấu hình ban đầu
moltbot setup

Giải thích:

install.sh sẽ cài đặt dependencies, binary, và register command moltbot vào PATH.
moltbot setup tạo thư mục cấu hình ~/.moltbot/ và file config mặc định.

5️⃣ Cấu Hình AI Model

moltbot configure

Wizard tương tác sẽ hiện ra. Chọn theo thứ tự sau:

Gateway location → Local
Sections → Model Provider
Model Provider → Qwen Auth
Qwen Auth → Qwen OAuth

Qwen OAuth cho phép dùng model Qwen miễn phí qua tài khoản Alibaba Cloud / DashScope. Bạn sẽ được dẫn đến trình duyệt để login/authorize.

6️⃣ Cấu Hình Gateway (Network & Auth)

moltbot configure

Chạy lại lệnh configure, lần này cấu hình Gateway:

Gateway port → 18789

Bind mode → LAN (cho phép truy cập từ mạng LAN, không chỉ localhost)

Auth → Token

Token → orangepi (hoặc token tùy chọn của bạn)

File cấu hình được lưu tại:

~/.moltbot/moltbot.json

Bạn có thể chỉnh sửa trực tiếp file JSON này nếu muốn thay đổi nhanh mà không chạy wizard.

7️⃣ Khởi Động Gateway

./start-moltbot.sh gateway --port 18789 --token orangepi

Output mong đợi:

[INFO] Starting MoltBot Gateway on port 18789
[INFO] Auth mode: Token
[INFO] Model provider: Qwen (OAuth)
[INFO] WebUI available at http://0.0.0.0:18789/overview

Mẹo: Chạy trong screen hoặc tmux để giữ tiến trình sống khi đóng SSH:

sudo apt install -y tmux
tmux new -s moltbot
./start-moltbot.sh gateway --port 18789 --token orangepi
# Ctrl+B, D để detach

8️⃣ Test AI Bằng Command Line

moltbot agent --agent main --message "Introduce Orange Pi"

Kết quả mẫu:

> Agent: main
> Message: Introduce Orange Pi

Orange Pi RV2 is a RISC-V single board computer powered by the Spacemit X60 
processor (branded as Ky X1). It features 4GB/8GB LPDDR4X, dual Gigabit Ethernet, 
HDMI 2.0, USB 3.0, and an M.2 NVMe slot. It runs Ubuntu, Debian, Fedora, and 
other Linux distributions on RISC-V architecture...

9️⃣ Truy Cập Giao Diện WebUI

Tìm IP của Orange Pi RV2

ip a
# Hoặc
hostname -I

Truy cập từ máy khác trong cùng LAN

http://IP_ORANGEPI:18789/overview

Thay IP_ORANGEPI bằng địa chỉ IP thực (ví dụ: 192.168.1.100).

Truy cập local (trên chính board)

http://localhost:18789/overview

WebUI cung cấp: Dashboard tổng quan, Chat playground, Model management, Gateway logs, System monitoring.

🔟 Kết Luận

🎉 Chúc mừng! Bạn đã cài đặt thành công OpenClaw (MoltBot) AI Gateway trên Orange Pi RV2.

✅ Ubuntu RISC-V chạy ổn định trên Spacemit X60
✅ Node.js 22 LTS (unofficial RISC-V build)
✅ MoltBot Gateway hoạt động trên port 18789
✅ AI Model: Qwen (qua OAuth)
✅ Truy cập WebUI từ bất kỳ thiết bị nào trong LAN
✅ Test CLI thành công

🚀 Các Bước Tiếp Theo Có Thể Làm

Cấu hình systemd service để MoltBot auto-start khi boot.
Setup reverse proxy (Nginx/Caddy) + HTTPS cho production.
Thêm model khác (Llama, DeepSeek, v.v.) qua Model Provider config.
Tích hợp với Home Assistant, n8n, hoặc custom apps qua REST API.
Monitor tài nguyên: htop, nvtop (nếu có GPU), moltbot logs.

📚 Tài Nguyên Tham Khảo

OpenClaw MoltBot GitHub
MoltBot RISC-V64 Download (Spacemit CDN)
Node.js Unofficial RISC-V Builds
Orange Pi RV2 Ubuntu Images (Google Drive)

Bài viết được biên soạn dựa trên kinh nghiệm thực tế cài đặt trên Orange Pi RV2. Nếu gặp lỗi, hãy kiểm tra log (journalctl -u moltbot hoặc ~/moltbot/logs/) và comment bên dưới để cùng troubleshoot! 🛠️

Tags: Orange Pi RV2 RISC-V Spacemit X60 MoltBot OpenClaw AI Gateway Qwen Node.js Ubuntu SBC