OpenClawダッシュボード操作ガイド：ブラウザから即座に管理

開発を進めていると、バックエンドで何が起きているのかを視覚的に把握したくなることがありますよね。設定の確認や実行の承認など、コマンドラインだけでは少し不便に感じる場面で、Gateway のダッシュボードは非常に強力な味方になります。

複雑な設定に悩まされることなく、ブラウザから直感的に操作できる環境を整えて、開発効率を一段上のレベルへ引き上げましょう。

ダッシュボード (Control UI)

Gateway のダッシュボードは、デフォルトでは / で提供されるブラウザベースの Control UI です（gateway.controlUi.basePath で上書き可能です）。

ローカルの Gateway をすぐに開くにはこちら：

• http://127.0.0.1:18789/ (または http://localhost:18789/)

主なリファレンス：

• 使い方と UI の機能については Control UI を参照してください。
• Serve/Funnel の自動化については Tailscale を参照してください。
• バインドモードとセキュリティに関する注意点は Web surfaces を参照してください。

認証は WebSocket のハンドシェイク時に connect.params.auth（トークンまたはパスワード）を介して行われます。Gateway configuration の gateway.auth を確認してください。

セキュリティ上の注意：Control UI は admin surface（チャット、設定、実行承認など）です。公共のネットワークに公開しないでください。UI は現在のブラウザタブセッションと選択された Gateway URL のダッシュボード URL トークンを sessionStorage に保持し、ロード後に URL からトークンを取り除きます。localhost、Tailscale Serve、または SSH tunnel の利用をおすすめします。

クイックスタート（推奨）

• オンボーディング後、CLI は自動的にダッシュボードを開き、クリーンな（トークンを含まない）リンクを表示します。
• いつでも再表示できます：openclaw dashboard（リンクをコピーし、可能であればブラウザを開きます。ヘッドレス環境の場合は SSH のヒントを表示します）。
• UI で認証を求められた場合は、gateway.auth.token（または OPENCLAW_GATEWAY_TOKEN）からトークンをコピーして Control UI の設定に貼り付けてください。

トークンの基本（ローカルとリモート）

• Localhost: http://127.0.0.1:18789/ を開きます。
• トークンの取得先: gateway.auth.token（または OPENCLAW_GATEWAY_TOKEN）。openclaw dashboard は初回セットアップのために URL フラグメント経由でトークンを渡すことができます。Control UI は、localStorage ではなく、現在のブラウザタブセッションと選択された Gateway URL のために sessionStorage にトークンを保持します。
• gateway.auth.token が SecretRef で管理されている場合、openclaw dashboard は意図的にトークンを含まない URL を表示・コピー・展開します。これにより、外部で管理されているトークンがシェルのログ、クリップボードの履歴、ブラウザの起動引数に露出するのを防ぎます。
• gateway.auth.token が SecretRef として設定されており、現在のシェルで解決できない場合でも、openclaw dashboard はトークンなしの URL と具体的な認証設定のガイダンスを表示します。
• Localhost 以外: Tailscale Serve（gateway.auth.allowTailscale: true の場合、信頼された Gateway ホストとみなされ、Control UI/WebSocket はトークンレスになります。ただし HTTP API には引き続きトークン/パスワードが必要です）、トークン付きの tailnet バインド、または SSH tunnel を使用してください。Web surfaces を参照してください。

“unauthorized” または 1008 エラーが表示される場合

• Gateway に到達可能であることを確認してください（ローカル：openclaw status、リモート：SSH tunnel ssh -N -L 18789:127.0.0.1:18789 user@host を実行してから http://127.0.0.1:18789/ を開く）。
• AUTH_TOKEN_MISMATCH の場合、Gateway がリトライのヒントを返すと、クライアントはキャッシュされたデバイス トークンを使用して 1 回だけ信頼されたリトライを試みることがあります。そのリトライ後も認証に失敗する場合は、手動でトークンのズレを解消してください。
• トークンのズレを修復する手順については、Token drift recovery checklist に従ってください。
• Gateway ホストからトークンを取得または提供してください：
  • プレーンテキスト設定の場合：openclaw config get gateway.auth.token
  • SecretRef 管理の設定の場合：外部シークレットプロバイダーを解決するか、このシェルで OPENCLAW_GATEWAY_TOKEN を export してから openclaw dashboard を再実行してください。
  • トークンが設定されていない場合：openclaw doctor --generate-gateway-token
• ダッシュボードの設定で、認証フィールドにトークンを貼り付けて接続してください。

次のステップ

• Control UI の詳細な使い方
• Gateway の詳細設定

セットアップでお困りの際は、AI Setup Assistant も活用してみてください。