Android アプリ

Android アプリはまだ一般公開されていません。ソースコードは OpenClaw リポジトリの apps/android 配下で入手できます。Java 17 と Android SDK (./gradlew :app:assemblePlayDebug) を使用して自分でビルドできます。ビルド手順については apps/android/README.md を参照してください。

サポート状況の概要

役割: コンパニオンノードアプリ (Android は Gateway をホストしません)。
Gateway 必須: はい (macOS、Linux、または WSL2 経由の Windows で実行します)。
インストール: はじめに + ペアリング。
Gateway: Runbook + 設定。
- プロトコル: Gateway プロトコル (ノード + コントロールプレーン)。

システム制御

システム制御 (launchd/systemd) は Gateway ホスト上にあります。Gateway を参照してください。

接続 Runbook

Android ノードアプリ ⇄ (mDNS/NSD + WebSocket) ⇄ Gateway Android は Gateway WebSocket に直接接続し、デバイスペアリング (role: node) を使用します。 Tailscale または公開ホストの場合、Android にはセキュアなエンドポイントが必要です。

推奨: Tailscale Serve / Funnel と https://<magicdns> / wss://<magicdns>
追加でサポート: 実際の TLS エンドポイントを持つその他の wss:// Gateway URL
平文の ws:// は、プライベート LAN アドレス / .local ホストに加えて、localhost、127.0.0.1、Android エミュレーターブリッジ (10.0.2.2) では引き続きサポートされます

前提条件

「マスター」マシンで Gateway を実行できる。
Android デバイス/エミュレーターが Gateway WebSocket に到達できる。
- mDNS/NSD を使用する同一 LAN、または
- Wide-Area Bonjour / ユニキャスト DNS-SD を使用する同一 Tailscale tailnet (下記参照)、または
- 手動の Gateway ホスト/ポート (フォールバック)
Tailnet/公開モバイルペアリングは、生の tailnet IP ws:// エンドポイントを使用しません。代わりに Tailscale Serve または別の wss:// URL を使用してください。
Gateway マシン上で (または SSH 経由で) CLI (openclaw) を実行できる。

1) Gateway を起動する

openclaw gateway --port 18789 --verbose

ログに次のような出力があることを確認します。

listening on ws://0.0.0.0:18789

Tailscale 経由のリモート Android アクセスでは、生の tailnet バインドではなく Serve/Funnel を推奨します。

openclaw gateway --tailscale serve

これにより、Android にセキュアな wss:// / https:// エンドポイントが提供されます。プレーンな gateway.bind: "tailnet" セットアップだけでは、TLS を別途終端しない限り、初回のリモート Android ペアリングには不十分です。

2) 検出を確認する (任意)

Gateway マシンから:

dns-sd -B _openclaw-gw._tcp local.

追加のデバッグメモ: Bonjour。 Wide-area 検出ドメインも設定している場合は、次と比較します。

openclaw gateway discover --json

これは local. と設定済みの wide-area ドメインを 1 回で表示し、TXT のみのヒントではなく解決済みのサービスエンドポイントを使用します。

ユニキャスト DNS-SD による Tailnet (ウィーン ⇄ ロンドン) 検出

Android の NSD/mDNS 検出はネットワークをまたぎません。Android ノードと Gateway が異なるネットワーク上にあり、Tailscale で接続されている場合は、代わりに Wide-Area Bonjour / ユニキャスト DNS-SD を使用してください。検出だけでは、tailnet/公開 Android ペアリングには不十分です。検出された経路にもセキュアなエンドポイント (wss:// または Tailscale Serve) が必要です。

Gateway ホスト上に DNS-SD ゾーン (例 openclaw.internal.) を設定し、_openclaw-gw._tcp レコードを公開します。
選択したドメインをその DNS サーバーに向けるように Tailscale split DNS を設定します。

詳細と CoreDNS 設定例: Bonjour。

3) Android から接続する

Android アプリで:

アプリはフォアグラウンドサービス (永続通知) によって Gateway 接続を維持します。
Connect タブを開きます。
Setup Code または Manual モードを使用します。
検出がブロックされる場合は、Advanced controls で手動のホスト/ポートを使用します。プライベート LAN ホストでは、ws:// が引き続き機能します。Tailscale/公開ホストでは、TLS を有効にし、wss:// / Tailscale Serve エンドポイントを使用します。

最初のペアリングに成功した後、Android は起動時に自動再接続します。

手動エンドポイント (有効な場合)、それ以外は
最後に検出された Gateway (ベストエフォート)。

Presence alive ビーコン

