Control UI

• Gateway WS 経由でモデルとチャットします（chat.history, chat.send, chat.abort, chat.inject）。
• チャット履歴の更新では、メッセージごとのテキスト上限付きで境界付きの最近のウィンドウを要求するため、大規模セッションでも、チャットが使用可能になる前にブラウザーが完全なトランスクリプトペイロードをレンダリングする必要がありません。
• ブラウザーのリアルタイムセッションを通じて通話します。OpenAI は直接 WebRTC を使用し、Google Live は WebSocket 経由の制約付き使い捨てブラウザートークンを使用し、バックエンド専用のリアルタイム音声 Plugin は Gateway リレートランスポートを使用します。クライアント所有のプロバイダーセッションは talk.client.create で開始します。Gateway リレーセッションは talk.session.create で開始します。リレーはプロバイダー認証情報を Gateway 上に保持し、ブラウザーが talk.session.appendAudio を通じてマイク PCM をストリーミングする間、Gateway ポリシーと設定済みのより大きな OpenClaw モデルのために openclaw_agent_consult プロバイダーツール呼び出しを talk.client.toolCall 経由で転送し、アクティブ実行の音声ステアリングを talk.client.steer または talk.session.steer 経由でルーティングします。
• Chat でツール呼び出しとライブツール出力カードをストリーミングします（エージェントイベント）。
• Activity タブでは、既存の session.tool / ツールイベント配信から、ライブツールアクティビティのブラウザーローカルかつ秘匿優先の要約を表示します。

• チャネル: 組み込みおよびバンドル/外部 Plugin チャネルのステータス、QR ログイン、チャネルごとの設定（channels.status, web.login.*, config.patch）。
• チャネルプローブの更新では、遅いプロバイダーチェックが完了するまで前回のスナップショットを表示し続け、プローブまたは監査が UI 予算を超えた場合は部分スナップショットにラベルが付けられます。
• インスタンス: プレゼンス一覧と更新（system-presence）。
• セッション: デフォルトで設定済みエージェントセッションを一覧表示し、頻繁なセッションをピン留めし、名前を変更し、非アクティブなセッションをアーカイブまたは復元し、古い未設定エージェントセッションキーからフォールバックし、セッションごとのモデル/thinking/fast/verbose/trace/reasoning 上書きを適用します（sessions.list, sessions.patch）。ピン留めされたセッションは最近の未ピン留めセッションより上に並びます。アーカイブ済みセッションは Sessions ページのアーカイブビューにあり、トランスクリプトを保持します。
• 夢: Dreaming ステータス、有効/無効トグル、Dream Diary リーダー（doctor.memory.status, doctor.memory.dreamDiary, config.patch）。

• Cron ジョブ: 一覧/追加/編集/実行/有効化/無効化と実行履歴（cron.*）。
• Skills: ステータス、有効化/無効化、インストール、API キー更新（skills.*）。
• ノード: 一覧と機能（node.list）、モバイルセットアップコードの作成、デバイスペアリングの承認（device.pair.*）。
• Exec 承認: Gateway またはノードの許可リストと exec host=gateway/node の ask policy を編集します（exec.approvals.*）。

• ~/.openclaw/openclaw.json を表示/編集します（config.get、config.set）。
• MCP には、設定済みサーバー、有効化、OAuth/フィルター/並列サマリー、一般的なオペレーターコマンド、スコープ付きの mcp 設定エディターのための専用設定ページがあります。
• 検証付きで適用 + 再起動し（config.apply）、最後にアクティブだったセッションを起動します。
• 書き込みには、同時編集の上書きを防ぐベースハッシュガードが含まれます。
• 書き込み（config.set/config.apply/config.patch）は、送信された設定ペイロード内の参照について、アクティブな SecretRef 解決を事前確認します。未解決のアクティブな送信済み参照は、書き込み前に拒否されます。
• フォーム保存では、保存済み設定から復元できない古い墨消しプレースホルダーを破棄しつつ、保存済みシークレットにまだ対応している墨消し値は保持します。
• スキーマ + フォーム描画（config.schema / config.schema.lookup、フィールド title / description、一致した UI ヒント、直接の子サマリー、ネストされたオブジェクト/ワイルドカード/配列/合成ノード上のドキュメントメタデータ、利用可能な場合は plugin + チャンネルスキーマを含む）。Raw JSON エディターは、スナップショットが安全な raw ラウンドトリップを持つ場合にのみ利用できます。
• スナップショットが raw テキストを安全にラウンドトリップできない場合、Control UI はそのスナップショットについてフォームモードを強制し、Raw モードを無効にします。
• Raw JSON エディターの「保存済みにリセット」は、フラット化されたスナップショットを再描画するのではなく、raw で作成された形（フォーマット、コメント、$include レイアウト）を保持するため、スナップショットが安全にラウンドトリップできる場合は外部編集がリセット後も残ります。
• 構造化された SecretRef オブジェクト値は、誤ってオブジェクトから文字列へ破損することを防ぐため、フォームのテキスト入力では読み取り専用として描画されます。

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

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

