[基礎 第2部] OpenClaw.AI マスタークラス：テレグラムとビジョンAIで完成させるスマートフォン遠隔秘書

📢 OpenClaw.AI 基礎 2.5部 講義オープンのお知らせ

こんにちは、OpenClaw.AIマスタークラス基礎講座を担当しているKevinです。

ついに「基礎 2.5部」マルチエージェントチームの設計と役割分離の基礎講座をInflearnで公開することになり、お知らせを投稿いたしました。 :)

今回の2.5部は、第1・2部で作った「自分のPCの中のAI秘書」を一段階さらに拡張して、

一つのテレグラムボットを、役割が分かれた小さなAIチームへと成長させることに焦点を当てた講義です。.

👉[OpenClaw.AI 基礎 2.5部 講義はこちら]

2.5部で一緒に作ること

- Telegramのフォーラムグループ + トピック別ルーティングを利用して

1つのボットでcontent-planner / content-editorの2つのエージェントを運用するマルチエージェント環境を構築します。

- /workspace/content/planning / /workspace/content/drafts フォルダへ

企画成果物と草案・編集版が分離されるコンテンツワークフローを実際に作成してみます。.

- 「plannerルームでアイデア・アウトライン作成 → editorルームで文章の推敲」というシナリオを通じて、人間のコピペを前提とした現実的なマルチエージェント協業ルーチンを完成させます。

このような方に特におすすめ

- OpenClawの1・2部まで進めたものの、依然として1つのエージェントにすべてを任せている方

- テレグラムボットを「単一のチャットボット」ではなく、企画者（Planner）とエディター（Writer/Editor）に分かれたAIチームとして育ててみたい方

- コンテンツ企画 / 下書き作成 / 文章の推敲作業を役割別のエージェントに分担させ、ワークフローを整理したい個人クリエイター、ニュースレター・ブログ運営者、YouTuber

- マルチエージェントに関心はあるが、巨大なフレームワークの代わりに今使っているOpenClaw + Telegram環境で軽快に始めてみたい開発者・企画者・PM

2.5部の核心カリキュラムを一目で

- セクション 1: 既存の受講生・新規受講生の両方のための

2.5部合流ルートA（5分環境チェック）/ B（最小セットアップ・オンボーディング）案内 + OpenClaw UI超簡単復習

- セクション 2: シングルエージェント vs マルチエージェントの概念、

openclaw.json 内で複数のエージェントが配置される構造の理解、openclaw agents listによる現在の構成の確認

- セクション 3:

- content-planner / content-editor エージェントの定義

- /content/planning、/content/drafts ワークスペースの分離

- テレグラムフォーラムグループ ＆ planner-企画 / editor-編集 トピック作成

- グループID / トピックIDの取得 → トピック別エージェントルーティングの完成

- セクション 4:

- planner ↔ editor 半手動協業実習 (人間によるコピペベース)

- 第3部で扱うLeader/Planner/Editor/QAの4エージェント自動協業パイプラインのプレビュー

受講前のチェック事項

- 1・2部で使用したWSL2 + Docker + OpenClaw + テレグラムボット環境が準備されていれば最適です。

- 1・2部を受講されていない場合でも、2.5部に含まれる「環境点検ルートA / 最小セットアップ・オンボーディングルートB」に従っていただければ、マルチエージェントの実習に必要な最小限の環境を整えられるよう構成しました。

- Google AI Studioで発行したGemini APIキーが必要です。

2.5部の受講中に疑問に思ったことや、行き詰まった部分があれば、いつでも質問掲示板に気軽に残してください。

皆様のフィードバックをもとに、実習例とトラブルシューティングガイドを継続的に補強していきます。

今回の2.5部が、皆さんのOpenClaw環境を「賢い秘書1人」から「役割が分かれた小さなAIチーム」へと拡張するきっかけになることを願っています。

ありがとうございます。

[告知] 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機能を無効にしてください。

ありがとうございます！