認証済みノードセッションが接続された後、かつフォアグラウンドサービスがまだ接続されている状態でアプリがバックグラウンドへ移動すると、Android は event: "node.presence.alive" で node.event を呼び出します。Gateway は、認証済みノードデバイス ID が判明した後に限り、ペアリング済みノード/デバイスのメタデータにこれを lastSeenAtMs/lastSeenReason として記録します。アプリは、Gateway レスポンスに handled: true が含まれる場合にのみ、このビーコンが正常に記録されたとみなします。古い Gateway は { "ok": true } で node.event を確認応答する場合があります。このレスポンスには互換性がありますが、永続的な最終確認時刻の更新としてはカウントされません。

4) ペアリングを承認する (CLI)

Gateway マシン上で:

openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>

ペアリングの詳細: ペアリング。任意: Android ノードが常に厳密に管理されたサブネットから接続する場合は、明示的な CIDR または正確な IP を指定して、初回ノード自動承認を有効にできます。

{
  gateway: {
    nodes: {
      pairing: {
        autoApproveCidrs: ["192.168.1.0/24"],
      },
    },
  },
}

これはデフォルトでは無効です。要求スコープのない新規の role: node ペアリングにのみ適用されます。オペレーター/ブラウザーペアリング、およびロール、スコープ、メタデータ、公開鍵の変更は、引き続き手動承認が必要です。

5) ノードが接続されていることを確認する

ノードステータス経由:
```
openclaw nodes status
```

Gateway 経由:

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

6) チャット + 履歴

Android の Chat タブはセッション選択をサポートします (デフォルトは main、加えてその他の既存セッション)。

履歴: chat.history (表示用に正規化済み。インラインディレクティブタグは表示テキストから取り除かれ、プレーンテキストのツール呼び出し XML ペイロード (<tool_call>...</tool_call>、<function_call>...</function_call>、<tool_calls>...</tool_calls>、<function_calls>...</function_calls>、および切り詰められたツール呼び出しブロックを含む) と漏えいした ASCII/全角のモデル制御トークンは取り除かれ、完全一致の NO_REPLY / no_reply などの純粋なサイレントトークン assistant 行は省略され、サイズが大きすぎる行はプレースホルダーに置き換えられる場合があります)
送信: chat.send
プッシュ更新 (ベストエフォート): chat.subscribe → event:"chat"

7) Canvas + カメラ

Gateway Canvas ホスト (Web コンテンツに推奨)

ノードに、エージェントがディスク上で編集できる実際の HTML/CSS/JS を表示させたい場合は、ノードを Gateway Canvas ホストに向けます。

ノードは Gateway HTTP サーバー (gateway.port と同じポート、デフォルトは 18789) から Canvas を読み込みます。

Gateway ホスト上に ~/.openclaw/workspace/canvas/index.html を作成します。
ノードをそこへ移動します (LAN):

openclaw nodes invoke --node "<Android Node>" --command canvas.navigate --params '{"url":"http://<gateway-hostname>.local:18789/__openclaw__/canvas/"}'

Tailnet (任意): 両方のデバイスが Tailscale 上にある場合は、.local の代わりに MagicDNS 名または tailnet IP を使用します。例: http://<gateway-magicdns>:18789/__openclaw__/canvas/。このサーバーは HTML にライブリロードクライアントを注入し、ファイル変更時に再読み込みします。 A2UI ホストは http://<gateway-host>:18789/__openclaw__/a2ui/ にあります。 Canvas コマンド (フォアグラウンドのみ):

canvas.eval、canvas.snapshot、canvas.navigate (デフォルトのスキャフォールドに戻るには {"url":""} または {"url":"/"} を使用します)。canvas.snapshot は { format, base64 } を返します (デフォルトは format="jpeg")。
A2UI: canvas.a2ui.push、canvas.a2ui.reset (canvas.a2ui.pushJSONL はレガシーエイリアス)

カメラコマンド (フォアグラウンドのみ、権限で制御):

camera.snap (jpg)
camera.clip (mp4)

パラメーターと CLI ヘルパーについてはカメラノードを参照してください。

8) 音声 + 拡張 Android コマンドサーフェス

