TUI

クイックスタート

Gateway モード

1. Gateway を起動します。

openclaw gateway

2. TUI を開きます。

openclaw tui

3. メッセージを入力して Enter キーを押します。

リモート Gateway：

openclaw tui --url ws://<host>:<port> --token <gateway-token>

Gateway がパスワード認証を使用している場合は、--password を使用します。

ローカルモード

Gateway なしで TUI を実行します：

openclaw chat# またはopenclaw tui --local

• openclaw chat と openclaw terminal は openclaw tui --local のエイリアスです。
• --local は、--url、--token、または --password と組み合わせることはできません。
• ローカルモードでは、組み込みのエージェントランタイムを直接使用します。ほとんどのローカルツールは動作しますが、Gateway 専用機能は利用できません。
• サブコマンドなしの openclaw は、対象を自動的に選択します。未設定のインストールでは推論のオンボーディングを実行し、無効な設定では従来の Doctor ガイダンスを開き、設定済みで到達可能な Gateway がある場合はこの TUI シェルを Gateway モードで開き、それ以外でローカルモデルが設定済みの場合はローカルモードで開きます。

表示内容

• ヘッダー：接続 URL、現在のエージェント、現在のセッション。
• チャットログ：ユーザーメッセージ、アシスタントの応答、システム通知、ツールカード。
• ステータス行：接続／実行状態（接続中、実行中、ストリーミング中、アイドル、エラー）。
• フッター：エージェント + セッション + モデル + ゴール状態 + think/fast/verbose/trace/reasoning + トークン数 + 配信。tui.footer.showRemoteHost が有効な場合、リモート Gateway 接続では接続先ホストも表示されます。
• 入力：自動補完付きテキストエディター。

メンタルモデル：エージェント + セッション

• エージェントは一意のスラッグです（例：main、research）。Gateway が一覧を公開します。

• セッションは現在のエージェントに属します。

• セッションキーは agent:<agentId>:<sessionKey> として保存されます。

  • /session main と入力すると、TUI はそれを agent:<currentAgent>:main に展開します。
  • /session agent:other:main と入力すると、そのエージェントセッションへ明示的に切り替わります。

• セッションスコープ：

  • per-sender（デフォルト）：各エージェントには複数のセッションがあります。
  • global：TUI は常に global セッションを使用します（ピッカーが空の場合があります）。

• 現在のエージェント + セッションは常にフッターに表示されます。

• local 以外の URL ベース接続で Gateway ホストを表示するには、次の設定でオプトインします：

  openclaw config set tui.footer.showRemoteHost true

  デフォルトは false です。ループバック接続および組み込みのローカル接続では、ホストラベルは表示されません。

• セッションに ゴール がある場合、フッターにはその簡潔な状態が表示されます： Pursuing goal、Goal paused (/goal resume)、Goal blocked (/goal resume)、または Goal achieved。

• --session なしで起動した場合、Gateway モードの TUI は、同じ Gateway、エージェント、セッションスコープで最後に選択したセッションがまだ存在していれば、そのセッションを再開します。--session、/session、/new、または /reset を渡した場合は、引き続き明示的な指定として扱われます。

送信 + 配信

• メッセージは常に Gateway（ローカルモードでは組み込みランタイム）に送られます。アシスタントの応答をチャットプロバイダーへ送り返す配信処理は別の手順であり、デフォルトでは無効です。
• TUI は WebChat と同様の内部ソースサーフェスであり、汎用の送信チャネルではありません。表示可能な応答に tools.message を必要とするハーネスは、送信先なしの message.send でアクティブな TUI ターンを満たせます。プロバイダーへの明示的な配信では、引き続き通常の設定済みチャネルを使用し、lastChannel へフォールバックすることはありません。
• 配信設定は起動時に TUI セッション全体に対して固定されます。有効にするには openclaw tui --deliver を指定して起動します。セッション中に切り替えるための /deliver スラッシュコマンドや Settings トグルはありません。変更するには TUI を再起動します。

ピッカー + オーバーレイ

• モデルピッカー：利用可能なモデルを一覧表示し、セッションのオーバーライドを設定します。
• エージェントピッカー：別のエージェントを選択します。
• セッションピッカー：過去 7 日以内に更新された現在のエージェントのセッションを最大 50 件表示します。既知の古いセッションへ移動するには /session <key> を使用します。
• Settings（/settings）：ツール出力の展開と思考表示を切り替えます。このパネルでは配信を制御できません。

