[告知] OpenClaw最新バージョンのBonjour関連エラーのご案内および解決方法
1. 症状のご案内
本日（2026-04-27）時点で、docker pullによりOpenClawイメージを最新バージョン（2026.4.x）にアップデートした後、一部の環境でGatewayコンテナが再起動を繰り返す現象が発生しています。
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)この場合：
- openclaw-gateway コンテナが数秒ごとに起動してはすぐに終了し、
- ダッシュボードへのアクセスおよびテレグラム連携が正常に行われない可能性があります。
2. 原因 – Bonjour(mDNS) 広報プロセスのバグ
OpenClaw Gatewayは、デフォルトでBonjour(mDNS)を使用し、同じネットワーク内でこのインスタンスを自動的に検出できるように(advertise)設定されています。
一部の Docker / WSL / ネットワーク（ルーター、社内ネットワークなど）環境において：
- Bonjour advertiseの状態がannouncing段階で止まった後、,
- CIAO ANNOUNCEMENT CANCELLEDというエラーが発生し、
- この例外が適切に処理されず、Gatewayプロセスがクラッシュループに陥るバグがあります。
現在関連パッチが進行中であり、それまでは以下の方法で回避して使用することができます。
3. 解決方法 – Bonjour機能の無効化（推奨）
1部/2部の実習はローカル1台のみで使用する構造のため、Bonjourは必ずしも必要ではありません。
したがって、環境変数でBonjourをオフにすることをお勧めします。
3-1. docker-compose.ymlを使用する場合
openclaw-gateway サービスに次の環境変数を追加してください。.
services:
openclaw-gateway:
image: ghcr.io/openclaw/openclaw:latest
environment:
- OPENCLAW_DISABLE_BONJOUR=1
# その他のOPENCLAW関連の設定...変更後、以下のコマンドで再起動します。
docker compose down
docker compose up -dこの設定を適用すると：
- GatewayがBonjour/mDNS広告を試行しなくなるため、
- CIAO ANNOUNCEMENT CANCELLED エラーパスを通らずに、安定して実行されます。
- 第1部/第2部で使用するブラウザ接続（ダッシュボード）とテレグラム連携には影響を与えません。
4. 今後のご案内
- この問題はOpenClawのBonjourプラグインと特定のネットワーク/Docker環境との相性の問題であり、今後のリリースで改善される予定です。
- パッチ適用後も、
- ローカル1台のみで使用する場合は、引き続きOPENCLAW_DISABLE_BONJOUR=1を維持していただいても構いません。
- 複数のデバイスでOpenClawインスタンスを自動検索する必要がある場合のみ、Bonjourを再度有効にしてください。
最近イメージを再度プルした後、突然Gatewayが停止し続ける現象が発生している1部/2部の受講生の方は、
上記の設定を適用し、Bonjour機能を無効にしてください。
ありがとうございます！