Hướng dẫn cài đặt ZeroClaw trên Orange Pi Zero 3 (RAM 1GB)

Bài viết hướng dẫn cài đặt ZeroClaw theo cách thủ công để tối ưu tài nguyên trên Orange Pi Zero 3 bản 1GB RAM.

Phiên bản mới Orange Pi Zero 3

Mặc dù ZeroClaw có thể cài được bằng 1 dòng lệnh, nhưng không khuyến khích cài cách này do bạn sẽ không biết được quá trình cài có những gì để tùy biến. Câu lệnh cài 1 dòng của ZeroClaw như sau

curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash

Còn sau đây là các bước cài theo thứ tự:

1. Cài đặt các gói cần thiết

sudo apt update
sudo apt install build-essential pkg-config

2. Cài đặt Rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Kiểm tra:

rustc --version
cargo --version

3. Cài đặt ZeroClaw từ mã nguồn

Clone repository:

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw

Kiểm tra feature:

./install.sh --list-features

Minimal (khuyến nghị):

./install.sh --minimal

Custom:

./install.sh --minimal --features agent-runtime,channel-discord,channel-telegram

Skip onboarding:

./install.sh --minimal --skip-onboard

Gỡ cài đặt:

./install.sh --uninstall

4. Các lệnh quản trị

# Workspace
zeroclaw onboard
zeroclaw status
zeroclaw doctor

# Runtime
zeroclaw gateway
zeroclaw daemon

# Agent
zeroclaw agent
zeroclaw agent -m "hello"

# Service
zeroclaw service install
zeroclaw service start
zeroclaw service status

# Channel
zeroclaw channel list
zeroclaw channel doctor
zeroclaw channel bind-telegram 123456789

# Cron
zeroclaw cron list
zeroclaw cron add "*/5 * * * *" --prompt "Check system health"

# Memory
zeroclaw memory list
zeroclaw memory stats

# Auth
zeroclaw auth login --provider openai
zeroclaw auth status

# Hardware
zeroclaw hardware discover
zeroclaw peripheral list

5. Web UI quản trị

Nếu bạn sử dụng WebUI sẵn theo của ZeroClaw, bạn chỉnh sửa cấu hình config.toml như sau:

host = 0.0.0.0
allow_public_bind = true

Còn nếu bạn sử dụng WebUI do tôi viết riêng cho ZeroClaw hãy làm các bước sau:

Thoát ra thư mục gốc và clone mã nguồn

cd ~
git clone https://github.com/thanhtantran/zeroclaw-webui


Build client trước

cd zeroclaw-webui/client
npm install && npm run build

Sau đó chạy back-end và để nó chạy trong CLI


cd ..
npm install
npm start

Bạn kiểm tra lại xem đã được chưa?

Truy cập: http://IP_ORANGEPI:3000

Sau đó có thể cấu hình pm2 để backend chạy mỗi khi khởi động

Lưu ý: Nếu bạn dùng WebUI mặc định, đổi port để tránh xung đột. Tốt nhất bạn chọn 1 trong 2 WebUI để sử dụng

Tổng kết

ZeroClaw chạy tốt trên Orange Pi Zero 3 (1GB) nếu tối ưu, nếu sử dụng bản 2GB RAM thì sẽ chạy thêm được nhiều ứng dụng khác như Home Assistant, Pi Hole, AdGuard v.v. và sau đó có thể tự động hóa các ứng dụng này qua ZeroClaw
Nên dùng bản minimal và build các chanel cần thiết, đừng build full vì có thể Orange Pi Zero 3 (1GB) không build được tất cả
Nếu bạn muốn mở rộng thêm agent và channel thì có thể dùng bản prebuilt, hoặc built trên máy tính với giả lập arm64 rồi copy vào Orange Pi Zero 3 để chạy.

Video hướng dẫn