制御 UI

• Gateway WS（chat.history, chat.send, chat.abort, chat.inject）経由でモデルとチャットできます。
• チャット履歴の更新は、メッセージごとのテキスト上限付きで範囲を限定した最近のウィンドウを要求するため、大規模なセッションでも、チャットが利用可能になる前にブラウザーが完全なトランスクリプトペイロードをレンダリングする必要はありません。
• ブラウザーのリアルタイムセッションを通じて音声対話できます。OpenAI は直接 WebRTC を使用し、Google Live は WebSocket 経由の制約付き 1 回限りのブラウザートークンを使用し、バックエンド専用のリアルタイム音声 Plugin は Gateway リレートランスポートを使用します。クライアント所有のプロバイダーセッションは talk.client.create で開始し、Gateway リレーセッションは talk.session.create で開始します。リレーはプロバイダー認証情報を Gateway に保持し、ブラウザーが talk.session.appendAudio を通じてマイク PCM をストリーミングし、Gateway ポリシーとより大きく設定された OpenClaw モデル向けに、openclaw_agent_consult プロバイダーツール呼び出しを talk.client.toolCall を通じて転送します。
• チャットでツール呼び出しとライブツール出力カードをストリーミングします（エージェントイベント）。

• チャンネル: 組み込みおよび同梱/外部 Plugin チャンネルのステータス、QR ログイン、チャンネルごとの設定（channels.status, web.login.*, config.patch）。
• チャンネルプローブの更新では、遅いプロバイダーチェックが完了するまで以前のスナップショットを表示したままにし、プローブまたは監査が UI 予算を超えた場合は部分スナップショットにラベルが付きます。
• インスタンス: プレゼンス一覧と更新（system-presence）。
• セッション: 一覧とセッションごとのモデル/thinking/fast/verbose/trace/reasoning 上書き（sessions.list, sessions.patch）。
• Dreaming: Dreaming ステータス、有効/無効トグル、Dream Diary リーダー（doctor.memory.status, doctor.memory.dreamDiary, config.patch）。

• Cron ジョブ: 一覧/追加/編集/実行/有効化/無効化と実行履歴（cron.*）。
• Skills: ステータス、有効化/無効化、インストール、API キー更新（skills.*）。
• ノード: 一覧とキャップ（node.list）。
• exec 承認: exec host=gateway/node 向けに Gateway またはノードの許可リストと ask ポリシーを編集（exec.approvals.*）。

• ~/.openclaw/openclaw.json を表示/編集します（config.get, config.set）。
• 検証付きで適用して再起動し（config.apply）、最後にアクティブだったセッションを起動します。
• 書き込みには、同時編集の上書きを防ぐ base-hash ガードが含まれます。
• 書き込み（config.set/config.apply/config.patch）は、送信された設定ペイロード内の参照について、アクティブな SecretRef 解決を事前チェックします。送信された未解決のアクティブ参照は、書き込み前に拒否されます。
• スキーマとフォームレンダリング（config.schema / config.schema.lookup。フィールド title / description、一致した UI ヒント、直接の子要素のサマリー、ネストされた object/wildcard/array/composition ノード上の docs メタデータ、利用可能な場合は Plugin とチャンネルのスキーマを含む）。Raw JSON エディターは、スナップショットが安全に raw round-trip できる場合にのみ利用できます。
• スナップショットが raw テキストを安全に round-trip できない場合、Control UI は Form モードを強制し、そのスナップショットでは Raw モードを無効化します。
• Raw JSON エディターの「保存済みにリセット」は、フラット化されたスナップショットを再レンダリングするのではなく、raw で作成された形状（書式、コメント、$include レイアウト）を保持するため、スナップショットが安全に round-trip できる場合、外部編集はリセット後も残ります。
• 構造化された SecretRef オブジェクト値は、意図しないオブジェクトから文字列への破損を防ぐため、フォームのテキスト入力では読み取り専用としてレンダリングされます。

