[Phần 1: Cơ bản] OpenClaw.AI Master Class: Tự tạo Agent AI tự hành với Gemini và Docker

[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!