[Phần cơ bản 2] OpenClaw.AI Master Class: Trợ lý từ xa trên điện thoại thông minh hoàn thiện với Telegram và Vision AI

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

Bạn chỉ cần làm theo đúng nội dung bài giảng là được.

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:

yes

2. 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.

yes

Tứ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é.

Xin chào.

Hiện tại, các bản cập nhật phiên bản của OpenClaw vẫn đang diễn ra thường xuyên. Có khoảng hai thay đổi quan trọng mà bạn nên biết, vì vậy tôi xin thông báo cho bạn.

1. Về các tệp thiết lập hệ thống được tự động tạo trong thư mục config trước khi onboarding

   1. Trong bài giảng của chúng tôi, trước khi thực hiện onboarding OpenClaw, thư mục config hoàn toàn trống và sau khi hoàn tất onboarding, các tệp cấu hình hệ thống của OpenClaw mới tự động được tạo ra. Tuy nhiên, sau khi cập nhật, ngay cả trước khi onboarding, chỉ cần bạn chạy tệp docker-compose.yml dù chỉ một lần, OpenClaw sẽ tự động tạo các tệp cấu hình hệ thống cơ bản cần thiết trong thư mục config. Ngay cả khi các tệp này đã tồn tại trước khi onboarding, bạn vẫn có thể tiến hành thực hành theo đúng trình tự như trong bài giảng.

2. Thay đổi liên quan đến các tùy chọn mà người dùng chọn trong giai đoạn Onboarding
   Tên của các tùy chọn mà người dùng chọn trong giai đoạn Onboarding có thể đã thay đổi một chút hoặc có một số tùy chọn đã bị xóa, vì vậy tôi sẽ để lại các thay đổi cụ thể ở bên dưới.

   1. Phần 3 > Bài học 11: Khởi động lần đầu và kiểm tra hệ thống Hello OpenClaw

      • Các thay đổi trong bài thực hành hướng dẫn làm quen (onboarding) với OpenClaw

        • 4 phút 40 giây

          • Tùy chọn thiết lập Config handling

            • (Cũ) Chọn Update values -> (Thay đổi) Chọn Review and update

          • Tùy chọn thiết lập How do you want to provide this API Key?

            • (Thay đổi) Tùy chọn này đã bị loại bỏ nên bạn có thể bỏ qua trong video bài giảng

          • Tùy chọn thiết lập Default model

            • (Trước đây) Có thể chọn trực tiếp trong số tất cả các mô hình -> (Thay đổi) Chọn Browse all models, sau đó ở bước tiếp theo nhập trực tiếp văn bản 'google/gemini-2.5-flash'

          • Tùy chọn thiết lập How do you want to hatch your bot

            • (Cũ) Chọn Do this later -> (Thay đổi) Chọn Hatch later

📢 Thông báo ra mắt bài giảng OpenClaw.AI Cơ bản Phần 2.5

Xin chào, tôi là Kevin, người đang dẫn dắt khóa học cơ bản OpenClaw.AI Master Class.

Cuối cùng, tôi đã mở khóa học [Cơ bản phần 2.5] Thiết kế nhóm Multi-agent và Cơ bản về phân tách vai trò trên Inflearn nên tôi viết thông báo này. :)

Phần 2.5 này sẽ mở rộng thêm một bước nữa cho "Trợ lý AI trong PC của tôi" đã được tạo ở phần 1 và 2,

Biến một bot Telegram duy nhất thành một nhóm AI nhỏ với các vai trò được phân chia là trọng tâm của bài giảng này..

👉[Đi đến bài giảng OpenClaw.AI Cơ bản Phần 2.5]

Những gì chúng ta sẽ cùng tạo trong phần 2.5

- Sử dụng nhóm diễn đàn Telegram + định tuyến theo chủ đề

Cấu hình môi trường đa tác nhân (multi-agent) để vận hành hai tác nhân content-planner / content-editor chỉ với một bot duy nhất.

- Sang thư mục /workspace/content/planning / /workspace/content/drafts

Chúng ta sẽ thực sự tạo ra một quy trình làm việc nội dung, nơi các sản phẩm lập kế hoạch và các bản thảo/bản chỉnh sửa được tách biệt..

