コントロール UI

Control UI は、Gateway によって提供される小規模な Vite + Lit シングルページアプリです。

• デフォルト: http://<host>:18789/
• オプションのプレフィックス: gateway.controlUi.basePath を設定（例: /openclaw）

同じポート上の Gateway WebSocket と直接通信します。

クイックオープン（ローカル）

Gateway が同じコンピューターで実行されている場合は、http://127.0.0.1:18789/（または http://localhost:18789/）を開きます。

ページを読み込めない場合は、まず Gateway を起動します: openclaw gateway。

認証は、WebSocket ハンドシェイク中に次の方法で提供されます。

• connect.params.auth.token
• connect.params.auth.password
• gateway.auth.allowTailscale: true の場合は Tailscale Serve ID ヘッダー
• gateway.auth.mode: "trusted-proxy" の場合は信頼済みプロキシ ID ヘッダー

ダッシュボードの設定パネルは、現在のブラウザータブセッションと選択した Gateway URL に対するトークンを保持します。パスワードは永続化されません。通常、オンボーディングでは最初の接続時に共有シークレット認証用の Gateway トークンが生成されますが、gateway.auth.mode が "password" の場合はパスワード認証も使用できます。

デバイスのペアリング（初回接続）

新しいブラウザーまたはデバイスから接続する場合、通常は disconnected (1008): pairing required として表示される 1 回限りのペアリング承認が必要です。

openclaw devices list

openclaw devices approve <requestId>

ブラウザーが認証情報（ロール、スコープ、公開鍵）を変更してペアリングを再試行すると、以前の保留中リクエストは置き換えられ、新しい requestId が作成されます。承認する前に openclaw devices list を再実行してください。

すでにペアリング済みのブラウザーを読み取りアクセスから書き込みまたは管理者アクセスへ切り替える場合、暗黙の再接続ではなく、承認のアップグレードとして扱われます。OpenClaw は以前の承認を有効なまま維持し、より広範な権限での再接続をブロックして、新しいスコープセットを明示的に承認するよう求めます。

承認後はデバイスが記憶され、openclaw devices revoke --device <id> --role <role> で取り消さない限り、再承認は必要ありません。トークンのローテーション、取り消し、および Paperclip / openclaw_gateway の初回実行承認フローについては、デバイス CLI を参照してください。

モバイルデバイスをペアリングする

すでにペアリング済みの管理者は、ターミナルを開かずに iOS/Android 接続用の QR コードを作成できます。

セットアップコードの作成には operator.admin が必要です。これを持たないセッションではボタンが無効になります。セットアップコードには有効期間の短いブートストラップ認証情報が含まれるため、有効な間は QR コードとコピーしたコードをパスワードと同様に扱ってください。リモートペアリングでは、Gateway が wss:// に解決される必要があります（たとえば Tailscale Serve/Funnel 経由）。通常の ws:// は loopback とプライベート LAN アドレスに限定されます。セキュリティとフォールバックの詳細については、ペアリング を参照してください。

個人 ID（ブラウザー内のみ）

Control UI は、共有セッションで送信者を識別できるよう、送信メッセージに付加されるブラウザーごとの個人 ID（表示名とアバター）をサポートします。これは現在のブラウザープロファイルをスコープとしてブラウザーストレージに保存され、他のデバイスには同期されません。また、送信したメッセージに通常付与されるトランスクリプトの作成者メタデータを除き、サーバー側には永続化されません。サイトデータを消去するかブラウザーを切り替えると、空の状態にリセットされます。

アシスタントのアバター上書きも同じブラウザー内のみの方式に従います。アップロードした上書きは、Gateway が解決した ID にローカルで重ねられ、config.patch を介して往復することはありません。共有の ui.assistant.avatar 設定フィールドは、このフィールドへ直接書き込む非 UI クライアント向けに引き続き利用できます。

ランタイム設定エンドポイント

Control UI は、Gateway の Control UI ベースパスを基準に解決される /control-ui-config.json からランタイム設定を取得します（たとえば、ベースパス /__openclaw__/ では /__openclaw__/control-ui-config.json）。このエンドポイントは、その他の HTTP サーフェスと同じ Gateway 認証によって保護されます。未認証のブラウザーは取得できず、取得に成功するには、有効な Gateway トークンまたはパスワード、Tailscale Serve ID、あるいは信頼済みプロキシ ID が必要です。

Gateway ホストの状態

シンプルビューで 設定を開くと、Gateway のマシン、LAN アドレス、オペレーティングシステム、ランタイム、稼働時間、CPU 負荷、メモリ、状態ボリュームのディスク容量が表示される Gateway ホストカードを確認できます。このカードは表示中、system.info Gateway RPC を介して 10 秒ごとに更新されます。この RPC には operator.read スコープが必要です。古い Gateway や、そのスコープを持たない接続では、このカードは表示されません。

言語サポート

Control UI は初回読み込み時に、ブラウザーのロケールに基づいて自身をローカライズします。後で上書きするには、Settings -> General -> Language を開きます（選択項目は Appearance の下ではなく、General クイック設定カードにあります）。

