コントロール UI

• デフォルト: http://<host>:18789/
• 任意のプレフィックス: gateway.controlUi.basePath を設定します（例: /openclaw）

​

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

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

​

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

openclaw devices list

openclaw devices approve <requestId>

​

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

​

個人 ID（ブラウザーローカル）

​

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

​

Gateway ホストステータス

​

言語サポート

• サポートされるロケール: 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
• 英語以外の翻訳はブラウザー内で遅延読み込みされます。
• 選択されたロケールはブラウザーストレージに保存され、今後の訪問で再利用されます。
• 欠落している翻訳キーは英語にフォールバックします。

​

外観テーマ

​

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

​

できること（現在）

​

MCP ページ

1. サイドバーから MCP を開きます。
2. 合計、有効、OAuth、フィルター済みサーバー数の概要カードを確認します。
3. 各サーバー行で、トランスポート、有効化、auth、フィルター、タイムアウト、コマンドヒントを確認します。
4. サーバーを設定済みのまま runtime discovery から外しておく必要がある場合は、有効化を切り替えます。
5. サーバー定義、ヘッダー、TLS/mTLS パス、OAuth メタデータ、ツールフィルター、Codex 投影メタデータ用に、スコープ付き mcp 設定セクションを編集します。
6. 設定を書き込むには Save を使用し、実行中の Gateway に変更済み設定を適用させる場合は Save & Publish を使用します。
7. 静的診断、ライブ証明、キャッシュ済み runtime の破棄には、ターミナルから openclaw mcp status --verbose、openclaw mcp doctor --probe、または openclaw mcp reload を実行します。

​

Activity タブ

​

オペレーターターミナル

​

チャットの動作

​

接続喪失と再接続

​

PWA インストールと Web Push

• OPENCLAW_VAPID_PUBLIC_KEY
• OPENCLAW_VAPID_PRIVATE_KEY
• OPENCLAW_VAPID_SUBJECT（既定値は https://openclaw.ai）

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

​

ホスト型埋め込み

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

​

チャットメッセージ幅

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

​

Tailnet アクセス（推奨）

openclaw gateway --tailscale serve

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

​

安全でない HTTP

• gateway.controlUi.allowInsecureAuth=true による localhost 限定の安全でない HTTP 互換性
• gateway.auth.mode: "trusted-proxy" による Control UI オペレーター認証の成功
• 緊急用の gateway.controlUi.dangerouslyDisableDeviceAuth=true

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

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

​

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

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

​

アバタールート認証

• GET /avatar/<agentId> は認証済み呼び出し元にのみアバター画像を返します。GET /avatar/<agentId>?meta=1 は同じルールの下でアバターメタデータを返します。
• どちらのルートへの未認証リクエストも拒否されます（兄弟の assistant-media ルートと一致）。そのため、他の部分が保護されているホストで、アバタールートがエージェント ID を漏らすことはありません。
• Control UI はアバター取得時に gateway トークンを bearer ヘッダーとして転送し、認証済み blob URL を使うため、画像はダッシュボードで引き続きレンダリングされます。

​

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

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

​

UI のビルド

pnpm ui:build

OPENCLAW_CONTROL_UI_BASE_PATH=/openclaw/ pnpm ui:build

pnpm ui:dev

​

空白の Control UI ページ

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

​

デバッグ/テスト: 開発サーバー + リモート 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 — ブラウザーベースのチャットインターフェイス