- Thông qua kịch bản “tạo ý tưởng và dàn ý trong phòng planner → trau chuốt bài viết trong phòng editor”, chúng ta sẽ hoàn thiện quy trình cộng tác đa tác nhân thực tế dựa trên tiền đề sao chép và dán thủ công.

Đặc biệt đề xuất cho những người sau

- Những người đã theo dõi OpenClaw phần 1 và 2, nhưng vẫn đang bắt một agent duy nhất làm tất cả mọi việc

- Những ai muốn phát triển bot Telegram không chỉ là một "chatbot đơn lẻ" mà thành một đội ngũ AI được phân chia giữa người lập kế hoạch (Planner) và biên tập viên (Writer/Editor)

- Những nhà sáng tạo nội dung độc lập, người vận hành newsletter·blog, YouTuber muốn sắp xếp lại quy trình làm việc bằng cách chia nhỏ các tác vụ lập kế hoạch nội dung / viết bản thảo / trau chuốt câu chữ cho các agent theo từng vai trò đảm nhận.

- Những nhà phát triển, nhà hoạch định, PM quan tâm đến Multi-agent nhưng muốn bắt đầu một cách nhẹ nhàng trong môi trường OpenClaw + Telegram đang sử dụng hiện tại thay vì các framework đồ sộ.

Sơ lược về chương trình đào tạo cốt lõi phần 2.5

- Phần 1: Dành cho cả học viên cũ và học viên mới

Hướng dẫn Lộ trình tham gia Phần 2.5 A (Kiểm tra môi trường trong 5 phút) / B (Onboarding thiết lập tối thiểu) + Ôn tập siêu đơn giản về OpenClaw UI

- Phần 2: Khái niệm Single Agent (Đơn tác tử) vs Multi-Agent (Đa tác tử),

Hiểu cấu trúc nơi nhiều agent được bố trí bên trong openclaw.json, kiểm tra cấu hình hiện tại bằng openclaw agents list

- Phần 3:

- Định nghĩa agent content-planner / content-editor

- Phân tách không gian làm việc /content/planning và /content/drafts

- Tạo nhóm diễn đàn Telegram & các chủ đề planner-lập kế hoạch / editor-biên tập

- Tìm ID nhóm / ID chủ đề → Hoàn tất định tuyến Agent theo từng chủ đề

- Phần 4:

- Thực hành cộng tác bán thủ công giữa planner ↔ editor (dựa trên việc con người sao chép và dán)

- Xem trước quy trình cộng tác tự động giữa 4 agent Leader/Planner/Editor/QA sẽ được đề cập trong phần 3

Các mục cần kiểm tra trước khi học

- Sẽ là tốt nhất nếu bạn đã chuẩn bị sẵn môi trường WSL2 + Docker + OpenClaw + Telegram Bot đã được sử dụng ở phần 1 và 2.

- Ngay cả khi bạn chưa học phần 1 và 2, tôi đã cấu hình để bạn có thể thiết lập môi trường tối thiểu cần thiết cho thực hành Multi-agent bằng cách làm theo “Lộ trình kiểm tra môi trường A / Lộ trình Onboarding thiết lập tối thiểu B” có trong phần 2.5.

- Bạn cần có mã Gemini API được cấp từ Google AI Studio.

Trong quá trình học phần 2.5, nếu có bất kỳ thắc mắc hay gặp khó khăn ở phần nào, xin vui lòng để lại câu hỏi trên bảng hỏi đáp bất cứ lúc nào.

Dựa trên phản hồi của các bạn, chúng tôi sẽ tiếp tục bổ sung và hoàn thiện các ví dụ thực hành cũng như hướng dẫn khắc phục sự cố.

Hy vọng phần 2.5 này sẽ là cơ hội để các bạn mở rộng môi trường OpenClaw của mình từ "một trợ lý thông minh" thành "một nhóm AI nhỏ với các vai trò được phân chia rõ rệt".

Cảm ơn bạn.

[Thông báo] Hướng dẫn về lỗi liên quan đến Bonjour trên phiên bản OpenClaw mới nhất và cách khắc phục

