Hướng dẫn
Cài đặt robot VuiTV nhanh nhất cho người mới
Đi theo luồng chính: nạp firmware nếu cần → kết nối Wi‑Fi VuiTV → thêm thiết bị trên Xiaozhi. Wake word và MCP là phần tuỳ chọn, có thể làm sau khi robot đã nói chuyện ổn định.
Hướng dẫn lắp VuiTV Robot V1
Chi tiết khung đồng, motor, ESP32-S3, driver, OLED và test nguồn sau mỗi bước.
Hướng dẫn lắp VuiTV Robot V2
Nâng cấp TOF050C, bi lăn, khung xuyến và PCB chồng tầng.
Luồng cài đặt khuyến nghị
Nạp firmware
Chỉ làm nếu robot chưa có firmware.
Cấu hình Wi‑Fi
Bắt buộc để robot có Internet.
Thêm Xiaozhi
Nhập mã kích hoạt 6 số.
Tuỳ chọn
Wake word và MCP làm sau.
1. Nạp firmware
nếu robot chưa nạp sẵnMở trang Firmware trên máy tính
Truy cập iot.vuitv.dev → đăng nhập → vào mục Firmware.
Yêu cầu: dùng Chrome hoặc Edge vì cần Web Serial. Safari/Firefox không hỗ trợ.
Cắm ESP32-S3 bằng cáp USB-C data
- Dùng cáp có truyền dữ liệu, không dùng cáp chỉ sạc.
- Nếu máy không nhận board, giữ nút BOOT khi cắm USB.
Chọn board và nạp
- Chọn board VuiTV Robot hoặc board đúng phiên bản.
- Nhấn Nạp firmware.
- Chọn cổng Serial của ESP32 và chờ 2–3 phút.
Sau khi nạp xong robot sẽ reset. Nếu robot đã có firmware sẵn, bỏ qua phần này và sang Wi‑Fi.
2. Cấu hình Wi‑Fi cho robot
bắt buộcKết nối vào Wi‑Fi tạm của robot
Sau khi robot khởi động, robot phát Wi‑Fi dạng VuiTV-XXXX. Trên iPhone/Android, mở phần Wi‑Fi và chọn mạng đó.
Ví dụ trong ảnh: mạng VuiTV-D679. Đây là Wi‑Fi cấu hình tạm của robot, không phải Wi‑Fi Internet.
Mở trang cấu hình 192.168.4.1
Điện thoại thường tự mở trang Wi‑Fi xác thực. Nếu không tự mở, mở trình duyệt và vào:
192.168.4.1Chọn đúng Wi‑Fi 2.4 GHz trong danh sách quét
Trong tab Cấu hình Wi‑Fi, chọn mạng 2.4 GHz từ danh sách bên dưới. Ưu tiên mạng có tín hiệu Mạnh, ví dụ 3105A.
- Không chọn mạng 5 GHz vì nhiều board ESP32 không kết nối được.
- Nếu thấy cùng tên Wi‑Fi xuất hiện nhiều lần, chọn dòng có tín hiệu mạnh hơn, ví dụ -53 dBm tốt hơn -74 dBm.
- Nhập mật khẩu Wi‑Fi nhà, để trống nếu Wi‑Fi không có mật khẩu.
Nhấn Kết nối Wi‑Fi
Sau khi nhập mật khẩu, nhấn Kết nối Wi‑Fi. Không tắt nguồn robot trong lúc lưu cấu hình.
Chờ robot lưu cấu hình và khởi động lại
Khi thấy màn hình Đã lưu cấu hình hoặc Thiết bị sắp khởi động lại, robot sẽ tự reboot để vào Wi‑Fi mới.
Nếu trang không tự đóng, có thể bấm đóng cửa sổ và chờ robot xuất hiện trên mạng Wi‑Fi nhà.
Kiểm tra robot đã online
Khi robot kết nối Internet thành công, màn hình/loa sẽ chuyển sang trạng thái chờ hoặc hiển thị mã kích hoạt 6 số để thêm vào Xiaozhi.
3. Thêm robot vào Xiaozhi.me
luồng chínhTruy cập Xiaozhi và chuyển Tiếng Việt
Mở xiaozhi.me. Nếu đang tiếng Trung, đổi ngôn ngữ sang Tiếng Việt.
Đăng nhập
Nhấn Bảng điều khiển rồi đăng nhập. Người mới nên dùng Đăng nhập bằng Google để nhanh nhất.
Thêm thiết bị bằng mã kích hoạt
Vào trang Các Agent → nhấn + Thêm thiết bị → nhập 6 chữ số mã kích hoạt hiển thị trên robot.
Cấu hình vai trò cơ bản
- Đặt tên trợ lý, ví dụ Lily hoặc Sophia.
- Chọn Tiếng Việt cho ngôn ngữ đối thoại.
- Chọn giọng nói tiếng Việt nếu có.
Đến đây robot đã đủ để nói chuyện cơ bản. Wake word và MCP có thể cấu hình sau.
Mở Quản lý thiết bị
Trong trang Các Agent, nhấn Quản lý thiết bị → Cài đặt chủ đề → Tùy chỉnh.
Cấu hình từ đánh thức
Ở tab Cấu hình từ đánh thức, chọn mặc định hoặc tự tạo wake word riêng. Người mới nên dùng wake word mặc định trước.
Tạo và flash assets.bin
Kiểm tra cấu hình → tạo assets.bin → flash online hoặc tải xuống để nạp thủ công.
Lấy MCP Endpoint từ Xiaozhi
Trong 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.
URL có dạng wss://api.xiaozhi.me/mcp/?token=.... Không chia sẻ URL này công khai.
Đăng ký trên VuiTV MCP
Mở mcp.vuitv.dev, nhập tên thiết bị và dán MCP Endpoint. Sau khi được duyệt, robot có thể gọi tool.