• デバッグ: status/health/models スナップショット、イベントログ、手動 RPC 呼び出し（status, health, models.list）。
• イベントログには、Control UI の更新/RPC タイミング、遅いチャット/設定レンダリングのタイミング、ブラウザーがそれらの PerformanceObserver エントリタイプを公開している場合は長いアニメーションフレームや長いタスクに関するブラウザー応答性エントリが含まれます。
• ログ: フィルター/エクスポート付きの Gateway ファイルログのライブ tail（logs.tail）。
• 更新: 再起動レポート付きで package/git 更新と再起動を実行し（update.run）、再接続後に update.status をポーリングして実行中の Gateway バージョンを確認します。

• 分離ジョブでは、配信のデフォルトはサマリー通知です。内部専用の実行にしたい場合は none に切り替えられます。
• announce が選択されている場合、チャンネル/ターゲットフィールドが表示されます。
• Webhook モードは、delivery.to を有効な HTTP(S) Webhook URL に設定したうえで delivery.mode = "webhook" を使用します。
• main-session ジョブでは、webhook と none の配信モードを利用できます。
• 高度な編集コントロールには、実行後削除、エージェント上書きのクリア、cron の exact/stagger オプション、エージェントモデル/thinking 上書き、best-effort 配信トグルが含まれます。
• フォーム検証はフィールドレベルのエラーとしてインライン表示されます。無効な値がある場合、修正されるまで保存ボタンは無効化されます。
• 専用 bearer token を送信するには cron.webhookToken を設定します。省略した場合、Webhook は認証ヘッダーなしで送信されます。
• 非推奨のフォールバック: notify: true を持つ保存済みのレガシージョブは、移行されるまで引き続き cron.webhook を使用できます。