1. Hướng dẫn về triệu chứng

Tính đến ngày hôm nay (27-04-2026), sau khi tôi cập nhật hình ảnh OpenClaw lên phiên bản mới nhất (2026.4.x) bằng lệnh docker pull, đã xảy ra hiện tượng container Gateway liên tục bị khởi động lại trong một số môi trường nhất định.

Nếu các thông báo tương tự như dưới đây lặp lại trong nhật ký của openclaw-gateway, thì có nghĩa là bạn đang gặp phải vấn đề này.

[plugins] bonjour: advertised gateway fqdn=... state=announcing

[plugins] bonjour: restarting advertiser (service stuck in announcing ...)

[openclaw] Unhandled promise rejection: CIAO ANNOUNCEMENT CANCELLED

openclaw-gateway exited with code 1 (restarting)

Trong trường hợp này:

- Container openclaw-gateway liên tục khởi động lại rồi bị tắt ngay lập tức sau mỗi vài giây,

- Việc truy cập bảng điều khiển và liên kết Telegram có thể không hoạt động bình thường.

2. Nguyên nhân – Lỗi trong quá trình quảng bá Bonjour(mDNS)

OpenClaw Gateway theo mặc định sử dụng Bonjour(mDNS) để cho phép tự động tìm thấy instance này trong cùng một mạng (advertise).

Trong một số môi trường Docker / WSL / mạng (bộ định tuyến, mạng công ty, v.v.):

- Sau khi trạng thái quảng bá (advertise) Bonjour bị dừng ở giai đoạn announcing,

- Lỗi CIAO ANNOUNCEMENT CANCELLED xảy ra,

- Có một lỗi khiến ngoại lệ này không được xử lý đúng cách, dẫn đến quy trình Gateway rơi vào vòng lặp bị lỗi (crash loop).

Hiện tại bản vá liên quan đang được tiến hành, và cho đến lúc đó, bạn có thể sử dụng phương pháp dưới đây để tạm thời khắc phục.

3. Cách giải quyết – Vô hiệu hóa tính năng Bonjour (Khuyến nghị)

Thực hành Phần 1/Phần 2 là cấu trúc chỉ sử dụng trên một máy cục bộ nên Bonjour không nhất thiết phải có.

Vì vậy, chúng tôi khuyên bạn nên tắt Bonjour bằng biến môi trường.

3-1. Trường hợp sử dụng docker-compose.yml

Hãy thêm biến môi trường sau vào dịch vụ openclaw-gateway.

services:

  openclaw-gateway:

    image: ghcr.io/openclaw/openclaw:latest

    environment:
      - OPENCLAW_DISABLE_BONJOUR=1

      # Các thiết lập liên quan đến OPENCLAW còn lại...

Sau khi thay đổi, hãy khởi động lại bằng lệnh dưới đây.

docker compose down

docker compose up -d

Khi áp dụng thiết lập này:

- Gateway sẽ không cố gắng quảng cáo Bonjour/mDNS nữa,

- Nó sẽ chạy ổn định mà không gặp lỗi CIAO ANNOUNCEMENT CANCELLED.

- Nó không ảnh hưởng đến việc truy cập trình duyệt (dashboard) và liên kết Telegram được sử dụng trong Phần 1/Phần 2.

4. Hướng dẫn trong tương lai

- Vấn đề này là do sự tương thích giữa plugin Bonjour của OpenClaw và môi trường mạng/Docker cụ thể, dự kiến sẽ được cải thiện trong các bản phát hành sau này.

- Ngay cả sau khi bản vá,

- Nếu chỉ sử dụng trên một máy cục bộ, bạn có thể tiếp tục duy trì OPENCLAW_DISABLE_BONJOUR=1, và

- Chỉ khi nào cần tự động tìm kiếm các thực thể OpenClaw trên nhiều thiết bị thì bạn mới cần kích hoạt lại Bonjour.

Đối với những học viên phần 1/phần 2 đang gặp phải hiện tượng Gateway liên tục bị tắt đột ngột sau khi pull lại image gần đây,

Vui lòng áp dụng cài đặt trên để vô hiệu hóa tính năng Bonjour.

Cảm ơn bạn!