キーボードショートカット

• Enter：メッセージを送信
• Esc：アクティブな実行を中止
• Ctrl+C：入力を消去（2 回押すと終了）
• Ctrl+D：終了
• Ctrl+L：モデルピッカー
• Ctrl+G：エージェントピッカー
• Ctrl+P：セッションピッカー
• Ctrl+O：ツール出力の展開を切り替え
• Ctrl+T：思考表示を切り替え（履歴を再読み込み）

スラッシュコマンド

コア：

• /help
• /status（Gateway に転送。セッション／モデルの概要を表示）
• /gateway-status（エイリアス：/gwstatus。Gateway の接続状態を直接表示）
• /agent <id>（または /agents）
• /session <key>（または /sessions）
• /model <provider/model>（または /models）

セッション制御：

• /think <off|minimal|low|medium|high>（モデルによっては、上位ティアで xhigh／max などのレベルが追加される場合があります）
• /fast <status|auto|on|off>
• /verbose <on|full|off>
• /trace <on|off>
• /reasoning <on|off|stream>
• /usage <off|tokens|full|reset>（reset／inherit／clear／default を指定するとセッションのオーバーライドを解除）
• /goal [status] | /goal start <objective> | /goal edit <objective> | /goal pause|resume|complete|block|clear
• /elevated <on|off|ask|full>（エイリアス：/elev）
• /activation <mention|always>

セッションのライフサイクル：

• /new（新しいキーで新規の分離されたセッションを生成。古いセッションを使用している他の TUI クライアントには影響しません）
• /reset（現在のセッションキーをその場でリセット）
• /abort（アクティブな実行を中止）
• /settings
• /exit（または /quit）

ローカルモードのみ：

• /auth [provider] は、TUI 内でプロバイダーの認証／ログインフローを開きます。

OpenClaw：

• /openclaw [request] は、通常のエージェント TUI から OpenClaw のセットアップ／修復チャットに戻り、必要に応じて 1 件のリクエストを転送します。

その他の Gateway スラッシュコマンド（例：/context）は Gateway に転送され、システム出力として表示されます。スラッシュコマンドを参照してください。

ローカルシェルコマンド

• 行の先頭に ! を付けると、TUI ホスト上でローカルシェルコマンドを実行できます。
• TUI はセッションごとに 1 回、ローカル実行を許可するか確認します。拒否すると、そのセッションでは ! が無効のままになります。
• コマンドは TUI の作業ディレクトリで、新しい非対話型シェル内で実行されます（cd／環境は保持されません）。
• ローカルシェルコマンドの環境には OPENCLAW_SHELL=tui-local が渡されます。
• ! だけの行は通常のメッセージとして送信されます。先頭に空白がある場合、ローカル実行はトリガーされません。

OpenClaw のセットアップおよび修復ヘルパー

OpenClaw はリングゼロのセットアップ／修復アシスタントです。設定済みのデフォルトモデルがライブ推論チェックに合格すると、openclaw setup として公開されます。推論を利用できない場合、対話型の呼び出しは推論のオンボーディングに戻り、自動処理は修復ガイダンスを伴って失敗します。openclaw tui --local と同じローカル TUI シェル内で実行され、OpenClaw の型付きかつ承認ゲート付きの操作に制限された AI エージェントを使用します：

openclaw setup                       # 対話形式で開始openclaw setup -m "status"           # 1 件のリクエストを実行して終了openclaw setup -m "set default model openai/gpt-5.2" --yes   # 設定の書き込みを適用

• 永続的な設定の書き込みには承認が必要です。対話形式で確認するか、--yes を渡します。
• --json はチャットを開始せず、起動時の概要を JSON として出力します。
• OpenClaw 内から open-tui をリクエストすると（たとえば通常のエージェントとの会話を依頼すると）、OpenClaw を終了して通常のエージェント TUI を開きます。戻るにはそこで /openclaw を使用します。

現在の設定がすでに検証に合格しており、組み込みエージェントに同じマシン上で設定を調査させ、ドキュメントと比較し、稼働中の Gateway に依存せずに設定のずれを修復したい場合は、ローカルモードを使用します。

