​

iOS アプリ（ノード）

​

何を行うか

• WebSocket（LAN または tailnet）経由で Gateway（ゲートウェイ）に接続します。
• ノードの機能を公開します：Canvas、画面スナップショット、カメラキャプチャ、位置情報、トークモード、音声ウェイク。
• node.invoke コマンドを受信し、ノードのステータスイベントを報告します。

​

要件

• 別のデバイスで稼働している Gateway（macOS、Linux、または WSL2 経由の Windows）。
• ネットワーク経路：
  • Bonjour 経由の同一 LAN、または
  • ユニキャスト DNS-SD（例のドメイン：openclaw.internal.）を用いた Tailnet、または
  • 手動のホスト／ポート（フォールバック）。

​

クイックスタート（ペアリング＋接続）

1. Gateway を起動します：

openclaw gateway --port 18789

2. iOS アプリで「設定」を開き、検出されたゲートウェイを選択します（または「手動ホスト」を有効にしてホスト／ポートを入力します）。
3. ゲートウェイ ホストでペアリング要求を承認します：

openclaw nodes pending
openclaw nodes approve <requestId>

4. 接続を確認します：

openclaw nodes status
openclaw gateway call node.list --params "{}"

​

検出経路

​

Bonjour（LAN）

​

Tailnet（クロスネットワーク）

​

手動ホスト／ポート

​

Canvas ＋ A2UI

openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<gateway-host>:18793/__openclaw__/canvas/"}'

• Gateway のキャンバスホストは /__openclaw__/canvas/ と /__openclaw__/a2ui/ を提供します。
• これは Gateway HTTP サーバー（gateway.port と同じポート、デフォルトは 18789）から配信されます。
• キャンバスホスト URL がアドバタイズされている場合、iOS ノードは接続時に自動で A2UI にナビゲートします。
• canvas.navigate と {"url":""} で、組み込みのスキャフォールドに戻ります。

​

Canvas の eval／スナップショット

openclaw nodes invoke --node "iOS Node" --command canvas.eval --params '{"javaScript":"(() => { const {ctx} = window.__openclaw; ctx.clearRect(0,0,innerWidth,innerHeight); ctx.lineWidth=6; ctx.strokeStyle=\"#ff2d55\"; ctx.beginPath(); ctx.moveTo(40,40); ctx.lineTo(innerWidth-40, innerHeight-40); ctx.stroke(); return \"ok\"; })()"}'

openclaw nodes invoke --node "iOS Node" --command canvas.snapshot --params '{"maxWidth":900,"format":"jpeg"}'

​

音声ウェイク＋トークモード

• 音声ウェイクとトークモードは「設定」から利用できます。
• iOS はバックグラウンド音声を停止する場合があります。アプリが非アクティブなときの音声機能は、ベストエフォートとして扱ってください。

​

よくあるエラー

• NODE_BACKGROUND_UNAVAILABLE：iOS アプリをフォアグラウンドにしてください（キャンバス／カメラ／画面コマンドには必要です）。
• A2UI_HOST_NOT_CONFIGURED：Gateway がキャンバスホスト URL をアドバタイズしていません。Gateway 設定 の canvasHost を確認してください。
• ペアリングのプロンプトが表示されない：openclaw nodes pending を実行し、手動で承認してください。
• 再インストール後に再接続できない：Keychain のペアリングトークンがクリアされています。ノードを再ペアリングしてください。

​

関連ドキュメント

• ペアリング
• 検出
• Bonjour