Hướng dẫn thiết lập terminal XTERM
Mỗi học viên được cấp một máy chủ riêng, phòng lab Node-RED và Google Gemini CLI đã cài sẵn. Hãy bảo mật API key, dán vào terminal, gửi một tin nhắn ngắn và xác nhận trợ lý AI đã kết nối. Hoàn tất các bước trên trang này, sau đó dùng nút hoàn thành ở phía trên hoạt động này để mở khóa nhiệm vụ tiếp theo.
- Máy chủ AI cá nhân (có WebTerminal với chế độ Trò chuyện và Thoại) + bộ nhớ liên tục
- Gemini + Claude CLI được cài đặt sẵn (AI Chế độ Cloud Bot)
- Ngăn xếp tự động hóa Node-RED cá nhân
- Xác nhận đăng nhập terminal từ ngăn tin nhắn (tài khoản
admin) - Tạo khóa API Gemini trên aistudio.google.com và dán vào terminal
- Ra lệnh cho Gemini xây dựng quy trình Node-RED ban đầu
Cần đăng nhập lại WebTerminal (VNC + XTerm) hoặc Node-RED? Nhấp vào biểu tượng bong bóng lời nói ở trên cùng bên phải Chuyển đổi ngăn nhắn tin Tin nhắn của quản trị viên chứa tất cả URL và mật khẩu. Nếu có câu hỏi, hãy trả lời ngay tại đó bất cứ lúc nào.

Mở tin nhắn, đăng nhập admin và xác nhận chat Gemini đã sẵn sàng
Tạo khóa trong AI Studio, dán vào terminal rồi nhấn Enter (trên bàn phím hoặc nút Enter của terminal).
Gửi lời chào ngắn (ví dụ: test) và xác nhận Gemini phản hồi
Dùng prompt đã chuẩn bị ở Bước 4: sao chép, dán vào chat Gemini rồi nhấn Enter (trên bàn phím hoặc nút Enter của terminal).
Khi mọi thứ bên dưới hoàn tất, hãy dùng nút hoàn thành ở phía trên hoạt động này để hệ thống mở khóa cấp độ tiếp theo và bài tập tiếp theo của khóa học.
Giao diện trò chuyện thuần túy — chỉ dùng tiếng Anh đơn giản, Gemini sẽ xử lý phần còn lại trên máy chủ của bạn.
Gemini sẽ thông báo khi luồng đã sẵn sàng. Sau thông báo đó, nhấn Tải lại và kiểm tra cập nhật trên canvas.
Bước 1 · Trước hết xác nhận truy cập terminal
Bắt đầu từ ngăn tin nhắn. Trước khi tạo API key, hãy chắc chắn terminal đã sẵn sàng và đăng nhập thành công.
- Mở ngăn tin nhắn (biểu tượng bong bóng) và chờ 2 tin từ quản trị viên: thông tin Node-RED, sau đó là WebTerminal is ready.
- Sau khi có WebTerminal is ready, sao chép thông tin terminal từ tin nhắn (
admin+ mật khẩu). - Tải lại trang (F5), đăng nhập terminal và lưu thông tin trên trình duyệt cho các lần sau.
- Nếu terminal không tải trong frame, bấm ↗ Open in new tab và tiếp tục ở tab mới.
- Khi chat Gemini xuất hiện và yêu cầu API key, chuyển sang Bước 2.
Bước 2 · Tạo API key và kích hoạt Gemini
Bây giờ hãy tạo khóa trong Google AI Studio và dán vào chat terminal để Gemini bắt đầu hoạt động trên máy chủ của bạn.
- Mở Google AI Studio → Khóa API.
- Nếu Google hiển thị điều khoản/giấy phép, hãy bắt buộc chấp nhận.
- Chọn dự án có sẵn hoặc tạo dự án mới.
- Bấm Create API key rồi sao chép khóa vừa tạo.
- Quay lại terminal và dán khóa bằng menu chuột phải hoặc
Ctrl+Shift+V. - Nhấn Enter và chờ thông báo xác nhận (ví dụ:
Gemini API key saved).
Bước 3 · Kiểm tra chat và giới hạn hạn ngạch
Gemini hoạt động ở chế độ chat. Hãy trò chuyện với nó như với mentor, không cần lệnh hay script.
Nếu xuất hiện
Lỗi API: Bạn đã dùng hết hạn ngạch hàng ngày của mình trên mô hình này. 
sau đó mở cài đặt terminal bằng /settings và đảm bảo Preview Features = ON.