openclaw config validate がすでに失敗している場合は、まず openclaw configure または openclaw doctor --fix から始めます。openclaw chat の起動にも、読み込み可能な設定が必要です。

一般的な手順：

1. ローカルモードを開始します：

openclaw chat

2. 確認してほしい内容をエージェントに依頼します。例：

Gateway の認証設定をドキュメントと比較し、最小限の修正を提案してください。

3. 正確な根拠の取得と検証には、ローカルシェルコマンドを使用します：

!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctor

4. openclaw config set または openclaw configure で限定的な変更を適用し、!openclaw config validate を再実行します。
5. Doctor が自動移行または修復を推奨した場合は、その内容を確認して !openclaw doctor --fix を実行します。

ヒント：

• openclaw.json を手動編集するより、openclaw config set または openclaw configure を優先してください。
• openclaw docs "<query>" は、同じマシンからライブドキュメントのインデックスを検索します。
• 構造化されたスキーマと SecretRef／解決可能性のエラーを確認したい場合は、openclaw config validate --json が役立ちます。

ツール出力

• ツール呼び出しは、引数 + 結果を含むカードとして表示されます。
• Ctrl+O で折りたたみ表示と展開表示を切り替えます。
• ツールの実行中、部分的な更新は同じカード内にストリーミングされます。

ターミナルの色

• TUI はアシスタント本文のテキストにターミナルのデフォルトの前景色を使用するため、暗い背景でも明るい背景でも読みやすさが保たれます。
• ターミナルの背景が明るく、自動検出が正しくない場合は、openclaw tui を起動する前に OPENCLAW_THEME=light を設定します。
• 代わりに元のダークパレットを強制するには、OPENCLAW_THEME=dark を設定します。

履歴 + ストリーミング

• 接続時に、TUI は最新の履歴を読み込みます（デフォルトは 200 件のメッセージ）。
• ストリーミング応答は、確定するまでその場で更新されます。
• TUI は、より詳細なツールカードを表示するため、エージェントのツールイベントもリッスンします。

接続の詳細

• TUI は、Gateway ポリシーで Control UI と WebChat が使用するものと同じ大分類の ui クライアントモードで、クライアント ID openclaw-tui を使用して接続します。
• 再接続時にはシステムメッセージが表示され、イベントの欠落はログに示されます。

オプション

• --local: ローカルの組み込みエージェントランタイムに対して実行
• --url <url>: Gateway WebSocket URL（デフォルトは設定のgateway.remote.url、またはloopbackのws://127.0.0.1:<port>）
• --token <token>: Gatewayトークン（必要な場合）
• --password <password>: Gatewayパスワード（必要な場合）
• --tls-fingerprint <sha256>: 証明書が固定されたwss:// Gatewayで想定されるTLS証明書フィンガープリント
• --session <key>: セッションキー（デフォルト: main。スコープがグローバルの場合はglobal）
• --deliver: アシスタントの応答をプロバイダーに配信（デフォルトはオフ）
• --thinking <level>: 送信時の思考レベルを上書き
• --message <text>: 接続後に最初のメッセージを送信
• --timeout-ms <ms>: エージェントのタイムアウト（ミリ秒、デフォルトはagents.defaults.timeoutSeconds）
• --history-limit <n>: 読み込む履歴エントリ数（デフォルトは200）

トラブルシューティング

メッセージ送信後に出力がない場合:

• TUIで/statusを実行し、Gatewayが接続済みでアイドル状態またはビジー状態であることを確認します。
• Gatewayのログを確認します: openclaw logs --follow。
• エージェントを実行できることを確認します: openclaw statusおよびopenclaw models status。
• チャットチャンネルへのメッセージを想定している場合は、TUIが--deliver付きで起動されたことを確認します（再起動せずに後から有効にすることはできません）。

接続のトラブルシューティング

• disconnected: Gatewayが実行中で、--url/--token/--passwordが正しいことを確認してください。
• 選択画面にエージェントが表示されない場合: openclaw agents listとルーティング設定を確認してください。
• セッション選択画面が空の場合: グローバルスコープになっているか、まだセッションが存在しない可能性があります。

関連項目

• コントロールUI — Webベースの制御インターフェース
• 設定 — openclaw.jsonの確認、検証、編集
• Doctor — ガイド付きの修復および移行チェック
• CLIリファレンス — CLIコマンドの完全なリファレンス