• サポート対象ロケール: en, ar, de, es, fa, fr, hi, id, it, ja-JP, ko, nl, pl, pt-BR, ru, th, tr, uk, vi, zh-CN, zh-TW
• 英語以外の翻訳はブラウザーで遅延読み込みされます。
• 選択したロケールはブラウザーストレージに保存され、以後のアクセスで再利用されます。
• 翻訳キーがない場合は英語にフォールバックします。

ドキュメントの翻訳も同じ英語以外のロケールセットに対して生成されますが、ドキュメントサイトに組み込まれた Mintlify の言語選択には、Mintlify が受け付けるロケールコードのみが表示されます。タイ語（th）とペルシャ語（fa）のドキュメントも公開リポジトリには生成されますが、Mintlify がこれらのコードをサポートするまでは選択項目に表示されない場合があります。

外観テーマ

外観パネルには組み込みの Claw、Knot、Dash テーマ（デフォルトは Claw）と、ブラウザー内のみの tweakcn インポートスロットが 1 つあります。テーマをインポートするには、tweakcn エディターを開き、テーマを選択または作成して Share をクリックし、コピーしたリンクを外観に貼り付けます。インポーターは、https://tweakcn.com/r/themes/<id> レジストリ URL、https://tweakcn.com/editor/theme?theme=amethyst-haze のようなエディター URL、相対 /themes/<id> パス、生のテーマ ID、および amethyst-haze のようなデフォルトテーマ名にも対応しています。

インポートしたテーマは現在のブラウザープロファイルにのみ保存されます。Gateway 設定には書き込まれず、デバイス間でも同期されません。インポートしたテーマを置き換えると、1 つのローカルスロットが更新されます。インポートしたテーマが有効な状態で消去すると、Claw に戻ります。

外観にはブラウザー内のみのテキストサイズ設定もあり、Control UI の他の設定とともに保存されます。これはチャットテキスト、コンポーザーテキスト、ツールカード、チャットサイドバーに適用されます。また、モバイル Safari がフォーカス時に自動ズームしないよう、テキスト入力を 16px 以上に保ちます。

Plugin を管理する

サイドバーで Plugin を開くか、設定済みの Control UI ベースパスを基準とする /settings/plugins を使用すると、Control UI を離れずに Plugin を参照および管理できます。たとえば、ベースパスが /openclaw の場合は /openclaw/settings/plugins を使用します。このページは、すべてのオプション Plugin が無効でも常に利用できます。

Plugin は、4 つのタブを備えたハブです。インストール済みと 検出では /settings/plugins の Plugin コードを管理し、Skillsでは /skills のエージェントごとのスキルマネージャーを提供し、ワークショップでは /skills/workshop のスキルワークショップ提案レビューを提供します。各タブはそれぞれ固有の URL を保持し、サイドバーにはこれらすべてに対する単一の Plugin 項目が表示されます。

インストール済みタブには、概要の件数とともに、カテゴリ別にグループ化されたローカルの完全なインベントリが表示されます。各行を開くと詳細ビューが表示されます。オーバーフロー（…）メニューでは Plugin を有効または無効にでき、外部からインストールした Plugin には 削除も表示されます。また、設定済みの MCP サーバーを一覧表示し、その場での追加、無効化、削除をサポートします。検出タブはストアです。OpenClaw に含まれる注目の Plugin、公式の外部 Plugin、人気サービス向けのワンクリック MCP コネクターが表示されます。検索ボックスに入力すると、ClawHub がインラインで検索され、ダウンロード数とソース検証バッジを含む ClawHub からセクションが追加されます。ディープリンクでは /settings/plugins?tab=discover を使用してストアを直接開けます。

Skillsタブには、選択したエージェントをスコープとして、スキル状態レポート、有効化と無効化の切り替え、API キー入力、インラインの ClawHub スキル検索があります。ワークショップタブには、スキル提案向けのスキルワークショップボードと Today レビューフローがあります。スキルのアイデアを探すでは、新しいものから古いものの順に、一定範囲の内容のあるセッションをレビューし、結果を保留中の提案として残します。パネルには累積カバレッジが表示されます。以前の作業をスキャンでは永続化されたカーソルから処理を継続し、古い履歴をすべて処理すると 新しい作業をスキャンに変わります。自律的な自己学習が無効でも手動の履歴レビューは機能し、選択したエージェントに設定されたモデルを使用します。

同梱 Plugin はすでに Gateway 上に存在し、インストールではなく 有効化または 無効化が表示されます。たとえば、Workboard は OpenClaw に含まれていますがデフォルトでは無効なため、アクションは 有効化です。バンドルされた Plugin は削除できず、無効化のみ可能です。

カタログの読み取りと ClawHub の検索には operator.read が必要です。Plugin のインストール、有効化、無効化、削除、および MCP サーバーの変更には operator.admin が必要です。読み取り専用オペレーターの場合、これらの操作は無効のままです。

