73 lines
16 KiB
JSON
73 lines
16 KiB
JSON
{
|
||
"success": true,
|
||
"data": {
|
||
"markdown": "[Bỏ qua nội dung](https://orangepi.vn/huong-dan-cai-dat-nanobot-tren-orange-pi-4-pro-zero-3w-4gb-ram.html#main)\n\nNanobot 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.\n\nBài viết phù hợp cho:\n\n- Orange Pi 4 Pro\n- Orange Pi Zero 3W 4GB\n- Các SBC Orange Pi khác (tối thiểu 4GB RAM)\n- Cài đặt sẵn hệ điều hành Ubuntu / Debian ARM64\n\n## 1\\. Chuẩn bị môi trường Python 3.11\n\nVì 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.\n\n### Cài Miniconda\n\n```bash\ncurl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-aarch64.sh\n\nbash Miniconda3-latest-Linux-aarch64.sh\n```\n\nSau khi cài xong, reload shell:\n\n```bash\nsource ~/.bashrc\n```\n\nHoặc activate thủ công:\n\n```bash\nconda activate base\n```\n\n### Tạo môi trường Python 3.11\n\n```bash\nconda create -n py311 python=3.11 -y\n```\n\n### Activate môi trường\n\n```bash\nconda activate py311\n```\n\nKhuyến nghị thêm auto activate:\n\n```bash\necho \"conda activate py311\" >> ~/.bashrc\n```\n\n## 2\\. Cài đặt Nanobot\n\nNanobot có thể cài bằng nhiều cách khác nhau.\n\n### Cách 1 — Cài bằng pip (khuyến nghị)\n\n```bash\npip install nanobot-ai\n```\n\n### Cách 2 — Cài bằng UV\n\nUV nhanh hơn pip rất nhiều.\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\nuv tool install nanobot-ai\n```\n\n### Cách 3 — Clone source và build trực tiếp\n\n```bash\ngit clone https://github.com/HKUDS/nanobot.git\n\ncd nanobot\n\npip install -e .\n```\n\n## 3\\. Cài đặt WebUI\n\nMặ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.\n\nRepo này cũng có contribution từ Orange Pi Việt Nam.\n\nRepo: [https://github.com/Good0007/nanobot-webui](https://github.com/Good0007/nanobot-webui)\n\n### Cài đặt nhanh WebUI\n\n```bash\npip install nanobot-webui\n```\n\n### Các lệnh sử dụng WebUI\n\n```bash\n# Foreground\nnanobot-webui start\n\n# Custom port\nnanobot-webui start --port 9090\n\n# Background daemon\nnanobot-webui start -d\n\n# Alias ngắn\nwebui start\n```\n\nTài khoản mặc định:\n\n```\nUsername: admin\nPassword: nanobot\n```\n\n## 4\\. Onboard Nanobot\n\nBạ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\n\n```bash\nnanobot onboard\n```\n\nSau khi cấu hình xong, truy cập WebUI:\n\n```\nhttp://IP_ORANGEPI:18780\n```\n\n## [](https://orangepivn.b-cdn.net/wp-content/uploads/2026/05/Onboard-Nanobot.webp)\n\n## 5\\. Kết nối WhatsApp\n\nNanobot sử dụng bridge NodeJS nội bộ dựa trên Baileys để kết nối WhatsApp.\n\n### Cài NodeJS 22\n\n```bash\ncurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -\n\nsudo apt install -y nodejs\n```\n\n### Login WhatsApp\n\n```bash\nnanobot channels login whatsapp\n```\n\nMã 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.\n\n### Ví dụ cấu hình WhatsApp\n\n```json\n{\n \"channels\": {\n \"whatsapp\": {\n \"enabled\": true,\n \"allowFrom\": [\"+84901234567\"],\n \"groupPolicy\": \"open\"\n }\n }\n}\n```\n\n- **allowFrom**: Danh sách số điện thoại được phép nói chuyện với bot.\n- **groupPolicy = open**: Trả lời mọi tin nhắn.\n- **groupPolicy = mention**: Chỉ trả lời khi được mention.\n\n## 6\\. Chạy Nanobot + WhatsApp\n\nWhatsApp bridge cần chạy song song với gateway/WebUI.\n\nTerminal 1:\n\n```bash\nnanobot channels login whatsapp\n```\n\nTerminal 2:\n\n```bash\nnanobot webui start\n```\n\nNếu bạn nâng cấp Nanobot, hãy rebuild lại connect\n\n```bash\nrm -rf ~/.nanobot/bridge\n\nnanobot channels login whatsapp\n```\n\n## [](https://orangepivn.b-cdn.net/wp-content/uploads/2026/05/Ket-noi-nanobot-voi-Whatsapp.webp)\n\n## 7\\. Một số lỗi thường gặp\n\nLỗi thiếu build tools:\n\n```bash\nsudo apt install build-essential -y\n```\n\nLỗi bridge WhatsApp:\n\n```bash\nrm -rf ~/.nanobot/bridge\n```\n\n## 8\\. Tổng kết\n\nNanobot là một AI Agent framework rất mạnh và phù hợp với các SBC ARM64 như Orange Pi.\n\nKhi 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ẽ.\n\nNgoà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.\n\nVideo hướng dẫn:\n\nHướng dẫn cài đặt Nanobot - YouTube\n\nTap to unmute\n\n[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)\n\n\n\nOrange Pi Vietnam1.83K subscribers\n\n[Watch on](https://www.youtube.com/watch?v=VD_bskZaedE)\n\n[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\")\n\n\n\n##### superadmin\n\n### Để 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)\n\nEmail 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 \\*\n\nBình luận \\*\n\nTên \\*\n\nEmail \\*\n\nTrang web\n\nΔ\n\n- Tìm kiếm:\n\n- [Orange Pi Việt Nam](https://orangepi.vn/)\n - [Giới thiệu về máy tính nhúng](https://orangepi.vn/gioi-thieu-ve-may-tinh-nhung)\n - [Hướng dẫn đặt hàng](https://orangepi.vn/dat-hang-tai-orange-pi-viet-nam)\n - [Chính sách Bảo hành](https://orangepi.vn/chinh-sach-ban-hang-va-bao-hanh)\n - [Thư ủy quyền phân phối tại Việt Nam](https://orangepi.vn/thu-uy-quyen-phan-phoi-tai-viet-nam)\n - [Chính sách bảo mật](https://orangepi.vn/chinh-sach-bao-mat)\n - [Liên hệ](https://orangepi.vn/lien-he)\n- [Shop](https://orangepi.vn/shop)\n - [Bo Mạch Orange Pi](https://orangepi.vn/danh-muc-san-pham/bo-mach-orange-pi)\n - [Chip H3](https://orangepi.vn/tu-khoa-san-pham/chip-h3)\n - [Chip H6](https://orangepi.vn/tu-khoa-san-pham/chip-h6)\n - [RK3399](https://orangepi.vn/tu-khoa-san-pham/chip-rk3399)\n - [RK3588, RK3566](https://orangepi.vn/tu-khoa-san-pham/rk3588)\n - [Chip H616, H618](https://orangepi.vn/tu-khoa-san-pham/chip-h616)\n - [Allwinner A733](https://orangepi.vn/tu-khoa-san-pham/allwinner-a733)\n - [RAM 1GB](https://orangepi.vn/tu-khoa-san-pham/ram-1gb)\n - [RAM 2GB](https://orangepi.vn/tu-khoa-san-pham/ram-2gb)\n - [RAM 4GB](https://orangepi.vn/tu-khoa-san-pham/ram-4gb)\n - [RAM 6GB](https://orangepi.vn/tu-khoa-san-pham/ram-6gb)\n - [RAM 8GB](https://orangepi.vn/tu-khoa-san-pham/ram8gb)\n - [Phụ kiện Orange Pi](https://orangepi.vn/danh-muc-san-pham/phu-kien-orange-pi)\n - [Màn hình](https://orangepi.vn/tu-khoa-san-pham/man-hinh)\n - [Vỏ Mica lắp ghép](https://orangepi.vn/tu-khoa-san-pham/vo-mica)\n - [Vỏ thép kiêm tản nhiệt](https://orangepi.vn/tu-khoa-san-pham/vo-thep)\n - [Vỏ nhôm nhẹ tản nhiệt tốt](https://orangepi.vn/tu-khoa-san-pham/vo-nhom)\n - [Nguồn Orange Pi](https://orangepi.vn/tu-khoa-san-pham/nguon-orange-pi)\n - [Thẻ nhớ microSD](https://orangepi.vn/tu-khoa-san-pham/the-nho-microsd)\n - [Compute Module](https://orangepi.vn/tu-khoa-san-pham/compute-module)\n- [Blog](https://orangepi.vn/blog)\n - [Giới thiệu](https://orangepi.vn/category/gioi-thieu)\n - [Hướng dẫn](https://orangepi.vn/category/huong-dan)\n - [Trình diễn](https://orangepi.vn/category/trinh-dien)\n- [Đăng nhập](https://orangepi.vn/my-account \"Đăng nhập\")\n- [**Hotline: 0923449899**](tel:0923449899)\n\nBạn cần trợ giúp?\n\n[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\")\n\n\n\nOrange Pi Việt NamNhà phân phối chính thức\n\nXin chào! 👋🏼👋🏼👋🏼 Tôi có thể giúp gì được bạn?\n\n- [Hotline](tel:0923449899 \"Hotline\")\n- [Facebook](https://www.facebook.com/orangepivietnam \"Facebook\")\n- [Zalo](https://oa.zalo.me/1687181280533723118 \"Zalo\")\n\n## Đăng nhập\n\nSign In - Google Accounts\n\nContinue with GoogleContinue with Google. Opens in new tab\n\nTên tài khoản hoặc địa chỉ email \\*Bắt buộc\n\nMật khẩu \\*Bắt buộc\n\nGhi nhớ mật khẩuĐăng nhập\n\n[Quên mật khẩu?](https://orangepi.vn/my-account/lost-password)",
|
||
"metadata": {
|
||
"ogLocale": "vi_VN",
|
||
"ogSiteName": "Orange Pi Viet Nam",
|
||
"og:type": "article",
|
||
"article:modified_time": "2026-06-02T09:07:38+00:00",
|
||
"author": "superadmin",
|
||
"twitter:card": "summary_large_image",
|
||
"title": "Hướng dẫn cài đặt Nanobot trên Orange Pi 4 Pro / Zero 3W 4GB RAM - Orange Pi Viet Nam",
|
||
"og:locale": "vi_VN",
|
||
"msapplication-TileImage": "https://orangepivn.b-cdn.net/wp-content/uploads/2025/01/cropped-fb-logo-big-png-270x270.webp",
|
||
"twitter:label1": "Được viết bởi",
|
||
"ogDescription": "Đây là trang Hướng dẫn cài đặt Nanobot trên Orange Pi 4 Pro / Zero 3W 4GB RAM của Orange Pi Viet Nam là nhà phân phối chính thức của Orange Pi tại Việt Nam, chuyên cung cấp máy tính nhúng cho dự án, nghiên cứu, hợp tác, phát triển sản phẩm.",
|
||
"modifiedTime": "2026-06-02T09:07:38+00:00",
|
||
"og:site_name": "Orange Pi Viet Nam",
|
||
"og:description": "Đây là trang Hướng dẫn cài đặt Nanobot trên Orange Pi 4 Pro / Zero 3W 4GB RAM của Orange Pi Viet Nam là nhà phân phối chính thức của Orange Pi tại Việt Nam, chuyên cung cấp máy tính nhúng cho dự án, nghiên cứu, hợp tác, phát triển sản phẩm.",
|
||
"ogTitle": "Hướng dẫn cài đặt Nanobot trên Orange Pi 4 Pro / Zero 3W 4GB RAM - Orange Pi Viet Nam",
|
||
"og:title": "Hướng dẫn cài đặt Nanobot trên Orange Pi 4 Pro / Zero 3W 4GB RAM - Orange Pi Viet Nam",
|
||
"og:image": "https://orangepivn.b-cdn.net/wp-content/uploads/2026/05/Huong-dan-cai-dat-Nanobot.webp",
|
||
"google-site-verification": "aChCo9My21XgiT2Vte3H89FgebzV7TIv4Ol3OkXaIFU",
|
||
"robots": "index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1",
|
||
"twitter:data2": "4 phút",
|
||
"publishedTime": "2026-05-07T09:43:25+00:00",
|
||
"referrer": [
|
||
"no-referrer",
|
||
"origin"
|
||
],
|
||
"og:image:width": "1536",
|
||
"twitter:site": "@orangepi_me",
|
||
"article:publisher": "https://www.facebook.com/orangepivietnam/",
|
||
"ogImage": "https://orangepivn.b-cdn.net/wp-content/uploads/2026/05/Huong-dan-cai-dat-Nanobot.webp",
|
||
"ogUrl": "https://orangepi.vn/huong-dan-cai-dat-nanobot-tren-orange-pi-4-pro-zero-3w-4gb-ram.html",
|
||
"article:published_time": "2026-05-07T09:43:25+00:00",
|
||
"og:image:type": "image/png",
|
||
"twitter:label2": "Ước tính thời gian đọc",
|
||
"og:url": "https://orangepi.vn/huong-dan-cai-dat-nanobot-tren-orange-pi-4-pro-zero-3w-4gb-ram.html",
|
||
"viewport": [
|
||
"width=device-width, initial-scale=1",
|
||
"width=device-width, initial-scale=1",
|
||
"width=device-width, initial-scale=1.0",
|
||
"initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=no"
|
||
],
|
||
"twitter:creator": "@orangepi_me",
|
||
"twitter:data1": "superadmin",
|
||
"description": "Đây là trang Hướng dẫn cài đặt Nanobot trên Orange Pi 4 Pro / Zero 3W 4GB RAM của Orange Pi Viet Nam là nhà phân phối chính thức của Orange Pi tại Việt Nam, chuyên cung cấp máy tính nhúng cho dự án, nghiên cứu, hợp tác, phát triển sản phẩm.",
|
||
"og:image:height": "1024",
|
||
"generator": [
|
||
"dominant-color-images 1.2.1",
|
||
"Site Kit by Google 1.180.0",
|
||
"webp-uploads 2.6.1"
|
||
],
|
||
"language": "vi",
|
||
"favicon": "https://orangepivn.b-cdn.net/wp-content/uploads/2025/01/cropped-fb-logo-big-png-32x32.webp",
|
||
"scrapeId": "019eb413-8c53-72aa-8aab-3135f09721d8",
|
||
"sourceURL": "https://orangepi.vn/huong-dan-cai-dat-nanobot-tren-orange-pi-4-pro-zero-3w-4gb-ram.html",
|
||
"url": "https://orangepi.vn/huong-dan-cai-dat-nanobot-tren-orange-pi-4-pro-zero-3w-4gb-ram.html",
|
||
"statusCode": 200,
|
||
"contentType": "text/html; charset=UTF-8",
|
||
"timezone": "America/New_York",
|
||
"proxyUsed": "basic",
|
||
"cacheState": "miss",
|
||
"indexId": "d993f892-e837-4fbf-9f66-ceead794a782",
|
||
"creditsUsed": 1,
|
||
"concurrencyLimited": false
|
||
}
|
||
},
|
||
"_http_status": 200,
|
||
"_source_url": "https://orangepi.vn/huong-dan-cai-dat-nanobot-tren-orange-pi-4-pro-zero-3w-4gb-ram.html",
|
||
"_scraped_at": "2026-06-11T00:27:27.432044+00:00"
|
||
} |