Tiếp theo, mở bộ chọn mô hình bằng /model.

Chọn chế độ Manual và mô hình gemini-3-flash-preview. Bật "Remember model for future sessions".

Hãy gửi lại tin nhắn. Nếu giới hạn xuất hiện lại, chờ ~5 phút rồi thử lại. Nếu vẫn lỗi, có thể bạn đã chạm giới hạn theo ngày (RPD) và cần đợi tối đa 24 giờ.

Bạn cũng có thể chuyển sang dự án/khóa API Google Cloud khác hoặc yêu cầu hỗ trợ tại đây: https://t.me/sell_systems
Nếu cần, hãy bật thanh toán để có giới hạn cao hơn.

Nếu vẫn cần hỗ trợ, hãy liên hệ quản trị viên tại đây: https://t.me/sell_systems
Để khôi phục theo cách khác, hãy dùng dự án mới hoặc khóa API mới.
| Vấn đề | Cách xử lý |
|---|---|
| “Khóa API không hợp lệ” | Xóa khóa trong AI Studio → tạo khóa mới → dán lại. |
| Terminal không phản hồi | Nhấn Tải lại, đợi 10 giây, lặp lại tin nhắn. |
| Trục trặc mạng | Khôi phục Wi-Fi/VPN, làm mới trang, thử lại. |
Bước 4 · Khởi chạy luồng khởi động
Bây giờ hãy dùng prompt nhiệm vụ đã chuẩn bị bên dưới: sao chép, dán vào chat Gemini, nhấn Enter (trên bàn phím hoặc nút Enter của terminal) và theo dõi quá trình thực thi. Đây là “chiến thắng nhỏ” đầu tiên của bạn.
Dán nội dung này vào terminal rồi nhấn Enter (hoặc nói bằng lời của bạn):
Cần kiểm tra hướng dẫn bằng tay? Mở README khởi đầu trong tab mới và làm theo các bước tương tự.
✦ Gemini sẽ thông báo tiến độ trong khi thực thi. Hãy trả lời câu hỏi, xác nhận các yêu cầu, và khi Gemini báo luồng đã sẵn sàng, nhấn nút Tải lại để xem thay đổi trong Node-RED. Nếu có điểm chưa rõ, hãy gửi câu hỏi tiếp theo hoặc liên hệ quản trị viên - bạn luôn giữ toàn quyền kiểm soát.
Kết quả dự kiến sẽ như thế này: 
Khi hoàn tất, Gemini thường phản hồi như sau:
Khi các mẫu GitHub mở rộng, chúng tôi sẽ thêm các lời nhắc nâng cao hơn tại đây.
Gemini có thể xin phép chạy lệnh (ví dụ: ls ). Phê duyệt lời nhắc để nó có thể kiểm tra môi trường. Bạn vẫn là người điều hành, xác nhận từng hành động mà AI đề xuất.
Dùng ngăn nhắn tin (biểu tượng bong bóng ở góc trên bên phải) để xem hướng dẫn của quản trị viên hoặc yêu cầu hỗ trợ. Mọi thứ (thông tin WebTerminal, URL Node-RED, gợi ý bổ sung) đều nằm ở đó. Bạn cũng có thể hỏi tại đây https://t.me/sell_systems
Sẵn sàng cho phần tiếp theo? Hãy dùng nút hoàn thành ở phía trên hoạt động này.