ClawHub のインストールは Gateway を介して実行され、Gateway が仲介する他のインストールと同じ信頼性、整合性、Plugin インストールポリシーのチェックが適用されます。Plugin コードのインストールまたは削除には Gateway の再起動が必要です。インストール済み Plugin の有効化または無効化は、その Plugin と現在の Gateway ランタイムが対応していれば再起動なしで適用できます。対応していない場合、UI は再起動が必要であることを報告します。OAuth を使用する MCP コネクターでは、追加後に CLI から 1 回限りの openclaw mcp login <name> を実行する必要があります。

このページは意図的に、インベントリ、検出、インストール、有効化、削除に重点を置いています。任意の npm、git、ローカルパスのソース、更新、高度な Plugin 設定には、openclaw pluginsを使用してください。

サイドバーナビゲーション

サイドバーでは、スクロール可能なセッション一覧の上にナビゲーションが固定表示されます。マルチエージェント構成では、各エージェントが折りたたみ可能な最上位セクションとして表示されます。エージェントを展開すると、開いているチャットから移動せずにそのセッションを参照でき、折りたたまれたエージェントには未読インジケーターが表示されます。エージェント内では、一覧は 固定済み、接続されたチャンネル（Telegram、Slack、WhatsApp、...）ごとの組み込みセクション、管理対象のワークツリーまたは実行 Node に関連付けられたセッション用の組み込み 作業 セクション（行には repo ⎇ branch の行と Node ホストが表示されます）、カスタムグループ（セッション category）、およびその他のセッション用の チャット に分かれます。チャンネルセクションと作業セクションでは行が自動的に分類されますが、セッションをカスタムグループに割り当てた場合は、常にその割り当てが優先されます。セッションを開くと、行の順序を変更せずに選択ハイライトが移動します。最後に既読にしてから新しいアクティビティがあったセッションには未読ドットが表示され、開くと既読になります。各セッション行にはコンテキストメニュー（ケバブボタンまたは右クリック）があり、固定/固定解除、未読/既読にする、名前を変更、フォーク、グループへ移動（新しいグループおよびグループから削除を含む）、アーカイブ、削除を実行できます。タッチレイアウトでは、直接操作できる固定ボタンとメニューコントロールが常に表示されます。Cmd/Ctrl クリックで行の複数選択を切り替え、Shift クリックで表示順に沿って選択範囲を拡張できます。選択された行のメニューを開くと、一括操作（N 件を未読/既読にする、N 件をグループへ移動、N 件をアーカイブ、N 件を削除）が表示され、選択中のすべてのセッションに適用されます。一括削除では確認は一度だけ行われます。セッションをカスタムグループまたは チャット にドラッグすると移動できます。カスタムグループのヘッダーは、折りたたみ、展開、またはドラッグによる並べ替えが可能です。グループ名とその順序は gateway（sessions.groups.*）に保存されるため、ブラウザーをまたいで引き継がれます。一方、折りたたみ状態はブラウザープロファイルに保存されます。グループヘッダーにもメニュー（ケバブボタンまたは右クリック）があり、グループ名を変更、新しいグループ、グループを削除を実行できます。グループ名の変更またはグループの削除は、アーカイブ済みのものを含むすべてのメンバーセッションにサーバー側で反映されます。グループを削除してもセッションは維持され、チャットへ戻されます。セッション一覧ヘッダーにある唯一の + を選択すると、新しいセッションページが開きます（以下を参照）。並べ替えコントロールにはグループ化の切り替えもあり、グループ化（デフォルト）またはなしを選択して、1 つのフラットな一覧にできます（固定済みは引き続き分離されます）。選択内容は現在のブラウザープロファイルに保存されます。使用状況、自動化、Plugin はデフォルトで固定されています。その他 行を選択すると、Plugin が提供するタブを含む、その他すべての移動先を含むメニューが開きます。そのメニューで 固定項目を編集 を選択するか、ナビゲーション領域を右クリックすると、移動先の固定または固定解除、およびデフォルトへの復元ができます。固定項目のセットは現在のブラウザープロファイルに保存され、再読み込み後も維持されます。

新しいセッションページ

サイドバーのセッション一覧ヘッダーにある + を選択すると、/new に全画面の下書きが開きます。最初のメッセージを送信するまで何も作成されません。メッセージボックスの上にあるターゲット行では、セッションの作業場所を選択します。エージェント（マルチエージェント構成の場合）、実行処理の実行先（Gateway · ローカル、または system.run を公開するペアリング済み Node。operator.admin が必要）、フォルダー（デフォルトはエージェントのワークスペース。その他の絶対 Gateway パスには operator.admin とワークツリーが必要）、およびオプションの ワークツリー 切り替えを指定できます。ワークツリー切り替えには、ベースブランチ選択（worktrees.branches に基づくため、フェッチは発生しません）と、オプションのワークツリー名（ブランチは openclaw/<name> になります）があります。フォルダーチップの参照ボタンを選択すると、管理者専用の fs.listDir メソッドを使用するインラインディレクトリ選択画面が開きます。最上位には Gateway と既知のすべての Node が表示されます。オフラインの Node とディレクトリ参照をサポートしない Node も表示されたままですが、無効化されます。Gateway を選択すると、現在のフォルダーまたは Gateway のホームから開始します。対応する Node を選択すると、その Node のホストファイルシステムを参照し、実行処理をその Node に関連付け、選択した Node の絶対パスを直接使用します（管理対象ワークツリーは引き続き Gateway でのみ使用できます）。送信すると、最初のメッセージを指定して sessions.create が呼び出されるため、同じラウンドトリップで実行が開始され、UI は新しいセッションのチャットへ移動します。Gateway がセッションを作成したものの、その最初の送信を拒否した場合、チャットでは再読み込み後もプロンプトとエラーが保持されます。再試行 を選択すると、別のセッションを作成せず、すでに作成済みのセッションを通じて送信されます。

