音声による起動

ウェイクワードは、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 モード
• 音声とボイスノート
• メディア理解