Nodes and media

音声ウェイク

OpenClaw は、ウェイクワードを Gateway が所有する単一のグローバルリストとして扱います。

ノードごとのカスタムウェイクワードはありません。
どのノード/アプリ UI でもリストを編集できます。変更は Gateway によって永続化され、全員へブロードキャストされます。
macOS と iOS は、ローカルの Voice Wake 有効/無効トグルを保持します（ローカル UX と権限が異なるため）。
Android は現在 Voice Wake をオフのままにし、Voice タブで手動マイクフローを使用します。

ストレージ（Gateway ホスト）

ウェイクワードとルーティングルールは、Gateway 状態データベースに保存されます。

~/.openclaw/state/openclaw.sqlite

有効なテーブルは次のとおりです。

voicewake_triggers
voicewake_routing_config
voicewake_routing_routes

レガシーの settings/voicewake.json と settings/voicewake-routing.json ファイルは doctor 移行入力専用です。ランタイムは SQLite テーブルを読み書きします。

プロトコル

メソッド

voicewake.get → { triggers: string[] }
params { triggers: string[] } を指定した voicewake.set → { triggers: string[] }

注記:

トリガーは正規化されます（トリムされ、空値は削除されます）。空のリストはデフォルトにフォールバックします。
安全のため、上限（数/長さの上限）が適用されます。

ルーティングメソッド（トリガー → ターゲット）

voicewake.routing.get → { config: VoiceWakeRoutingConfig }
params { config: VoiceWakeRoutingConfig } を指定した voicewake.routing.set → { config: VoiceWakeRoutingConfig }

VoiceWakeRoutingConfig の形状:

json

{  "version": 1,  "defaultTarget": { "mode": "current" },  "routes": [{ "trigger": "robot wake", "target": { "sessionKey": "agent:main:main" } }],  "updatedAtMs": 1730000000000}

ルートターゲットは、次のいずれか 1 つだけをサポートします。

{ "mode": "current" }
{ "agentId": "main" }
{ "sessionKey": "agent:main:main" }

イベント

voicewake.changed ペイロード { triggers: string[] }
voicewake.routing.changed ペイロード { config: VoiceWakeRoutingConfig }

受信者:

すべての WebSocket クライアント（macOS アプリ、WebChat など）
すべての接続済みノード（iOS/Android）。また、ノード接続時には初期の「現在の状態」プッシュとしても送信されます。

クライアントの挙動

macOS アプリ

グローバルリストを使って VoiceWakeRuntime トリガーを制御します。
Voice Wake 設定で「トリガーワード」を編集すると voicewake.set が呼び出され、その後はブロードキャストに依存して他のクライアントとの同期を維持します。

iOS ノード

グローバルリストを VoiceWakeManager のトリガー検出に使用します。
設定でウェイクワードを編集すると（Gateway WS 経由で）voicewake.set が呼び出され、ローカルのウェイクワード検出の応答性も維持されます。

Android ノード

Voice Wake は現在 Android ランタイム/設定で無効化されています。
Android の音声は、ウェイクワードトリガーの代わりに Voice タブで手動マイクキャプチャを使用します。