Settings 内では、専用サイドバーの先頭に、設定セクションをすばやく見つけるための Search settings フィールドがあります。

サイドバー上部の Search フィールドを使用すると、コマンドパレット（⌘K）が開きます。サイドバーのヘッダーにある OpenClaw ブランドをクリックすると、すっきりした新規セッション開始画面が開きます。失敗または期限超過した Cron ジョブ、期限切れ間近または期限切れのモデル認証など、対処が必要なものがある場合は、サイドバーのフッター上部にコンパクトな注意チップが表示され、クリックすると該当ページに移動します。フッターには、アクティブなエージェントがチップとして表示されます。チップにはアバター（アイデンティティ画像または絵文字）、名前、接続状態を示すドット、リアルタイムのサブタイトルが含まれ、新規セッション用の + もあります。チップをクリックすると、エージェントメニューが開きます。このメニューには、エージェント切り替え（マルチエージェント構成）、"このエージェントで何ができますか？"、エージェント設定、設定、モバイルペアリング、ドキュメント、ビルドチップ、カラーモード切り替えがあります。エージェントが 10 個を超えるリストにはフィルターフィールドが表示され、ピン留めされたエージェントが先頭に並びます。エージェントのピン留めや解除はエージェント設定ページで行い、ピン留めしたセットはブラウザプロファイルに保存されます。エージェントを選択すると、チャットに加えて、使用状況、自動化、タスク、ワークボード、セッションのスコープがそのエージェントに限定されます。スコープ付きの各ページには エージェント コントロールがあり、スコープを解除するための すべてのエージェント が用意されています。これにより、具体的なチャットエージェントを変更せずに共有ページのスコープが広がりますが、セッションへの直接リンクでは引き続き対象セッションが開きます。エージェント設定ページは独自の ?agent= 選択を保持し、共有ページのスコープには従いません。Gateway がソースチェックアウトから main 以外のブランチで実行されている場合、非リリース版の Gateway であることが一目で分かるよう、フッターにはそのブランチ名も赤色で表示されます（リリース版のインストールでは表示されません）。Shift-Command-Comma を押すと、ブラウザの Command-Comma ショートカットを上書きせずに 設定 が開きます。サイドバーのヘッダーには折りたたみ切り替え（⌘B）もあります。折りたたむとサイドバーが完全に非表示になり、ワークスペースが全幅表示になります。フローティング展開コントロール（または ⌘B）で元に戻せます。macOS アプリでは、代わりにこの切り替えがタイトルバーにネイティブに配置されます。デスクトップではサイドバーが唯一のナビゲーション領域であり、トップバーはありません。狭いビューポートでは、サイドバーの代わりにスライドオーバードロワーが表示され、その手前のコンパクトなヘッダー行に、ドロワー切り替え、ブランド、コマンドパレット検索が配置されます。macOS アプリでは、このヘッダー行にタイトルバーの余白が統合され、ウィンドウコントロールの横に 1 本のコンパクトな帯として表示されます。ナビゲーションには通常のブラウザ履歴が使用されるため、ブラウザの戻る／進むボタンで履歴をたどれます。macOS アプリではさらに、ウィンドウコントロールの横にネイティブのサイドバー切り替えとトラックパッドのスワイプジェスチャーが追加されます。サイドバーを展開している間は右端に戻る／進むボタンが表示され、折りたたんでいる間はネイティブ検索（コマンドパレット）ボタンと新規セッションボタンが表示されます。

現在できること

アシスタントメモリのインポート

ローカルのCodexまたはClaude CodeメモリをOpenClawエージェントに取り込むには、設定 → メモリのインポートを開きます。Gatewayは自身のホスト上でサポートされているローカルメモリを検出するため、リモートのControl UIではブラウザーのコンピューターではなくGatewayのコンピューターからインポートします。

1. インポート先のエージェントを選択します。
2. 検出されたソースコレクションとMarkdownファイル名を確認します。ファイルの内容は プランのレスポンスでは送信されず、ページにも表示されません。
3. インポートするコレクションを選択して確認します。適用時には書き込み前にプランが再構築されるため、 古くなった選択は安全に失敗します。
4. ファイルがすでに存在する場合は、既存のインポートを置換を有効にしてプレビューを 更新し、置換を確認します。

