318 lines
11 KiB
Markdown
318 lines
11 KiB
Markdown
Nanobot là một AI Agent framework hỗ trợ nhiều channel như WebUI, WhatsApp và có khả năng mở rộng mạnh mẽ. Trong bài viết này, chúng ta sẽ cài đặt Nanobot trên các dòng SBC ARM64 như Orange Pi 4 Pro hoặc Orange Pi Zero 3W 4GB RAM chạy Ubuntu/Debian.
|
||
|
||
Bài viết phù hợp cho:
|
||
|
||
- Orange Pi 4 Pro
|
||
- Orange Pi Zero 3W 4GB
|
||
- Các SBC Orange Pi khác (tối thiểu 4GB RAM)
|
||
- Cài đặt sẵn hệ điều hành Ubuntu / Debian ARM64
|
||
|
||
## 1\. Chuẩn bị môi trường Python 3.11
|
||
|
||
Vì Nanobot được viết bằng Python và yêu cầu Python 3.11 trở lên, nên cách tối ưu và sạch nhất là sử dụng Miniconda.
|
||
|
||
### Cài Miniconda
|
||
|
||
```bash
|
||
curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-aarch64.sh
|
||
|
||
bash Miniconda3-latest-Linux-aarch64.sh
|
||
```
|
||
|
||
Sau khi cài xong, reload shell:
|
||
|
||
```bash
|
||
source ~/.bashrc
|
||
```
|
||
|
||
Hoặc activate thủ công:
|
||
|
||
```bash
|
||
conda activate base
|
||
```
|
||
|
||
### Tạo môi trường Python 3.11
|
||
|
||
```bash
|
||
conda create -n py311 python=3.11 -y
|
||
```
|
||
|
||
### Activate môi trường
|
||
|
||
```bash
|
||
conda activate py311
|
||
```
|
||
|
||
Khuyến nghị thêm auto activate:
|
||
|
||
```bash
|
||
echo "conda activate py311" >> ~/.bashrc
|
||
```
|
||
|
||
## 2\. Cài đặt Nanobot
|
||
|
||
Nanobot có thể cài bằng nhiều cách khác nhau.
|
||
|
||
### Cách 1 — Cài bằng pip (khuyến nghị)
|
||
|
||
```bash
|
||
pip install nanobot-ai
|
||
```
|
||
|
||
### Cách 2 — Cài bằng UV
|
||
|
||
UV nhanh hơn pip rất nhiều.
|
||
|
||
```bash
|
||
curl -LsSf https://astral.sh/uv/install.sh | sh
|
||
|
||
uv tool install nanobot-ai
|
||
```
|
||
|
||
### Cách 3 — Clone source và build trực tiếp
|
||
|
||
```bash
|
||
git clone https://github.com/HKUDS/nanobot.git
|
||
|
||
cd nanobot
|
||
|
||
pip install -e .
|
||
```
|
||
|
||
## 3\. Cài đặt WebUI
|
||
|
||
Mặc dù Nanobot có WebUI mặc định, nhưng mình khuyến khích sử dụng repo WebUI độc lập này vì giao diện đẹp hơn, quản trị dễ hơn và có nhiều tính năng hơn.
|
||
|
||
Repo này cũng có contribution từ Orange Pi Việt Nam.
|
||
|
||
Repo: [https://github.com/Good0007/nanobot-webui](https://github.com/Good0007/nanobot-webui)
|
||
|
||
### Cài đặt nhanh WebUI
|
||
|
||
```bash
|
||
pip install nanobot-webui
|
||
```
|
||
|
||
### Các lệnh sử dụng WebUI
|
||
|
||
```bash
|
||
# Foreground
|
||
nanobot-webui start
|
||
|
||
# Custom port
|
||
nanobot-webui start --port 9090
|
||
|
||
# Background daemon
|
||
nanobot-webui start -d
|
||
|
||
# Alias ngắn
|
||
webui start
|
||
```
|
||
|
||
Tài khoản mặc định:
|
||
|
||
```
|
||
Username: admin
|
||
Password: nanobot
|
||
```
|
||
|
||
## 4\. Onboard Nanobot
|
||
|
||
Bạn cần khởi động onboard nanobot để khởi tạo các thông tin như config, api, v.v. Tại màn hình câu lệnh đánh lệnh
|
||
|
||
```bash
|
||
nanobot onboard
|
||
```
|
||
|
||
Sau khi cấu hình xong, truy cập WebUI:
|
||
|
||
```
|
||
http://IP_ORANGEPI:18780
|
||
```
|
||
|
||
## [](https://orangepivn.b-cdn.net/wp-content/uploads/2026/05/Onboard-Nanobot.webp)
|
||
|
||
## 5\. Kết nối WhatsApp
|
||
|
||
Nanobot sử dụng bridge NodeJS nội bộ dựa trên Baileys để kết nối WhatsApp.
|
||
|
||
### Cài NodeJS 22
|
||
|
||
```bash
|
||
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
|
||
|
||
sudo apt install -y nodejs
|
||
```
|
||
|
||
### Login WhatsApp
|
||
|
||
```bash
|
||
nanobot channels login whatsapp
|
||
```
|
||
|
||
Mã QR sẽ xuất hiện trong terminal. Trên điện thoại mở WhatsApp → Cài đặt → Thiết bị được liên kết → Liên kết thiết bị → quét mã QR.
|
||
|
||
### Ví dụ cấu hình WhatsApp
|
||
|
||
```json
|
||
{
|
||
"channels": {
|
||
"whatsapp": {
|
||
"enabled": true,
|
||
"allowFrom": ["+84901234567"],
|
||
"groupPolicy": "open"
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
- **allowFrom**: Danh sách số điện thoại được phép nói chuyện với bot.
|
||
- **groupPolicy = open**: Trả lời mọi tin nhắn.
|
||
- **groupPolicy = mention**: Chỉ trả lời khi được mention.
|
||
|
||
## 6\. Chạy Nanobot + WhatsApp
|
||
|
||
WhatsApp bridge cần chạy song song với gateway/WebUI.
|
||
|
||
Terminal 1:
|
||
|
||
```bash
|
||
nanobot channels login whatsapp
|
||
```
|
||
|
||
Terminal 2:
|
||
|
||
```bash
|
||
nanobot webui start
|
||
```
|
||
|
||
Nếu bạn nâng cấp Nanobot, hãy rebuild lại connect
|
||
|
||
```bash
|
||
rm -rf ~/.nanobot/bridge
|
||
|
||
nanobot channels login whatsapp
|
||
```
|
||
|
||
## [](https://orangepivn.b-cdn.net/wp-content/uploads/2026/05/Ket-noi-nanobot-voi-Whatsapp.webp)
|
||
|
||
## 7\. Một số lỗi thường gặp
|
||
|
||
Lỗi thiếu build tools:
|
||
|
||
```bash
|
||
sudo apt install build-essential -y
|
||
```
|
||
|
||
Lỗi bridge WhatsApp:
|
||
|
||
```bash
|
||
rm -rf ~/.nanobot/bridge
|
||
```
|
||
|
||
## 8\. Tổng kết
|
||
|
||
Nanobot là một AI Agent framework rất mạnh và phù hợp với các SBC ARM64 như Orange Pi.
|
||
|
||
Khi kết hợp với RK3588, RK3566, NPU, Local LLM, Home Assistant hoặc WhatsApp thì có thể xây dựng các AI Agent Edge cực kỳ mạnh mẽ.
|
||
|
||
Ngoài các tính năng trong bài viết, Nanobot còn rất nhiều khả năng khác mà bạn có thể tiếp tục khám phá thêm.
|
||
|
||
Video hướng dẫn:
|
||
|
||
Hướng dẫn cài đặt Nanobot - YouTube
|
||
|
||
Tap to unmute
|
||
|
||
[Hướng dẫn cài đặt Nanobot](https://www.youtube.com/watch?v=VD_bskZaedE) [Orange Pi Vietnam](https://www.youtube.com/channel/UCl0lVmXFHAhZybuOIzu2CaA)
|
||
|
||
|
||
|
||
Orange Pi Vietnam1.83K subscribers
|
||
|
||
[Watch on](https://www.youtube.com/watch?v=VD_bskZaedE)
|
||
|
||
[Chia sẻ trên WhatsApp](whatsapp://send?text=H%C6%B0%E1%BB%9Bng%20d%E1%BA%ABn%20c%C3%A0i%20%C4%91%E1%BA%B7t%20Nanobot%20tr%C3%AAn%20Orange%20Pi%204%20Pro%20%2F%20Zero%203W%204GB%20RAM%20-%20https://orangepi.vn/huong-dan-cai-dat-nanobot-tren-orange-pi-4-pro-zero-3w-4gb-ram.html "Chia sẻ trên WhatsApp")[Chia sẻ trên Facebook](https://www.facebook.com/sharer.php?u=https://orangepi.vn/huong-dan-cai-dat-nanobot-tren-orange-pi-4-pro-zero-3w-4gb-ram.html "Chia sẻ trên Facebook")[Chia sẻ trên Twitter](https://twitter.com/share?url=https://orangepi.vn/huong-dan-cai-dat-nanobot-tren-orange-pi-4-pro-zero-3w-4gb-ram.html "Chia sẻ trên Twitter")[Gửi email cho bạn bè](mailto:?subject=H%C6%B0%E1%BB%9Bng%20d%E1%BA%ABn%20c%C3%A0i%20%C4%91%E1%BA%B7t%20Nanobot%20tr%C3%AAn%20Orange%20Pi%204%20Pro%20%2F%20Zero%203W%204GB%20RAM&body=Xem%20n%C3%A0y%3A%20https%3A%2F%2Forangepi.vn%2Fhuong-dan-cai-dat-nanobot-tren-orange-pi-4-pro-zero-3w-4gb-ram.html "Gửi email cho bạn bè")[Ghim trên Pinterest](https://pinterest.com/pin/create/button?url=https://orangepi.vn/huong-dan-cai-dat-nanobot-tren-orange-pi-4-pro-zero-3w-4gb-ram.html&media=https://orangepi.vn/wp-content/uploads/2026/05/Huong-dan-cai-dat-Nanobot-1200x800.webp&description=H%C6%B0%E1%BB%9Bng%20d%E1%BA%ABn%20c%C3%A0i%20%C4%91%E1%BA%B7t%20Nanobot%20tr%C3%AAn%20Orange%20Pi%204%20Pro%20%2F%20Zero%203W%204GB%20RAM "Ghim trên Pinterest")[Chia sẻ trên LinkedIn](https://www.linkedin.com/shareArticle?mini=true&url=https://orangepi.vn/huong-dan-cai-dat-nanobot-tren-orange-pi-4-pro-zero-3w-4gb-ram.html&title=H%C6%B0%E1%BB%9Bng%20d%E1%BA%ABn%20c%C3%A0i%20%C4%91%E1%BA%B7t%20Nanobot%20tr%C3%AAn%20Orange%20Pi%204%20Pro%20%2F%20Zero%203W%204GB%20RAM "Chia sẻ trên LinkedIn")
|
||
|
||
|
||
|
||
##### superadmin
|
||
|
||
### Để lại một bình luận [Hủy](https://orangepi.vn/huong-dan-cai-dat-nanobot-tren-orange-pi-4-pro-zero-3w-4gb-ram.html\#respond)
|
||
|
||
Email của bạn sẽ không được hiển thị công khai.Các trường bắt buộc được đánh dấu \*
|
||
|
||
Bình luận \*
|
||
|
||
Tên \*
|
||
|
||
Email \*
|
||
|
||
Trang web
|
||
|
||
Δ
|
||
|
||
- Tìm kiếm:
|
||
|
||
- [Orange Pi Việt Nam](https://orangepi.vn/)
|
||
- [Giới thiệu về máy tính nhúng](https://orangepi.vn/gioi-thieu-ve-may-tinh-nhung)
|
||
- [Hướng dẫn đặt hàng](https://orangepi.vn/dat-hang-tai-orange-pi-viet-nam)
|
||
- [Chính sách Bảo hành](https://orangepi.vn/chinh-sach-ban-hang-va-bao-hanh)
|
||
- [Thư ủy quyền phân phối tại Việt Nam](https://orangepi.vn/thu-uy-quyen-phan-phoi-tai-viet-nam)
|
||
- [Chính sách bảo mật](https://orangepi.vn/chinh-sach-bao-mat)
|
||
- [Liên hệ](https://orangepi.vn/lien-he)
|
||
- [Shop](https://orangepi.vn/shop)
|
||
- [Bo Mạch Orange Pi](https://orangepi.vn/danh-muc-san-pham/bo-mach-orange-pi)
|
||
- [Chip H3](https://orangepi.vn/tu-khoa-san-pham/chip-h3)
|
||
- [Chip H6](https://orangepi.vn/tu-khoa-san-pham/chip-h6)
|
||
- [RK3399](https://orangepi.vn/tu-khoa-san-pham/chip-rk3399)
|
||
- [RK3588, RK3566](https://orangepi.vn/tu-khoa-san-pham/rk3588)
|
||
- [Chip H616, H618](https://orangepi.vn/tu-khoa-san-pham/chip-h616)
|
||
- [Allwinner A733](https://orangepi.vn/tu-khoa-san-pham/allwinner-a733)
|
||
- [RAM 1GB](https://orangepi.vn/tu-khoa-san-pham/ram-1gb)
|
||
- [RAM 2GB](https://orangepi.vn/tu-khoa-san-pham/ram-2gb)
|
||
- [RAM 4GB](https://orangepi.vn/tu-khoa-san-pham/ram-4gb)
|
||
- [RAM 6GB](https://orangepi.vn/tu-khoa-san-pham/ram-6gb)
|
||
- [RAM 8GB](https://orangepi.vn/tu-khoa-san-pham/ram8gb)
|
||
- [Phụ kiện Orange Pi](https://orangepi.vn/danh-muc-san-pham/phu-kien-orange-pi)
|
||
- [Màn hình](https://orangepi.vn/tu-khoa-san-pham/man-hinh)
|
||
- [Vỏ Mica lắp ghép](https://orangepi.vn/tu-khoa-san-pham/vo-mica)
|
||
- [Vỏ thép kiêm tản nhiệt](https://orangepi.vn/tu-khoa-san-pham/vo-thep)
|
||
- [Vỏ nhôm nhẹ tản nhiệt tốt](https://orangepi.vn/tu-khoa-san-pham/vo-nhom)
|
||
- [Nguồn Orange Pi](https://orangepi.vn/tu-khoa-san-pham/nguon-orange-pi)
|
||
- [Thẻ nhớ microSD](https://orangepi.vn/tu-khoa-san-pham/the-nho-microsd)
|
||
- [Compute Module](https://orangepi.vn/tu-khoa-san-pham/compute-module)
|
||
- [Blog](https://orangepi.vn/blog)
|
||
- [Giới thiệu](https://orangepi.vn/category/gioi-thieu)
|
||
- [Hướng dẫn](https://orangepi.vn/category/huong-dan)
|
||
- [Trình diễn](https://orangepi.vn/category/trinh-dien)
|
||
- [Đăng nhập](https://orangepi.vn/my-account "Đăng nhập")
|
||
- [**Hotline: 0923449899**](tel:0923449899)
|
||
|
||
Bạn cần trợ giúp?
|
||
|
||
[Messenger](https://m.me/orangepivietnam "Messenger") [Zalo Official Account](https://oa.zalo.me/1687181280533723118 "Zalo Official Account") [Telegram](https://t.me/maytinhnhung "Telegram") [Whatsapp](https://api.whatsapp.com/send?phone=84923449899 "Whatsapp")
|
||
|
||
|
||
|
||
Orange Pi Việt NamNhà phân phối chính thức
|
||
|
||
Xin chào! 👋🏼👋🏼👋🏼 Tôi có thể giúp gì được bạn?
|
||
|
||
- [Hotline](tel:0923449899 "Hotline")
|
||
- [Facebook](https://www.facebook.com/orangepivietnam "Facebook")
|
||
- [Zalo](https://oa.zalo.me/1687181280533723118 "Zalo")
|
||
|
||
## Đăng nhập
|
||
|
||
Sign In - Google Accounts
|
||
|
||
Continue with GoogleContinue with Google. Opens in new tab
|
||
|
||
Tên tài khoản hoặc địa chỉ email \*Bắt buộc
|
||
|
||
Mật khẩu \*Bắt buộc
|
||
|
||
Ghi nhớ mật khẩuĐăng nhập
|
||
|
||
[Quên mật khẩu?](https://orangepi.vn/my-account/lost-password) |