Cấu hình WiFi và thêm thiết bị Xiaozhi vào xiaozhi.me

Bài viết dịch và biên soạn từ tài liệu chính thức Xiaozhi AI Encyclopedia (Feishu).

Tổng quan

Phần 6 — sau khi nạp firmware, cấu hình Wi-Fi và thêm thiết bị lên xiaozhi.me.

1. Khởi động thiết bị

Sau nạp firmware, cấp nguồn và nhấn RST (firmware ≥0.3.1 tự chạy, không cần RST). Thiết bị vào chế độ cấu hình mạng.

2. Trạng thái cấu hình mạng

• Đèn RGB xanh dương nhấp nháy = đang chờ cấu hình Wi-Fi
• Đèn không sáng → xem mục 4 bên dưới

3. Cấu hình lại Wi-Fi

• Firmware ≥0.2.2: sau 3 lần kết nối Wi-Fi cũ thất bại → tự vào lại chế độ cấu hình
• Firmware mới: giữ BOOT khi khởi động → bỏ qua Wi-Fi đã lưu
• Firmware cũ <0.2.2: giữ nút cấu hình (GPIO1–GND) + RST

4. Các bước cấu hình Wi-Fi

Bước 1: Kết nối hotspot Xiaozhi-XXXX

Điện thoại/PC kết nối Wi-Fi Xiaozhi-XXXX. Đợi trang cấu hình tự mở. Nếu không, mở trình duyệt: http://192.168.4.1 (không đổi sang mạng khác).

Bước 2: Chọn mạng Wi-Fi

Chọn mạng 2.4 GHz từ danh sách quét (iPhone hotspot: bật Maximum Compatibility). Nhập mật khẩu → Connect. Đợi ~5 giây khi quét mạng.

Bước 3: Hoàn tất

Thành công → hiện Login success → thiết bị tự khởi động lại sau 3 giây.

5. Thêm thiết bị lên xiaozhi.me

1. Đăng ký/đăng nhập xiaozhi.me
2. Tạo Agent mới (智能体) nếu chưa có — một Agent dùng được trên nhiều thiết bị
3. Chọn Thêm thiết bị → nhập 6 chữ số Device ID (hiện trên màn hình/serial)
4. Hoặc: Agent → Quản lý thiết bị → + Thêm thiết bị

Thiết bị tự kích hoạt sau khi thêm — hiện tại server test miễn phí.

6. Wi-Fi yếu / không thấy Xiaozhi-XXXX

Xác nhận firmware nạp đúng, đèn RGB nhấp nháy xanh. Một số lô board kém chất lượng có Wi-Fi yếu:

• Cuộn dây mềm 3 vòng quanh vùng ăng-ten ESP32-S3
• Tạm thời đặt gần router hoặc chạm tay vào ăng-ten khi cấu hình

7. Đèn RGB không sáng

Board chưa hàn cầu nối RGB (vị trí 2 trên sơ đồ) — hàn hoặc nhờ tiệm sửa điện thoại. Không ảnh hưởng chức năng chính nhưng mất chỉ báo trạng thái.