Codexは統合済みのMEMORY.mdとmemory_summary.mdのみをインポートします。Claude Codeはプロジェクトの自動メモリディレクトリと設定済みの autoMemoryDirectoryからMarkdownをインポートします。このページを通じてセッション、設定、指示、または 資格情報をインポートすることはありません。ファイルは選択したワークスペースの memory/imports/配下にコピーされ、アクティブなメモリPluginがインデックスを作成できます。ソースが 変更されることはありません。

計画と適用には operator.admin が必要です。適用するたびに、状態が存在する場合は検証済みの OpenClaw バックアップを作成し、機密情報を除去した移行レポートを書き込み、既存の宛先ファイルを置き換える前に 項目単位のバックアップを保持します。パスと 呼び出し動作については、メモリの概要を参照してください。

MCP ページ

専用の MCP ページは、mcp.servers 配下にある OpenClaw 管理の MCP サーバー向けオペレータービューです。このページ自体が MCP トランスポートを起動することはありません。保存済みの設定を確認および編集するために使用し、稼働中のサーバーを検証する必要がある場合は openclaw mcp doctor --probe を使用してください。

一般的なワークフロー：

1. サイドバーから MCP を開きます。
2. 概要カードで、サーバーの合計数、有効数、OAuth 対応数、フィルタリング済み数を確認します。
3. 各サーバー行で、トランスポート、有効化状態、認証、フィルター、タイムアウト、コマンドのヒントを確認します。
4. Plugins ページでサーバーを管理（追加、有効化／無効化、削除）します。このページは mcp.servers を対話的に書き込む唯一の場所であり、ここにある行一覧からリンクされています。
5. サーバー定義、ヘッダー、TLS/mTLS パス、OAuth メタデータ、ツールフィルター、Codex 投影メタデータについて、対象範囲の mcp 設定セクションを編集します。
6. 設定を書き込むには Save を使用し、稼働中の Gateway に変更後の設定を適用させる場合は Save & Publish を使用します。
7. 静的診断、稼働中の検証、またはキャッシュ済みランタイムの破棄を行うには、ターミナルから openclaw mcp status --verbose、openclaw mcp doctor --probe、または openclaw mcp reload を実行します。

このページでは、認証情報を含む URL 形式の値をレンダリング前に秘匿化し、コマンドスニペット内のサーバー名を引用符で囲みます。そのため、名前に空白やシェルのメタ文字が含まれていても、コピーしたコマンドは引き続き動作します。CLI と設定の完全なリファレンス：MCP。

アクティビティタブ

アクティビティタブは、Logs と Debug の横にある Settings › System 内にあります。これはツールのライブアクティビティを監視する一時的なブラウザーローカルのオブザーバーであり、Chat のツールカードにも使用されている Gateway の session.tool／ツールイベントストリームから生成されます。Gateway の別のイベントファミリー、エンドポイント、永続的なアクティビティストア、メトリクスフィード、または外部オブザーバーストリームを追加するものではありません。

アクティビティエントリには、サニタイズされた概要と、秘匿化および切り詰められた出力プレビューのみが保持されます。ツール引数の値はアクティビティ状態に保存されません。UI には引数が非表示であることが示され、引数フィールド数のみが記録されます。メモリ内の一覧は現在のブラウザタブに追従し、Control UI 内を移動しても維持されますが、ページの再読み込み、セッションの切り替え、または Clear でリセットされます。

オペレーターターミナル

ドッキング可能なオペレーターターミナルは、デフォルトでは無効です。有効にするには、gateway.terminal.enabled: true を設定して Gateway を再起動します。ターミナルには operator.admin 接続が必要で、アクティブなエージェントワークスペース内でホスト PTY を開きます。新しいタブは、現在選択されているチャットエージェントに従います。

ドックの表示を切り替えるには Ctrl + backtick を使用します。レイアウトは下部および右側へのドッキングに対応し、ブラウザーのビューポートに合わせてサイズが変わり、複数のシェルタブを保持します。gateway.terminal.enabled と任意の gateway.terminal.shell オーバーライドについては、Gateway の設定を参照してください。

セッションサイドバーで検出された Codex および Claude Code セッションは、同じターミナルパネル内で各ネイティブ CLI を開けます。Settings › Chat で Open Codex/Claude sessions in を Terminal に設定すると、通常の行クリックで codex resume または claude --resume が開きます。デフォルトは引き続き読み取り専用の OpenClaw ビューアーです。行の右クリックメニューまたはケバブメニューでは常に両方の選択肢が提示され、対象となるセッションではビューアーのヘッダーに Open in terminal が表示されます。

対象可否はセッションおよびホストごとに決まります。Gateway ローカルのセッションでは、プロバイダー所有の再開コマンドが Gateway ホスト上で開始されます。ペアリングされた Node のセッションでは、所有元 Node 上で許可リストに登録されたプロバイダーコマンドを開始し、その PTY の出力、入力、サイズ変更イベントのみを中継します。これは汎用的な Node シェルを公開するものではなく、ブラウザーから提供されたコマンドも受け付けません。双方向ストリーミングのない組み込みワーカーブリッジを含め、一致するターミナル再開コマンドを通知しない Node では、ビューアーは引き続き利用でき、ターミナルを開けないことが表示されます。

