​

TUI (ターミナルUI)

​

クイックスタート

1. Gatewayを起動します。

openclaw gateway

2. TUIを開きます。

openclaw tui

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

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

​

表示されるもの

• ヘッダー: 接続URL、現在のagent、現在のsession。
• チャットログ: ユーザーメッセージ、assistant返信、システム通知、toolカード。
• ステータス行: 接続 / 実行状態（connecting、running、streaming、idle、error）。
• フッター: 接続状態 + agent + session + model + think/fast/verbose/reasoning + token数 + deliver。
• 入力欄: オートコンプリート付きテキストエディター。

​

メンタルモデル: agents + sessions

• Agentsは一意なslugです（例: main、research）。Gatewayがその一覧を公開します。
• Sessionsは現在のagentに属します。
• Session keyはagent:<agentId>:<sessionKey>として保存されます。
  • /session mainと入力すると、TUIはそれをagent:<currentAgent>:mainに展開します。
  • /session agent:other:mainと入力すると、そのagent sessionに明示的に切り替わります。
• Session scope:
  • per-sender（デフォルト）: 各agentは複数のsessionを持ちます。
  • global: TUIは常にglobal sessionを使用します（pickerは空の場合があります）。
• 現在のagent + sessionは常にフッターに表示されます。

​

送信 + 配信

• メッセージはGatewayへ送信されます。プロバイダーへの配信はデフォルトでオフです。
• 配信をオンにする:
  • /deliver on
  • またはSettingsパネル
  • またはopenclaw tui --deliverで開始

​

Pickers + overlays

• Model picker: 利用可能なmodelを一覧表示し、session overrideを設定します。
• Agent picker: 別のagentを選択します。
• Session picker: 現在のagentのsessionだけを表示します。
• Settings: deliver、tool出力の展開、thinking表示を切り替えます。

​

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

• Enter: メッセージ送信
• Esc: アクティブな実行を中断
• Ctrl+C: 入力をクリア（2回押すと終了）
• Ctrl+D: 終了
• Ctrl+L: model picker
• Ctrl+G: agent picker
• Ctrl+P: session picker
• Ctrl+O: tool出力の展開を切り替え
• Ctrl+T: thinking表示を切り替え（履歴を再読み込み）

​

スラッシュコマンド

• /help
• /status
• /agent <id>（または/agents）
• /session <key>（または/sessions）
• /model <provider/model>（または/models）

• /think <off|minimal|low|medium|high>
• /fast <status|on|off>
• /verbose <on|full|off>
• /reasoning <on|off|stream>
• /usage <off|tokens|full>
• /elevated <on|off|ask|full>（エイリアス: /elev）
• /activation <mention|always>
• /deliver <on|off>

• /newまたは/reset（sessionをリセット）
• /abort（アクティブな実行を中断）
• /settings
• /exit

​

local shellコマンド

• 行頭に!を付けると、TUIホスト上でlocal shellコマンドを実行します。
• TUIはsessionごとに一度だけlocal実行の許可を求めます。拒否すると、そのsessionでは!が無効のままになります。
• コマンドは、TUIの作業ディレクトリで新しい非対話型shell内で実行されます（cd / envは永続化されません）。
• local shellコマンドは、環境変数としてOPENCLAW_SHELL=tui-localを受け取ります。
• 単独の!は通常のメッセージとして送信されます。先頭の空白ではlocal execはトリガーされません。

​

tool出力

• Tool呼び出しは、args + results付きカードとして表示されます。
• Ctrl+Oで折りたたみ / 展開表示を切り替えます。
• tool実行中は、部分更新が同じカードにストリームされます。

​

ターミナルの色

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

​

履歴 + ストリーミング

• 接続時に、TUIは最新の履歴を読み込みます（デフォルト200メッセージ）。
• ストリーミング返信は、確定されるまでその場で更新されます。
• TUIは、よりリッチなtoolカードのためにagent toolイベントもリッスンします。

​

接続の詳細

• TUIはmode: "tui"としてGatewayに登録されます。
• 再接続時はシステムメッセージが表示され、イベントの欠落はログに表面化されます。

​

オプション

• --url <url>: Gateway WebSocket URL（デフォルトはconfigまたはws://127.0.0.1:<port>）
• --token <token>: Gateway token（必要な場合）
• --password <password>: Gateway password（必要な場合）
• --session <key>: Session key（デフォルト: main、scopeがglobalの場合はglobal）
• --deliver: assistant返信をプロバイダーへ配信（デフォルトはオフ）
• --thinking <level>: 送信時のthinking levelを上書き
• --message <text>: 接続後に初期メッセージを送信
• --timeout-ms <ms>: ms単位のagent timeout（デフォルトはagents.defaults.timeoutSeconds）
• --history-limit <n>: 読み込む履歴エントリー数（デフォルト200）

​

トラブルシューティング

• TUIで/statusを実行し、Gatewayが接続済みでidleまたはbusyであることを確認してください。
• Gatewayログを確認してください: openclaw logs --follow。
• agentが実行可能であることを確認してください: openclaw statusとopenclaw models status。
• チャットチャネルにメッセージが出る想定なら、配信を有効にしてください（/deliver onまたは--deliver）。

​

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

• disconnected: Gatewayが動作中であり、--url/--token/--passwordが正しいことを確認してください。
• pickerにagentがない: openclaw agents listとルーティング設定を確認してください。
• session pickerが空: global scopeにいるか、まだsessionがない可能性があります。

​

関連

• Control UI — Webベースのコントロールインターフェース
• CLI Reference — 完全なCLIコマンドリファレンス