Xin chào.
Trong các phiên bản OpenClaw mới nhất gần đây từ v2026.7.1-beta.5 trở đi, phương thức onboarding đã được thay đổi từ màn hình dạng menu truyền thống sang phương thức onboarding dạng đối thoại dựa trên Crestodian.
Vì giao diện có thể trông khác so với video bài giảng khiến bạn bối rối, tôi xin hướng dẫn như sau.
Đối tượng áp dụng
- Học viên mới pull Docker image mới nhất để cài đặt/thực hành
- Khác với màn hình bài giảng trước đây, những học viên thấy màn hình Crestodian TUI xuất hiện trước khi chạy openclaw onboard
Trường hợp không thuộc các mục dưới đây:
- Những học viên vẫn đang sử dụng Docker image cũ là
Có thể tiến hành gần như tương tự với màn hình bài giảng trước đây, nên
Những điểm thay đổi trong phiên bản mới nhất
Trước đây, sau khi chạy openclaw onboard, menu chọn model thường sẽ hiện ra ngay lập tức, nhưng
Trong phiên bản mới nhất, trước tiên một agent hệ thống dùng để thiết lập/sửa chữa có tên là Crestodian sẽ được thực thi.
Ví dụ, màn hình hướng dẫn như dưới đây có thể xuất hiện trước.
- "Hi, I'm Crestodian — let's hatch your agent."
- "Say yes and I'll set all of that up now."
- "No usable model provider is configured, so the agent cannot answer yet. Configure a model provider now? Say yes or no."
Nói cách khác, ở phiên bản mới nhất, có trường hợp bạn phải nhập yes hai lần thì mới chuyển sang quy trình chọn mô hình như trước đây được. twice to proceed to the existing model selection flow.
Cách tiến hành onboarding phiên bản mới nhất
Khi chạy openclaw onboard ở phiên bản mới nhất, vui lòng tiến hành như bên dưới.
1. Khi màn hình đầu tiên của Crestodian xuất hiện, hãy nhập yes
Khi bạn thấy dòng chữ tương tự như dưới đây lần đầu tiên:
- "Hi, I'm Crestodian — let's hatch your agent."
- "Say yes and I'll set all of that up now."
Tại đây, hãy nhập vào terminal như sau:
yes2. Nếu được hỏi lại về việc thiết lập nhà cung cấp mô hình (model provider), hãy nhập yes thêm một lần nữa.
Sau đó, một đoạn văn bản tương tự như dưới đây có thể xuất hiện.
- "No usable model provider is configured, so the agent cannot answer yet."
- "Configure a model provider now? Say yes or no."
Tại đây, hãy nhập lại một lần nữa như bên dưới.
yesTức là, trong phiên bản mới nhất, có trường hợp bạn phải nhập yes → yes hai lần liên tiếp rồi nhấn Enter thì mới chuyển sang bước chọn mô hình/nhập key được. twice in a row and press Enter to proceed to the model selection and key entry stage.
3. Từ sau đó trở đi sẽ giống với luồng của bài giảng
Sau đó thì:
- Chọn mô hình sẽ sử dụng
- Nhập mã khóa Gemini API
- Thiết lập Agent cơ bản
tiếp nối với luồng trình tự như trên,
Phần này không khác biệt nhiều so với mục đích của việc hướng dẫn làm quen (onboarding) đã được giải thích trong bài giảng.
## Tiêu chuẩn hoàn tất Onboarding
Sau khi hoàn tất nhập và thiết lập Gemini API key, bạn có thể thấy một thông báo tương tự như bên dưới.
- "Your agent is ready."
- "Model: google/gemini-2.5-flash."
- "Gateway: running at ws://127.0.0.1:18789."
- "Say talk to agent to meet your agent right here, or help for everything I can do."
Khi bạn thấy màn hình này, nghĩa là quá trình làm quen (onboarding) đã hoàn tất bình thường.
Tức là:
- Hoàn tất thiết lập mô hình
- Kết nối Gateway hoàn tất
- Chuẩn bị xong agent cơ bản
có thể coi là trạng thái.
Làm thế nào để thoát ra sau khi hoàn tất onboarding?
Trong phiên bản mới nhất, màn hình Crestodian TUI có thể vẫn còn hiển thị ngay cả sau khi quá trình onboarding kết thúc.
Trong trường hợp này:
- Ctrl + C
- Nhấn Ctrl + C thêm một lần nữa once more
chỉ cần nhấn Ctrl + C hai lần để thoát khỏi TUI là được.
Trong bài giảng, vì màn hình dựa trên phiên bản cũ nên phần này có thể không xuất hiện trực tiếp, nhưng
Học viên sử dụng phiên bản mới nhất sau khi hoàn tất onboarding chỉ cần nhấn Ctrl + C hai lần để thoát.
Tổng kết
Học viên phiên bản mới nhất chỉ cần nhớ những điều dưới đây.
1. Chạy openclaw onboard
2. Khi màn hình hướng dẫn Crestodian hiện ra, chọn yes
3. Nếu được hỏi có thiết lập nhà cung cấp mô hình hay không, hãy chọn lại yes again
4. Sau khi nhập Gemini API Key, tiếp tục tiến hành cài đặt
5. Khi thấy tin nhắn "Your agent is ready." là hoàn tất quá trình onboarding
6. Cuối cùng nhấn Ctrl + C hai lần để thoát ra ngoài
Học viên cũ / Người dùng phiên bản cũ thì sao?
- Những học viên chưa pull hình ảnh (image) mới nhất
- Học viên vẫn đang sử dụng hình ảnh Docker phiên bản cũ
có thể tương tự như màn hình bài giảng trước đó, nên
Bạn cứ tiến hành đúng theo nội dung bài giảng là được.
Kết thúc
Tóm lại là,
Trong phiên bản mới nhất, giao diện người dùng (UI) onboarding đã thay đổi sang phương thức hội thoại dựa trên Crestodian, theo đó bạn chỉ cần hiểu rằng quy trình đã thay đổi thành nhập yes hai lần, sau đó tiến hành chọn mô hình/nhập khóa, và cuối cùng nhấn Ctrl + C hai lần để kết thúc.
Các bạn học viên đang sử dụng phiên bản mới nhất vui lòng tham khảo thông báo này để tiến hành nhé.