セッションは切断後も存続します。ページの再読み込み、ラップトップのスリープ、または一時的なネットワーク障害が発生しても、セッションは終了せず Gateway 上でデタッチされ、再接続時には同じブラウザタブが再アタッチされ、直近の出力が再生されます。デタッチされたセッションは gateway.terminal.detachedSessionTimeoutSeconds 後に終了されます（デフォルトは 300 秒。0 を使用すると切断時に終了する動作に戻ります）。terminal.list はアタッチ可能なセッションを表示し、terminal.attach はセッションを引き継ぎ（tmux 形式のテイクオーバー）、terminal.text はアタッチせずにセッションの直近の出力をプレーンテキストとして読み取ります。これはエージェント／ツール向けの機能です。

ターミナルは、/?view=terminal にあるターミナル専用の全画面ドキュメントとしても利用できます。iOS および Android アプリは、保存済みの Gateway 認証情報を再利用して、このページをターミナル画面に埋め込みます。利用可否は同じ gateway.terminal.enabled および operator.admin ゲートに従い、接続先の Gateway がターミナルを提供していない場合はページに通知が表示されます。

ブラウザーパネル

Control UI には、Gateway が制御するブラウザー（エージェントがブラウザーツールを通じて操作するものと同じ）を通常の任意のウェブブラウザー内に表示する、ドッキング可能なブラウザーパネルが付属しています。ネイティブ WebView は不要です。接続先の Gateway が operator.admin 接続に browser.request を通知すると表示され、セッションワークスペースレールの地球儀ボタンで表示を切り替えられます。パネルには、タブ、編集可能な URL バー、戻る／進む／再読み込み、使用中のブラウザーで開く機能を備えたライブページスナップショットが表示されます。右側または下部にドッキングでき、クリック、ホイールスクロール、基本的な文字入力をリモートページに転送します。

2 つのキャプチャーモードで、ページのコンテキストをエージェント向けにまとめられます。

• Annotate (pencil)：ページ上にフリーハンドでマークアップを描画します。Send to chat を実行すると、ストロークがスクリーンショットに合成され、画像がアクティブなチャット作成欄に添付されます。また、ページの URL、タイトル、マークされた各領域を説明するプロンプトが事前入力されるため、エージェントは囲まれた場所を正確に把握できます。
• Inspect (pointer)：カーソルの下にある要素（セレクター、アクセシブル名、ロール、サイズ）を確認するには、要素にマウスカーソルを合わせます。クリックすると、その要素の詳細とハイライトされたスクリーンショットが、同じ作成欄のフローを通じて送信されます。Inspect、ホイールスクロール、戻る／進むには browser.evaluateEnabled が必要です（デフォルトで有効）。

macOS アプリでは、ダッシュボードでクリックしたリンク向けにネイティブのリンクブラウザーサイドバーが維持されます。ブラウザーパネルもそこで動作し、その他すべてのプラットフォームでページに注釈を付けるための手段となります。

チャットの動作

接続の切断と再接続

セッションの確立後に Gateway 接続が切断されても、ログアウトされません。クライアントがバックオフ（800 ms から最大 15 s）を使用して自動的に再試行している間、ダッシュボードは表示されたままで、上部バーの下に琥珀色の「Gateway connection lost — Reconnecting…」というフローティングピルが表示されます。接続が回復するまで、ライブ更新とリアルタイム／セッション操作は一時停止します。ピル内の Retry now をクリックすると、直ちに再試行されます。チャットは引き続き編集できます。通常のテキストおよび添付ファイルの送信は、現在のタブにある Gateway／セッションスコープのブラウザーストレージに保持され、再接続待ちとして表示され、Gateway が復旧すると自動的に送信されます。オフライン中は、ライブコントロールとスラッシュコマンドを使用できません。

このブラウザーにすでに認証情報（設定済みのトークン／パスワードまたは承認済みのデバイストークン）が保存されている場合、初回表示時と再読み込み時には、ログインゲートを一瞬表示する代わりに、接続が確立されるまで小さなアニメーション付き OpenClaw マークが表示されます。ログインゲートは、認証情報がまだ保存されていない場合、または Gateway が認証情報を明示的に拒否した場合（不正なトークン／パスワード、取り消されたペアリング）にのみ表示されます。これらは待機ではなく入力が必要な状態です。

PWA のインストールと Web Push

Control UI には manifest.webmanifest とサービスワーカーが付属しているため、最新のブラウザーではスタンドアロン PWA としてインストールできます。Web Push を使用すると、タブやブラウザーウィンドウが開いていない場合でも、Gateway が通知によってインストール済みの PWA を起動できます。

OpenClaw の更新直後にページに Protocol mismatch と表示された場合は、まず openclaw dashboard でダッシュボードを開き直し、ハードリフレッシュしてください。それでも失敗する場合は、ダッシュボードのオリジンのサイトデータを消去するか、プライベートブラウザーウィンドウでテストしてください。古いタブまたはブラウザーのサービスワーカーキャッシュにより、更新前の Control UI バンドルが新しい Gateway に対して動作し続けることがあります。

