OpenClaw TUIクイックスタート：ターミナルでAIを操作する

開発中、ブラウザとターミナルを何度も行き来して集中力が切れてしまった経験はありませんか？AIとの対話も、使い慣れたコマンドライン環境で完結できれば最高ですよね。そんな開発者の皆さんに最適なのが、この TUI (Terminal UI) です。

クイックスタート

まずは Gateway を起動します。

openclaw gateway

次に TUI を開きます。

openclaw tui

メッセージを入力して Enter を押すだけです。

リモートの Gateway に接続する場合は、以下のように指定します。

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

Gateway でパスワード認証を使用している場合は、--password を使用してください。

画面構成

Header: 接続 URL、現在の Agent、現在の Session が表示されます。
Chat log: ユーザーのメッセージ、Assistant の返答、システム通知、ツールカードが表示されます。
Status line: 接続や実行の状態（connecting, running, streaming, idle, error）を示します。
Footer: 接続状態、Agent、Session、Model、各種設定（think/fast/verbose/reasoning）、Token 数、deliver 設定が表示されます。
Input: オートコンプリート機能付きのテキストエディタです。

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

Agent は一意の識別子（例：main, research）を持ちます。Gateway がこのリストを管理しています。
Session は現在の Agent に紐づきます。
Session キーは agent:<agentId>:<sessionKey> という形式で保存されます。
- /session main と入力すると、TUI は内部的に agent:<currentAgent>:main として扱います。
- /session agent:other:main と入力すれば、明示的に別の Agent の Session に切り替えることができます。
Session のスコープ：
- per-sender（デフォルト）：各 Agent が複数の Session を持ちます。
- global：TUI は常に global セッションを使用します（ピッカーが空になる場合があります）。
現在の Agent と Session は、常にフッターで確認できます。

送信とデリバリー

メッセージは Gateway に送信されますが、プロバイダーへのデリバリー（配信）はデフォルトでオフになっています。
デリバリーをオンにするには、以下のいずれかを行ってください。
- /deliver on コマンドを実行
- Settings パネルで切り替え
- openclaw tui --deliver で起動

ピッカーとオーバーレイ

Model picker: 利用可能な Model を一覧表示し、Session のオーバーライドを設定します。
Agent picker: 別の Agent を選択します。
Session picker: 現在の Agent に紐づく Session のみを表示します。
Settings: deliver の切り替え、ツール出力の展開、thinking プロセスの表示設定などを行えます。

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

Enter: メッセージを送信
Esc: 実行中の処理を中断
Ctrl+C: 入力をクリア（2回押すと終了）
Ctrl+D: 終了
Ctrl+L: Model picker を開く
Ctrl+G: Agent picker を開く
Ctrl+P: Session picker を開く
Ctrl+O: ツール出力の展開/折りたたみを切り替え
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（セッションをリセット）
/abort（実行中の処理を中断）
/settings
/exit

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

ローカルシェルコマンド

行の先頭に ! を付けると、TUI を実行しているホスト上でローカルシェルコマンドを実行できます。
セッションごとに一度、ローカル実行を許可するか確認プロンプトが表示されます。拒否した場合、そのセッションでは ! は無効のままになります。
コマンドは、TUI の作業ディレクトリで、非対話型の新しいシェルとして実行されます（cd や環境変数は保持されません）。
ローカルシェルコマンドの環境変数には OPENCLAW_SHELL=tui-local がセットされます。
! 単体で入力した場合は通常のメッセージとして送信されます。また、先頭にスペースがある場合はローカル実行とはみなされません。

ツール出力

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

ターミナルの色設定

Assistant のテキストは、ターミナルのデフォルトの前景色を使用するため、ダークモードでもライトモードでも読みやすさが維持されます。
ライト背景のターミナルを使用していて自動判定が正しくない場合は、起動前に OPENCLAW_THEME=light を設定してください。
元のダークパレットを強制したい場合は、OPENCLAW_THEME=dark を設定します。

履歴とストリーミング

接続時、TUI は最新の履歴（デフォルト 200 メッセージ）を読み込みます。
ストリーミングレスポンスは、確定するまでその場で更新され続けます。
Agent のツールイベントもリッスンしており、リッチなツールカードを表示します。

接続の詳細

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

オプション

--url <url>: Gateway の WebSocket URL（デフォルトは設定ファイルまたは ws://127.0.0.1:<port>）
--token <token>: Gateway トークン（必要な場合）
--password <password>: Gateway パスワード（必要な場合）
--session <key>: Session キー（デフォルトは main、スコープが global の場合は global）
--deliver: Assistant の返答をプロバイダーに配信する（デフォルトはオフ）
--thinking <level>: 送信時の thinking レベルをオーバーライドする
--timeout-ms <ms>: Agent のタイムアウト設定（ミリ秒、デフォルトは agents.defaults.timeoutSeconds）

注意：--url を設定した場合、設定ファイルや環境変数の認証情報は使用されません。--token や --password を明示的に渡してください。必要な認証情報が不足している場合はエラーになります。

トラブルシューティング

メッセージ送信後に反応がない場合：

TUI 内で /status を実行し、Gateway が接続されているか、アイドル状態かビジー状態かを確認してください。
Gateway のログを確認してください：openclaw logs --follow
Agent が実行可能か確認してください：openclaw status および openclaw models status
チャットチャネルでの返答を期待している場合は、デリバリーを有効にしてください（/deliver on または --deliver）。
--history-limit <n>: 読み込む履歴の数を変更できます（デフォルト 200）。

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

disconnected: Gateway が起動しているか、--url/--token/--password が正しいか確認してください。
ピッカーに Agent が表示されない: openclaw agents list とルーティング設定を確認してください。
Session ピッカーが空: global スコープにいるか、まだ Session が作成されていない可能性があります。

まだ解決しませんか？

このページで解決しない場合は、OpenClaw Expertに直接質問してください。