音声ウェイク

ウェイクワードは Gateway が所有する単一のグローバルリストです。Node ごとのカスタムリストはありません。どの Node またはアプリ UI からでもリストを編集できます。Gateway は変更を永続化し、接続されているすべてのクライアントにブロードキャストします。

• macOS: ローカルの Voice Wake 有効化/無効化トグル。macOS 26 以降が必要です。ランタイム/PTT の詳細については、Voice wake（macOS）を参照してください。
• iOS: Settings にあるローカルの Voice Wake 有効化/無効化トグル。
• Android: Settings → Voice にあるローカルの Voice Wake 有効化/無効化トグルとウェイクワードエディター。Android のオンデバイス音声認識が必要です。

ストレージ

ウェイクワードとルーティングルールは Gateway の状態データベースに保存されます。デフォルトは ~/.openclaw/state/openclaw.sqlite です（OPENCLAW_STATE_DIR でオーバーライド可能）。使用するテーブルは voicewake_triggers、voicewake_routing_config、voicewake_routing_routes です。従来の settings/voicewake.json と settings/voicewake-routing.json は openclaw doctor --fix の移行入力としてのみ使用され、ランタイムが読み取ることはありません。

プロトコル

トリガーリスト

voicewake.set は入力を正規化します。空白を除去し、空のエントリを削除し、トリガーを最大 32 件に制限し、サロゲートペアを分割せずに各トリガーを UTF-16 コード単位で 64 までに切り詰めます。結果が空の場合は、組み込みのデフォルト（openclaw、claude、computer）にフォールバックします。

ルーティング（トリガーからターゲットへ）

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

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

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

上限: ルートは最大 32 件、トリガーテキストは最大 64 文字です。ルートのトリガーは照合と重複検出のため、小文字化、各単語の先頭と末尾にある句読点の除去、空白の集約によって正規化されます（"Hey, Bot!!" と "hey bot" は一致し、重複として数えられます）。これは、上記のグローバルトリガーリストで使用される単純なトリミングより厳格な正規化です。

イベント

どちらも、読み取りスコープを持つすべての WebSocket クライアント（macOS アプリ、WebChat など）と、接続されているすべての Node にブロードキャストされます。Node は接続直後に、初期スナップショットのプッシュとして両方を受信します。

クライアントの動作

• macOS: voicewake.set/voicewake.get を呼び出し、他のクライアントとの同期を維持するために voicewake.changed をリッスンします。
• iOS: voicewake.set/voicewake.get を呼び出し、ローカルのウェイクワード検出の応答性を維持するために voicewake.changed をリッスンします。
• Android: voicewake.set/voicewake.get を呼び出し、voicewake.changed をリッスンし、有効な間は voiceWake を通知します。認識はオンデバイスかつフォアグラウンドでのみ動作します。Talk、手動ディクテーション、ボイスメモの録音、またはメッセージ読み上げが音声を使用している間は一時停止します。

関連項目

• Talk モード
• 音声とボイスメモ
• メディア理解