キーを固定する場合（マルチホストデプロイ、シークレットのローテーション、テストなど）は、Gateway プロセスの環境変数を使用して VAPID キーペアを上書きします。

• OPENCLAW_VAPID_PUBLIC_KEY
• OPENCLAW_VAPID_PRIVATE_KEY
• OPENCLAW_VAPID_SUBJECT（デフォルトは https://openclaw.ai）

Control UI は、次のスコープ制限付き Gateway メソッドを使用して、ブラウザーのサブスクリプションを登録およびテストします。

• push.web.vapidPublicKey は、アクティブな VAPID 公開鍵を取得します。
• push.web.subscribe は、endpoint と keys.p256dh／keys.auth を登録します。
• push.web.unsubscribe は、登録済みのエンドポイントを削除します。
• push.web.test は、呼び出し元のサブスクリプションにテスト通知を送信します。

ホストされた埋め込み

アシスタントメッセージでは、[embed ...] ショートコードを使用して、ホストされた Web コンテンツをインライン表示できます。iframe のサンドボックスポリシーは gateway.controlUi.embedSandbox で制御されます。

同梱の Canvas Plugin は、ツール呼び出しから自己完結型の SVG または HTML を直接レンダリングする show_widget も提供します。ブラウザーは inline-widgets Gateway 機能を通知し、生成された Canvas ドキュメントはチャット履歴の再読み込み後も利用できます。チャネルから開始された実行では、このツールを利用できません。

{  gateway: {    controlUi: {      embedSandbox: "scripts",    },  },}

絶対 URL の外部 http(s) 埋め込みは、デフォルトで引き続きブロックされます。[embed url="https://..."] にサードパーティページの読み込みを許可するには、gateway.controlUi.allowExternalEmbedUrls: true を設定します。

チャットメッセージの幅

チャットのトランスクリプトには、コンポーザーと位置を揃えた、中央配置の読みやすいフレームが使用されます。そのフレーム内では、アシスタントおよびツールの出力は左揃えのまま、ユーザーの吹き出しは右揃えになります。ワイドモニター環境では、gateway.controlUi.chatMessageMaxWidth を設定することで、同梱の CSS にパッチを適用せずにトランスクリプトの幅を上書きできます。

{  gateway: {    controlUi: {      chatMessageMaxWidth: "min(1280px, 82%)",    },  },}

値はブラウザーに渡される前に検証されます。サポートされる形式には、960px や 82% のような単純な長さとパーセンテージ、および制約付きの min(...)、max(...)、clamp(...)、calc(...)、fit-content(...) の幅式が含まれます。

Tailnet アクセス（推奨）

openclaw gateway --tailscale serve

openclaw gateway --bind tailnet --token "$(openssl rand -hex 32)"

セキュアでない HTTP

プレーン HTTP（http://<lan-ip> または http://<tailscale-ip>）経由でダッシュボードを開くと、ブラウザーは セキュアでないコンテキスト で動作し、WebCrypto をブロックします。デフォルトでは、OpenClaw はデバイス ID のない Control UI 接続を ブロック します。

文書化されている例外:

• gateway.controlUi.allowInsecureAuth=true を使用した localhost 限定のセキュアでない HTTP 互換性
• gateway.auth.mode: "trusted-proxy" を介した Control UI オペレーター認証の成功
• 緊急用の gateway.controlUi.dangerouslyDisableDeviceAuth=true

推奨される修正: HTTPS（Tailscale Serve）を使用するか、https://<magicdns>/（Serve）または http://127.0.0.1:18789/（Gateway ホスト上）で UI をローカルに開きます。

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

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

HTTPS のセットアップについては、Tailscaleを参照してください。

コンテンツセキュリティポリシー

Control UI には厳格な img-src ポリシーが組み込まれており、許可されるのは同一オリジンのアセット、data: URL、ローカルで生成された blob: URL のみです。リモートの http(s) およびプロトコル相対の画像 URL はブラウザーによって拒否され、ネットワークフェッチも発生しません。

実際の動作は次のとおりです。

• 相対パス（例: /avatars/<id>）で配信されるアバターと画像は引き続き表示されます。これには、UI が取得してローカルの blob: URL に変換する認証済みアバタールートも含まれます。
• インラインの data:image/... URL は引き続き表示されます。
• Control UI によって作成されたローカルの blob: URL は引き続き表示されます。
• GitHub リンクプレビューのアバターは、Gateway が GitHub の固定アバターホストから取得し、制限された data: URL として返します。operator のブラウザーがリモートのアバターホストに接続することはありません。
• チャンネルメタデータが出力したリモートアバター URL は Control UI のアバターヘルパーで除去され、組み込みのロゴ／バッジに置き換えられます。そのため、侵害された、または悪意のあるチャンネルが operator のブラウザーに任意のリモート画像を強制的に取得させることはできません。

これは常に有効で、設定による変更はできません。

アバタールートの認証

Gateway 認証が設定されている場合、Control UI のアバターエンドポイントには、API の他の部分と同じ Gateway トークンが必要です。