Voice タブ: Android には 2 つの明示的なキャプチャモードがあります。Mic は手動の Voice タブセッションで、一時停止ごとにチャットターンとして送信し、アプリがフォアグラウンドを離れるか、ユーザーが Voice タブを離れると停止します。Talk は継続的な Talk Mode で、オフに切り替えるかノードが切断されるまでリスニングを続けます。
Talk Mode は、キャプチャ開始前に既存のフォアグラウンドサービスを dataSync から dataSync|microphone に昇格し、Talk Mode が停止すると降格します。Android 14+ では、FOREGROUND_SERVICE_MICROPHONE 宣言、RECORD_AUDIO ランタイム許可、およびランタイムでの microphone サービスタイプが必要です。
音声応答は、設定済みの Gateway Talk プロバイダーを通じて talk.speak を使用します。ローカルシステム TTS は、talk.speak が利用できない場合にのみ使用されます。
音声ウェイクは Android の UX/ランタイムで引き続き無効です。
追加の Android コマンドファミリー (利用可否はデバイス + 権限に依存):
- device.status、device.info、device.permissions、device.health
- notifications.list、notifications.actions (下記の通知転送を参照)
- photos.latest
- contacts.search、contacts.add
- calendar.events、calendar.add
- callLog.search
- sms.search
- motion.activity、motion.pedometer

Assistant エントリーポイント

Android はシステムアシスタントトリガー (Google Assistant) からの OpenClaw 起動をサポートします。設定すると、ホームボタンを長押しするか、「Hey Google, ask OpenClaw…」と言うことでアプリが開き、プロンプトがチャット作成欄に渡されます。これは、アプリマニフェストで宣言された Android App Actions メタデータを使用します。Gateway 側で追加設定は不要です — アシスタント intent は Android アプリ内で完全に処理され、通常のチャットメッセージとして転送されます。

App Actions の利用可否は、デバイス、Google Play Services バージョン、ユーザーが OpenClaw をデフォルトのアシスタントアプリとして設定しているかどうかによって異なります。

通知転送

Android はデバイス通知をイベントとして Gateway に転送できます。複数の制御により、どの通知をいつ転送するかを範囲指定できます。

キー	型	説明
`notifications.allowPackages`	string[]	これらのパッケージ名からの通知のみを転送します。設定されている場合、その他すべてのパッケージは無視されます。
`notifications.denyPackages`	string[]	これらのパッケージ名からの通知は転送しません。`allowPackages` の後に適用されます。
`notifications.quietHours.start`	string (HH:mm)	静音時間帯ウィンドウの開始 (ローカルデバイス時刻)。このウィンドウ中、通知は抑制されます。
`notifications.quietHours.end`	string (HH:mm)	静音時間帯ウィンドウの終了。
`notifications.rateLimit`	number	パッケージごとの 1 分あたり最大転送通知数。超過した通知は破棄されます。

通知ピッカーは、転送される通知イベントに対してより安全な挙動も使用し、機密性の高いシステム通知の誤転送を防ぎます。設定例:

{
  notifications: {
    allowPackages: ["com.slack", "com.whatsapp"],
    denyPackages: ["com.android.systemui"],
    quietHours: {
      start: "22:00",
      end: "07:00",
    },
    rateLimit: 5,
  },
}

通知転送には Android Notification Listener 権限が必要です。アプリはセットアップ中にこの権限を求めます。

Platforms overview

macOS companion app

Android アプリ

サポート状況の概要

システム制御

接続 Runbook

前提条件

1) Gateway を起動する

2) 検出を確認する (任意)

ユニキャスト DNS-SD による Tailnet (ウィーン ⇄ ロンドン) 検出

3) Android から接続する

Presence alive ビーコン

4) ペアリングを承認する (CLI)

5) ノードが接続されていることを確認する

6) チャット + 履歴

7) Canvas + カメラ

Gateway Canvas ホスト (Web コンテンツに推奨)

8) 音声 + 拡張 Android コマンドサーフェス

Assistant エントリーポイント

通知転送

関連

Platforms overview

macOS companion app

Documentation Index

​サポート状況の概要

​システム制御

​接続 Runbook

​前提条件

​1) Gateway を起動する

​2) 検出を確認する (任意)

​ユニキャスト DNS-SD による Tailnet (ウィーン ⇄ ロンドン) 検出

​3) Android から接続する

​Presence alive ビーコン

​4) ペアリングを承認する (CLI)

​5) ノードが接続されていることを確認する

​6) チャット + 履歴

​7) Canvas + カメラ

​Gateway Canvas ホスト (Web コンテンツに推奨)

​8) 音声 + 拡張 Android コマンドサーフェス

​Assistant エントリーポイント

​通知転送

​関連

サポート状況の概要

システム制御

接続 Runbook

前提条件

1) Gateway を起動する

2) 検出を確認する (任意)

ユニキャスト DNS-SD による Tailnet (ウィーン ⇄ ロンドン) 検出

3) Android から接続する

Presence alive ビーコン

4) ペアリングを承認する (CLI)

5) ノードが接続されていることを確認する

6) チャット + 履歴

7) Canvas + カメラ

Gateway Canvas ホスト (Web コンテンツに推奨)

8) 音声 + 拡張 Android コマンドサーフェス

Assistant エントリーポイント

通知転送

関連