Bonjour による検出

​

Tailscale を介した広域 Bonjour (ユニキャスト DNS-SD)

1. ゲートウェイホスト上で DNS サーバーを実行します（Tailnet 経由で到達可能であること）。
2. 専用のゾーン（例: openclaw.internal.）の下で、_openclaw-gw._tcp の DNS-SD レコードを公開します。
3. クライアント（iOS を含む）において、選択したドメインがその DNS サーバーで解決されるよう、Tailscale の Split DNS を設定します。

​

ゲートウェイの構成 (推奨)

{
  gateway: { bind: "tailnet" }, // Tailnet 限定（推奨）
  discovery: { wideArea: { enabled: true } }, // 広域 DNS-SD 公開を有効化
}

​

DNS サーバーのセットアップ (ゲートウェイホスト側、一度のみ)

openclaw dns setup --apply

• ゲートウェイの Tailscale インターフェースのポート 53 のみで待機。
• 指定したドメイン（例: openclaw.internal.）を ~/.openclaw/dns/<domain>.db から配信。

dns-sd -B _openclaw-gw._tcp openclaw.internal.
dig @<TAILNET_IPV4> -p 53 _openclaw-gw._tcp.openclaw.internal PTR +short

​

Tailscale の DNS 設定

• ゲートウェイの Tailnet IP (UDP/TCP 53) を指す Nameserver を追加します。
• 検出用ドメインがその Nameserver を使用するように Split DNS を追加します。

​

ゲートウェイリスナーのセキュリティ (推奨)

• ~/.openclaw/openclaw.json で gateway.bind: "tailnet" を設定します。
• ゲートウェイ（または macOS のメニューバーアプリ）を再起動します。

​

公開される内容

​

サービスタイプ

• _openclaw-gw._tcp — ゲートウェイの通信用ビーコン（macOS/iOS/Android ノードが使用）。

​

TXT キー (非機密のヒント情報)

• role=gateway
• displayName=<表示名>
• lanHost=<ホスト名>.local
• gatewayPort=<ポート番号> (ゲートウェイの WS + HTTP)
• gatewayTls=1 (TLS 有効時のみ)
• gatewayTlsSha256=<sha256> (TLS 有効かつフィンガープリント利用可能時のみ)
• canvasPort=<ポート番号> (Canvas ホスト有効時のみ。現在は gatewayPort と同じ)
• sshPort=<ポート番号> (明示的な上書きがない場合はデフォルト 22)
• transport=gateway
• cliPath=<パス> (オプション。実行可能な openclaw エントリポイントの絶対パス)
• tailnetDns=<magicdns> (Tailnet 利用時のオプション。自動検出されます)

• Bonjour/mDNS の TXT レコードは 未認証（署名なし） です。クライアントは TXT の内容を信頼できるルーティング情報として扱ってはいけません。
• クライアントは、解決されたサービスエンドポイント (SRV + A/AAAA) を優先して使用すべきです。lanHost, tailnetDns, gatewayPort, gatewayTlsSha256 はあくまでヒントとして扱ってください。
• TLS ピン留め（Pinning）において、公開された gatewayTlsSha256 が、以前に保存されたピンを上書きすることを決して許可してはいけません。
• iOS/Android ノードは、検出ベースの直接接続を TLS 限定 として扱い、初回接続時のフィンガープリントを信頼する前にユーザーへ明示的な確認を求める必要があります。

​

macOS でのデバッグ方法

• インスタンスの一覧を表示:
  Copy

  Ask AI

  dns-sd -B _openclaw-gw._tcp local.
  
• 特定のインスタンスを解決 (名前解決の確認):
  Copy

  Ask AI

  dns-sd -L "<インスタンス名>" _openclaw-gw._tcp local.
  

​

ゲートウェイログでのデバッグ

• bonjour: advertise failed ... (公開失敗)
• bonjour: ... name conflict resolved / hostname conflict resolved (名前衝突の解消)
• bonjour: watchdog detected non-announced service ... (ウォッチドッグによる未公開サービスの検出)

​

iOS ノードでのデバッグ

• Settings → Gateway → Advanced → Discovery Debug Logs をオンにする。
• Settings → Gateway → Advanced → Discovery Logs → 再現操作を行う → Copy でコピー。

​

よくある失敗パターン

• Bonjour がネットワークを越えられない: Tailnet または SSH を使用してください。
• マルチキャストがブロックされている: 一部の Wi-Fi ネットワークでは mDNS が無効化されています。
• スリープやインターフェースの切り替え: macOS が一時的に mDNS の結果を落とすことがあります。再試行してください。
• 一覧には出るが解決に失敗する: マシン名をシンプルにし（絵文字や記号を避ける）、ゲートウェイを再起動してください。サービスインスタンス名はホスト名から派生するため、複雑すぎる名前は一部のリゾルバーを混乱させることがあります。

​

エスケープされたインスタンス名 (\032)

• これはプロトコル上の正常な仕様です。
• UI 側で表示用にデコードする必要があります（iOS では BonjourEscapes.decode を使用しています）。

​

無効化と設定

• OPENCLAW_DISABLE_BONJOUR=1 で公開を無効化できます。
• ~/.openclaw/openclaw.json 内の gateway.bind で、ゲートウェイの待機モードを制御します。
• OPENCLAW_SSH_PORT で、TXT レコードに含める SSH ポート番号を上書きできます。
• OPENCLAW_TAILNET_DNS で、TXT レコードに MagicDNS のヒントを含めることができます。
• OPENCLAW_CLI_PATH で、公開される CLI パスを上書きできます。

​

関連ドキュメント

• 検出ポリシーと通信路の選択: 検出
• ノードのペアリングと承認: ゲートウェイのペアリング