• chat.send は 非ブロッキング です。すぐに { runId, status: "started" } で ack し、レスポンスは chat イベント経由でストリーミングされます。
• チャットのアップロードは、画像に加えて動画以外のファイルを受け付けます。画像はネイティブの画像パスを保持します。その他のファイルは管理対象メディアとして保存され、履歴では添付リンクとして表示されます。
• 同じ idempotencyKey で再送信すると、実行中は { status: "in_flight" } を返し、完了後は { status: "ok" } を返します。
• chat.history のレスポンスは、UI の安全性のためサイズ制限されています。トランスクリプトエントリが大きすぎる場合、Gateway は長いテキストフィールドを切り詰め、重いメタデータブロックを省略し、サイズ超過のメッセージをプレースホルダー（[chat.history omitted: message too large]）に置き換えることがあります。
• アシスタント/生成画像は管理対象メディア参照として永続化され、認証済みの Gateway メディア URL 経由で返されるため、リロードは未加工の base64 画像ペイロードがチャット履歴レスポンスに残っていることに依存しません。
• chat.history をレンダリングするとき、Control UI は表示されるアシスタントテキストから、表示専用のインラインディレクティブタグ（例: [[reply_to_*]] と [[audio_as_voice]]）、プレーンテキストのツール呼び出し XML ペイロード（<tool_call>...</tool_call>、<function_call>...</function_call>、<tool_calls>...</tool_calls>、<function_calls>...</function_calls>、および切り詰められたツール呼び出しブロックを含む）、漏出した ASCII/全角のモデル制御トークンを取り除き、表示テキスト全体が厳密なサイレントトークン NO_REPLY / no_reply または Heartbeat 確認トークン HEARTBEAT_OK だけのアシスタントエントリを省略します。
• アクティブな送信中と最後の履歴更新中に、chat.history が一時的に古いスナップショットを返した場合でも、チャットビューはローカルの楽観的なユーザー/アシスタントメッセージを表示し続けます。Gateway 履歴が追いつくと、正規のトランスクリプトがそれらのローカルメッセージを置き換えます。
• ライブの chat イベントは配信状態であり、chat.history は永続的なセッショントランスクリプトから再構築されます。ツール最終イベントの後、Control UI は履歴を再読み込みし、小さな楽観的末尾だけをマージします。トランスクリプト境界は WebChat に記載されています。
• chat.inject はアシスタントノートをセッショントランスクリプトに追加し、UI 専用更新として chat イベントをブロードキャストします（エージェント実行なし、チャネル配信なし）。
• チャットヘッダーはセッションピッカーの前にエージェントフィルターを表示し、セッションピッカーは選択中のエージェントにスコープされます。エージェントを切り替えると、そのエージェントに関連付けられたセッションだけが表示され、保存済みダッシュボードセッションがまだない場合は、そのエージェントのメインセッションにフォールバックします。
• デスクトップ幅では、チャットコントロールはコンパクトな 1 行に収まり、トランスクリプトを下へスクロールしている間は折りたたまれます。上へスクロールする、先頭に戻る、または末尾に到達すると、コントロールが復元されます。
• 連続する重複したテキストのみのメッセージは、件数バッジ付きの 1 つのバブルとしてレンダリングされます。画像、添付ファイル、ツール出力、またはキャンバスプレビューを含むメッセージは折りたたまれません。
• チャットヘッダーのモデルと thinking のピッカーは、sessions.patch 経由でアクティブセッションを即座にパッチします。これらは永続的なセッション上書きであり、1 ターン限りの送信オプションではありません。
• Control UI で /new と入力すると、New Chat と同じ新規ダッシュボードセッションを作成して切り替えます。/reset と入力すると、現在のセッションに対して Gateway の明示的なインプレースリセットを維持します。
• チャットモデルピッカーは、Gateway の設定済みモデルビューを要求します。agents.defaults.models が存在する場合、その許可リストがピッカーを駆動します。それ以外の場合、ピッカーは明示的な models.providers.*.models エントリと、使用可能な認証を持つプロバイダーを表示します。完全なカタログは、デバッグ用の models.list RPC で view: "all" を指定すると引き続き利用できます。
• 新しい Gateway セッション使用量レポートが高いコンテキスト圧を示す場合、チャットコンポーザー領域にコンテキスト通知が表示され、推奨される Compaction レベルでは通常のセッション Compaction パスを実行するコンパクトなボタンが表示されます。古いトークンスナップショットは、Gateway が新しい使用量を再度報告するまで非表示になります。

トークモードは、登録済みのリアルタイム音声プロバイダーを使用します。OpenAI は talk.realtime.provider: "openai" と talk.realtime.providers.openai.apiKey で設定します。Google は talk.realtime.provider: "google" と talk.realtime.providers.google.apiKey で設定します。ブラウザーが標準のプロバイダー API キーを受け取ることはありません。OpenAI は WebRTC 用の一時的な Realtime クライアントシークレットを受け取ります。Google Live はブラウザー WebSocket セッション用に、1 回限りで制約付きの Live API 認証トークンを受け取り、指示とツール宣言は Gateway によってトークン内に固定されます。バックエンドのリアルタイムブリッジだけを公開するプロバイダーは Gateway リレートランスポート経由で実行されるため、認証情報とベンダーソケットはサーバー側に留まり、ブラウザー音声は認証済み Gateway RPC 経由で移動します。Realtime セッションプロンプトは Gateway によって組み立てられます。talk.client.create は呼び出し元が提供する指示の上書きを受け付けません。

チャットコンポーザーでは、Talk コントロールはマイク口述ボタンの隣にある波形ボタンです。Talk が開始すると、コンポーザーのステータス行はまず Connecting Talk... を表示し、音声が接続されると Talk live、リアルタイムツール呼び出しが talk.client.toolCall 経由で設定済みのより大きなモデルに問い合わせている間は Asking OpenClaw... を表示します。

メンテナー向けライブスモーク: OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts は、OpenAI ブラウザー WebRTC SDP 交換、Google Live の制約付きトークンによるブラウザー WebSocket セットアップ、および偽のマイクメディアを使った Gateway リレーのブラウザーアダプターを検証します。このコマンドはプロバイダーステータスだけを出力し、シークレットはログに記録しません。