• GET /avatar/<agentId> は、認証済みの呼び出し元にのみアバター画像を返します。GET /avatar/<agentId>?meta=1 も同じ規則に従ってアバターのメタデータを返します。
• どちらのルートに対する未認証リクエストも拒否されるため（同階層のアシスタントメディアルートと同様）、他の部分が保護されているホストでアバタールートからエージェントの ID が漏洩することはありません。
• Control UI はアバターの取得時に Gateway トークンを bearer ヘッダーとして転送し、認証済みの blob URL を使用するため、ダッシュボードでも画像が引き続き表示されます。

Gateway 認証を無効にすると（共有ホストでは非推奨）、Gateway の他の部分と同様に、アバタールートも未認証になります。

アシスタントメディアルートの認証

Gateway 認証が設定されている場合、アシスタントのローカルメディアプレビューは 2 段階のルートを使用します。

• GET /__openclaw__/assistant-media?meta=1&source=<path> には通常の Control UI operator 認証が必要です。ブラウザーは利用可能かどうかを確認するときに、Gateway トークンを bearer ヘッダーとして送信します。
• 成功したメタデータレスポンスには、その正確なソースパスにスコープされた有効期間の短い mediaTicket が含まれます。
• ブラウザーで表示される画像、音声、動画、ドキュメントの URL では、アクティブな Gateway トークンやパスワードの代わりに mediaTicket=<ticket> を使用します。このチケットは短時間で期限切れになり、別のソースを認可することはできません。

これにより、再利用可能な Gateway 認証情報を表示可能なメディア URL に含めることなく、ブラウザー標準のメディア要素との互換性を維持できます。

承認リンク

operator への承認通知では、予約済みの ${controlUiBasePath}/approve/{approvalId} 名前空間で配信されるスタンドアロンの承認ドキュメントへディープリンクできます（例: /approve/<approvalId>。ベースパスが設定されている場合は /openclaw/approve/<approvalId>）。この URL は承認の有効期間中は変わらず、自分のデバイス間で安全に転送できます。この URL は承認を識別するだけで、認可することはありません。

• 1 セグメントの /approve/<approvalId> 名前空間は、すべての HTTP メソッドについて、Plugin の HTTP ルートより前に Gateway によって予約されます。そのため、Plugin のルートが承認ドキュメントを隠したり傍受したりすることはありません。
• 承認ドキュメントを開くには、Control UI の他の部分と同じ Gateway 認証（トークン／パスワード、Tailscale Serve の ID、または信頼済みプロキシの ID）が必要です。認証情報が承認 URL に含まれることはありません。
• Control UI の配信が無効な場合、この名前空間へのリクエストは Plugin ハンドラーにフォールスルーせず、404 を返します。
• 承認ドキュメントでのサインインは、そのページでのみ一時的に有効です。同じブラウザーで完全版 Control UI が保存した Gateway の選択内容や設定は上書きされません。

Gateway は dist/control-ui から静的ファイルを配信します。

pnpm ui:build

オプションの絶対ベース（固定アセット URL）:

OPENCLAW_CONTROL_UI_BASE_PATH=/openclaw/ pnpm ui:build

ローカル開発（別の開発サーバー）:

pnpm ui:dev

次に、UI の接続先を Gateway の WS URL（例: ws://127.0.0.1:18789）に設定します。

Control UI の空白ページ

ブラウザーに空白のダッシュボードが表示され、DevTools に有用なエラーがない場合、拡張機能または早期に実行されるコンテンツスクリプトによって、JavaScript モジュールアプリの評価が妨げられた可能性があります。静的ページにはプレーン HTML の復旧パネルが含まれており、起動後に <openclaw-app> が登録されていない場合に表示されます。

ブラウザー環境を変更した後、パネルの Try again アクションを使用するか、次の項目を確認した後に手動で再読み込みしてください。

• すべてのページに挿入される拡張機能、特に <all_urls> コンテンツスクリプトを含む拡張機能を無効にします。
• プライベートウィンドウ、クリーンなブラウザープロファイル、または別のブラウザーを試します。
• Gateway を実行したままにし、ブラウザーを変更した後も同じダッシュボード URL を確認します。

デバッグ／テスト: 開発サーバー + リモート Gateway

Control UI は静的ファイルです。WebSocket の接続先は設定可能であり、HTTP オリジンとは異なる接続先にできます。Vite 開発サーバーをローカルで実行し、Gateway を別の場所で実行する場合に便利です。

pnpm ui:dev

http://localhost:5173/?gatewayUrl=ws%3A%2F%2F<gateway-host>%3A18789

http://localhost:5173/?gatewayUrl=wss%3A%2F%2F<gateway-host>%3A18789#token=<gateway-token>

{  gateway: {    controlUi: {      allowedOrigins: ["http://localhost:5173"],    },  },}

リモートアクセスのセットアップ詳細: リモートアクセス。

関連項目

• ダッシュボード — Gateway ダッシュボード
• ヘルスチェック — Gateway の正常性監視
• TUI — ターミナルユーザーインターフェース
• WebChat — ブラウザーベースのチャットインターフェース