• chat.send は 非ブロッキング です。{ runId, status: "started" } で即座に ACK し、応答は chat イベント経由でストリーミングされます。信頼済みの Control UI クライアントは、ローカル診断用に任意の ACK タイミングメタデータも受け取る場合があります。
• チャットアップロードは、画像と動画以外のファイルを受け付けます。画像はネイティブ画像パスを保持し、それ以外のファイルは管理メディアとして保存され、履歴では添付リンクとして表示されます。
• 同じ idempotencyKey で再送信すると、実行中は { status: "in_flight" } を返し、完了後は { status: "ok" } を返します。
• chat.history の応答は UI の安全性のためサイズ制限されています。トランスクリプトエントリーが大きすぎる場合、Gateway は長いテキストフィールドを切り詰め、重いメタデータブロックを省略し、サイズ超過のメッセージをプレースホルダー（[chat.history omitted: message too large]）で置き換えることがあります。
• 表示可能な assistant メッセージが chat.history で切り詰められた場合、サイドリーダーは sessionKey、必要に応じてアクティブな agentId、トランスクリプト messageId によって、表示正規化済みの完全なトランスクリプトエントリーを chat.message.get 経由でオンデマンド取得できます。Gateway がそれでも追加分を返せない場合、リーダーは切り詰められたプレビューを無言で繰り返すのではなく、明示的な利用不可状態を表示します。
• assistant/生成画像は管理メディア参照として永続化され、認証済み 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/全角のモデル制御トークンを、表示される assistant テキストから取り除きます。また、表示テキスト全体が厳密なサイレントトークン NO_REPLY / no_reply または Heartbeat 確認トークン HEARTBEAT_OK のみである assistant エントリーを省略します。
• アクティブな送信中と最後の履歴更新中に chat.history が一時的に古いスナップショットを返した場合でも、チャットビューはローカルの楽観的なユーザー/assistant メッセージを表示し続けます。Gateway 履歴が追いつくと、正規トランスクリプトがそれらのローカルメッセージを置き換えます。
• ライブの chat イベントは配信状態であり、chat.history は永続的なセッショントランスクリプトから再構築されます。ツール最終イベントの後、Control UI は履歴を再読み込みし、小さな楽観的テールのみをマージします。トランスクリプト境界は WebChat に記載されています。
• chat.inject は assistant ノートをセッショントランスクリプトに追加し、UI 専用更新用の chat イベントをブロードキャストします（エージェント実行なし、チャンネル配信なし）。
• サイドバーには、最近のセッションが New Session アクション、All Sessions リンク、完全なセッションピッカーを開くセッション検索ボタン（選択中のエージェントでスコープされ、検索とページネーション付き）とともに一覧表示されます。エージェントを切り替えると、そのエージェントに紐づくセッションのみが表示され、保存済みダッシュボードセッションがまだない場合はそのエージェントのメインセッションにフォールバックします。
• 各セッションピッカー行では、セッションの名前変更、ピン留め、アーカイブができます。アクティブな実行とエージェントのメインセッションはアーカイブできません。現在選択中のセッションをアーカイブすると、チャットはそのエージェントのメインセッションへ戻ります。
• デスクトップ幅では、チャットコントロールはコンパクトな 1 行に留まり、トランスクリプトを下にスクロールしている間は折りたたまれます。上にスクロールする、先頭に戻る、または末尾に到達すると、コントロールが復元されます。
• 連続する重複したテキストのみのメッセージは、件数バッジ付きの 1 つの吹き出しとして描画されます。画像、添付、ツール出力、またはキャンバスプレビューを含むメッセージは折りたたまれません。
• チャットヘッダーのモデルと thinking ピッカーは、sessions.patch 経由でアクティブセッションを即座にパッチします。これらは永続的なセッションオーバーライドであり、1 ターン限定の送信オプションではありません。
• 同じセッションのモデルピッカー変更がまだ保存中の間にメッセージを送信した場合、コンポーザーは chat.send を呼び出す前にそのセッションパッチを待つため、送信には選択済みモデルが使用されます。
• Control UI で /new と入力すると、session.dmScope: "main" が設定されていて現在の親がエージェントのメインセッションである場合を除き、新規チャットと同じ新しいダッシュボードセッションを作成して切り替えます。その場合はメインセッションをその場でリセットします。/reset と入力すると、現在のセッションに対する Gateway の明示的なインプレースリセットを保持します。
• チャットモデルピッカーは、Gateway の設定済みモデルビューを要求します。agents.defaults.models が存在する場合、その許可リストがピッカーを駆動します。これには、プロバイダースコープのカタログを動的に保つ provider/* エントリーも含まれます。それ以外の場合、ピッカーは明示的な models.providers.*.models エントリーと、利用可能な認証を持つプロバイダーを表示します。完全なカタログは、view: "all" を指定したデバッグ用 models.list RPC から引き続き利用できます。
• 新しい Gateway セッション使用量レポートに現在のコンテキストトークンが含まれる場合、チャットコンポーザーツールバーには使用率を示す小さなコンテキスト使用量リングが表示されます。完全なトークン詳細はツールチップにあります。リングはコンテキスト圧力が高いと警告スタイルに切り替わり、推奨 Compaction レベルでは通常のセッション Compaction パスを実行するコンパクトなボタンを表示します。古いトークンスナップショットは、Gateway が新しい使用量を再度報告するまで非表示になります。

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

Chat composer には、Talk の開始/停止ボタンの横に Talk オプションボタンがあります。オプションは次の Talk セッションに適用され、プロバイダー、トランスポート、モデル、音声、推論エフォート、VAD しきい値、無音時間、プレフィックスパディングを上書きできます。オプションが空欄の場合、Gateway は利用可能なら設定済みのデフォルトを使用し、なければプロバイダーのデフォルトを使用します。Gateway リレーを選択するとバックエンドリレーパスが強制されます。WebRTC を選択するとセッションはクライアント所有のままになり、プロバイダーがブラウザーセッションを作成できない場合にリレーへ暗黙にフォールバックせず失敗します。

Chat composer では、Talk コントロールはマイクのディクテーションボタンの横にある波形ボタンです。Talk が開始すると、composer のステータス行には、音声が接続されている間はまず 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 バックエンド WebSocket ブリッジ、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 要件は緩和しません。

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

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