Hướng dẫn
Bắt đầu từ số 0
4 bước để robot VuiTV của bạn hoạt động hoàn chỉnh.
Tải firmware
Truy cập GitHub Releases hoặc sử dụng Web Flasher trên trang này. Chọn file .zip tương ứng với board của bạn.
Kết nối USB
Cắm ESP32-S3 qua cáp USB-C vào máy tính. Đảm bảo dùng cáp có data (không phải cáp sạc). Nếu board không nhận, thử cổng USB khác hoặc nhấn giữ nút BOOT khi cắm.
Chọn board và Flash
Trong Web Flasher, chọn board "VuiTV Robot" → nhấn Flash. Quá trình nạp mất khoảng 2 phút. Không rút cáp trong khi nạp.
Khởi động lần đầu
Board tự khởi động và phát WiFi "VuiTV-XXXX". Dùng điện thoại kết nối vào WiFi này, trình duyệt sẽ tự mở trang cấu hình. Nhập tên WiFi nhà và mật khẩu → robot sẽ tự kết nối.
Cấu hình Xiaozhi.me
Chuyển sang Tiếng Việt
Nhấn vào nút ngôn ngữ "简体中文" ở góc phải trên → Chọn "Tiếng Việt" từ menu dropdown.
Trang sẽ chuyển sang giao diện tiếng Việt:
Đăng ký / Đăng nhập
Nhấn nút "Bảng điều khiển" → Trang đăng nhập hiện ra. Có 2 cách:
- Số điện thoại: Đổi mã vùng từ +86 sang +84 → Nhập số điện thoại → Nhập mã captcha → Nhấn "Gửi mã" → Nhập OTP → Đăng nhập
- Google: Nhấn nút "Đăng nhập bằng Google" ở dưới cùng
Thêm thiết bị
Sau khi đăng nhập, bạn sẽ vào trang "Các Agent". Nhấn nút "+ Thêm thiết bị" ở góc trái trên.
Hộp thoại "Thêm thiết bị" hiện ra → Nhập 6 chữ số mã kích hoạt hiển thị trên robot khi khởi động → Nhấn "Xác nhận".
Cấu hình vai trò (Agent)
Quay lại trang "Các Agent", nhấn nút "Cấu hình vai trò" trên thiết bị vừa thêm.
Trong trang cấu hình:
- Tên trợ lý: Đặt tên cho robot để xưng hô (VD: "Lily", "Sophia")
- Ngôn ngữ đối thoại: Chọn "Tiếng Việt"
- Vai trò giọng nói: Chọn "越南语女声 / Giọng nữ" hoặc giọng khác
- Giới thiệu vai trò: Viết mô tả tính cách, cách giao tiếp cho robot. Có thể nhờ ChatGPT viết prompt rồi dán vào đây
Nhấn "Lưu" để hoàn tất. Robot sẽ tự kết nối và bắt đầu trò chuyện!
Cài đặt MCP (Tùy chọn)
Trong trang cấu hình Agent, kéo xuống mục "Cài đặt MCP":
- Dịch vụ chính thức: Xoá "Âm nhạc" và "Thời tiết" mặc định (VuiTV đã có sẵn)
- Dịch vụ tùy chỉnh: Nhấn "Lấy điểm cuối MCP" để lấy URL kết nối MCP Server của VuiTV
Sau khi lưu cấu hình, thiết bị cần khởi động lại để các cài đặt mới có hiệu lực.
Tùy chỉnh Wake Word
Mở Quản lý thiết bị
Trong trang "Các Agent", nhấn "Quản lý thiết bị" trên Agent muốn tùy chỉnh. Tìm dòng "Cài đặt chủ đề" → nhấn "Tùy chỉnh".
Cấu hình từ đánh thức
Trang "Xiaozhi AI Tùy chỉnh" mở ra. Ở Bước 2: Thiết kế chủ đề → tab "Cấu hình từ đánh thức":
- Tắt đánh thức: Robot không phản hồi giọng nói (chỉ dùng nút bấm)
- Mặc định: Dùng wake word có sẵn, chọn từ dropdown (VD: "Hi,Lily")
- Tùy chỉnh: Tạo wake word riêng bằng mô hình MultiNet (chỉ ESP32-S3)
Mẹo: Chip S3/P4 hỗ trợ WakeNet9 với nhiều lựa chọn hơn. Từ đánh thức tùy chỉnh sử dụng MultiNet.
Xem trước và Tạo assets.bin
Chuyển sang Bước 3: Xem trước & Tạo. Kiểm tra cấu hình → nhấn nút "Tạo assets.bin".
Xác nhận thông tin (chip ESP32S3, độ phân giải 128×64, từ đánh thức...) → nhấn "Bắt đầu Tạo".
Flash vào thiết bị
Sau khi tạo xong, bạn có 2 lựa chọn:
- "Flash trực tuyến vào thiết bị" — Nạp trực tiếp qua OTA nếu robot đang online
- "Tải xuống assets.bin" — Tải file về máy để flash thủ công qua USB
Sau khi flash, thiết bị tự khởi động lại với wake word mới.
Đăng ký MCP Server
Lấy MCP Endpoint từ Xiaozhi
Trước khi đăng ký, bạn cần lấy MCP Endpoint URL từ Xiaozhi. Trong trang cấu hình Agent → "Cài đặt MCP" → "Dịch vụ tùy chỉnh" → nhấn "Lấy điểm cuối MCP".
Sao chép URL dạng: wss://api.xiaozhi.me/mcp/?token=eyJhb...
Đăng ký thiết bị
Quay lại mcp.vuitv.dev, nhập thông tin:
- Tên thiết bị: Đặt tên dễ nhớ (VD: "Robot phòng khách")
- MCP Endpoint URL: Dán URL vừa copy từ Xiaozhi
Nhấn "⚡ Kết nối thiết bị" → Chờ admin duyệt. Bạn sẽ nhận thông báo khi được kích hoạt.
Sử dụng
Sau khi được duyệt, hỏi robot: "Giá vàng hôm nay?", "Thời tiết Hà Nội?", "Dịch hello sang tiếng Việt" — robot tự gọi tool phù hợp và trả lời.