• Stop をクリックします（chat.abort を呼び出します）。
• 実行がアクティブな間、通常のフォローアップはキューに入ります。キュー済みメッセージの Steer をクリックすると、そのフォローアップを実行中のターンに注入します。
• 帯域外で中止するには、/stop（または stop、stop action、stop run、stop openclaw、please stop などの単独の中止フレーズ）を入力します。
• chat.abort は、そのセッションのすべてのアクティブな実行を中止するために { sessionKey }（runId なし）をサポートします。

• 実行が中止されても、部分的なアシスタントテキストは UI に引き続き表示できます。
• バッファ済み出力が存在する場合、Gateway は中止された部分的なアシスタントテキストをトランスクリプト履歴に永続化します。
• 永続化されたエントリには中止メタデータが含まれるため、トランスクリプト利用側は中止部分と通常の完了出力を区別できます。

{
  gateway: {
    controlUi: { allowInsecureAuth: true },
    bind: "tailnet",
    auth: { mode: "token", token: "replace-me" },
  },
}

allowInsecureAuth はローカル互換性用のトグルのみです。

• 非セキュアな HTTP コンテキストで、localhost の Control UI セッションがデバイス ID なしで続行できるようにします。
• ペアリングチェックをバイパスしません。
• リモート（非 localhost）のデバイス ID 要件を緩和しません。

{
  gateway: {
    controlUi: { dangerouslyDisableDeviceAuth: true },
    bind: "tailnet",
    auth: { mode: "token", token: "replace-me" },
  },
}

• 信頼済みプロキシ認証に成功すると、デバイス ID なしでオペレーター Control UI セッションを許可できます。
• これはノードロールの Control UI セッションには拡張されません。
• 同一ホストの loopback リバースプロキシでも信頼済みプロキシ認証は満たされません。信頼済みプロキシ認証を参照してください。

• gatewayUrl は読み込み後に localStorage に保存され、URL から削除されます。
• gatewayUrl 経由で完全な ws:// または wss:// エンドポイントを渡す場合は、ブラウザがクエリ文字列を正しく解析できるように gatewayUrl 値を URL エンコードしてください。
• 可能な限り、token は URL フラグメント（#token=...）経由で渡してください。フラグメントはサーバーに送信されないため、リクエストログや Referer への漏えいを避けられます。従来の ?token= クエリパラメーターも互換性のために一度だけインポートされますが、フォールバックとしてのみ扱われ、ブートストラップ直後に取り除かれます。
• password はメモリ内のみに保持されます。
• gatewayUrl が設定されている場合、UI は設定や環境の認証情報にフォールバックしません。token（または password）を明示的に指定してください。明示的な認証情報がない場合はエラーです。
• Gateway が TLS（Tailscale Serve、HTTPS プロキシなど）の背後にある場合は wss:// を使用してください。
• クリックジャッキングを防ぐため、gatewayUrl はトップレベルウィンドウ（埋め込みではない）でのみ受け付けられます。
• 非 loopback の Control UI デプロイでは、gateway.controlUi.allowedOrigins を明示的に設定する必要があります（完全なオリジン）。これにはリモート開発セットアップも含まれます。
• Gateway の起動時に、有効なランタイムの bind とポートから http://localhost:<port> や http://127.0.0.1:<port> などのローカルオリジンがシードされる場合がありますが、リモートブラウザのオリジンには引き続き明示的なエントリが必要です。
• 厳密に制御されたローカルテストを除き、gateway.controlUi.allowedOrigins: ["*"] は使用しないでください。これは任意のブラウザオリジンを許可するという意味であり、「自分が使っているホストに一致させる」という意味ではありません。
• gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true は Host ヘッダーのオリジンフォールバックモードを有効にしますが、危険なセキュリティモードです。