トゥイ

​

クイックスタート

1. ゲートウェイを起動します。

openclaw gateway

2. TUI を開きます。

openclaw tui

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

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

​

あなたが見ているもの

• ヘッダー: 接続 URL、現在のエージェント、現在のセッション。
• チャット ログ: ユーザー メッセージ、アシスタントの応答、システム通知、ツール カード。
• ステータス行: 接続/実行状態 (接続、実行、ストリーミング、アイドル、エラー)。
• フッター: 接続状態 + エージェント + セッション + モデル + 思考/詳細/推論 + トークン数 + 配信。
• 入力: オートコンプリート付きのテキスト エディター。

​

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

• エージェントは固有のスラッグです (例: main、research)。ゲートウェイはリストを公開します。
• セッションは現在のエージェントに属します。
• セッションキーは agent:<agentId>:<sessionKey> として保存されます。
  • /session main と入力すると、TUI はそれを agent:<currentAgent>:main に展開します。
  • /session agent:other:main と入力すると、そのエージェント セッションに明示的に切り替わります。
• セッションの範囲:
  • per-sender (デフォルト): 各エージェントには多数のセッションがあります。
  • global: TUI は常に global セッションを使用します (ピッカーが空の場合があります)。
• 現在のエージェントとセッションは常にフッターに表示されます。

​

発送+配達- メッセージはゲートウェイに送信されます。プロバイダーへの配信はデフォルトではオフになっています

• 配信をオンにします:
  • /deliver on
  • または設定パネル
  • または openclaw tui --deliver で始める

​

ピッカー + オーバーレイ

• モデル ピッカー: 利用可能なモデルをリストし、セッション オーバーライドを設定します。
• エージェント ピッカー: 別のエージェントを選択します。
• セッション ピッカー: 現在のエージェントのセッションのみを表示します。
• 設定: 配信、ツール出力拡張、および思考の可視性の切り替え。

​

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

• Enter: メッセージを送信
• Esc: アクティブな実行を中止します
• Ctrl+C: 入力をクリアします (終了するには 2 回押します)
• Ctrl+D: 終了
• Ctrl+L: モデルピッカー
• Ctrl+G: エージェントピッカー
• Ctrl+P: セッションピッカー
• Ctrl+O: ツール出力拡張の切り替え
• Ctrl+T: 思考の表示を切り替えます (履歴をリロードします)

​

スラッシュコマンド

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

• /think <off|minimal|low|medium|high>
• /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他のゲートウェイ スラッシュ コマンド (/context など) はゲートウェイに転送され、システム出力として表示されます。 スラッシュ コマンド を参照してください。

​

ローカルシェルコマンド

• TUI ホスト上でローカル シェル コマンドを実行するには、行の先頭に ! を付けます。
• TUI は、セッションごとに 1 回、ローカルでの実行を許可するようプロンプトを表示します。減少すると、! はセッションに対して無効のままになります。
• コマンドは、TUI 作業ディレクトリ内の新しい非対話型シェルで実行されます (永続的な cd/env はありません)。
• ローカル シェル コマンドは、環境内で OPENCLAW_SHELL=tui-local を受け取ります。
• 単独の ! が通常のメッセージとして送信されます。先頭のスペースはローカル実行をトリガーしません。

​

ツールの出力

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

​

端子の色

• TUI はアシスタントの本文テキストを端末のデフォルトの前景に保持するため、暗い端末と明るい端末の両方が読みやすくなります。
• 端末が明るい背景を使用しており、自動検出が正しくない場合は、openclaw tui を起動する前に OPENCLAW_THEME=light を設定してください。
• 代わりに元の暗いパレットを強制するには、OPENCLAW_THEME=dark を設定します。

​

履歴 + ストリーミング- 接続時に、TUI は最新の履歴 (デフォルトでは 200 メッセージ) をロードします

• ストリーミング応答は、確定するまでその場で更新されます。
• TUI は、より豊富なツール カードのエージェント ツール イベントもリッスンします。

​

接続の詳細

• TUI はゲートウェイに mode: "tui" として登録されます。
• 再接続するとシステム メッセージが表示されます。イベントのギャップがログに現れます。

​

オプション

• --url <url>: ゲートウェイ WebSocket URL (デフォルトは config または ws://127.0.0.1:<port>)
• --token <token>: ゲートウェイ トークン (必要な場合)
• --password <password>: ゲートウェイのパスワード (必要な場合)
• --session <key>: セッションキー (デフォルト: main、またはスコープがグローバルの場合は global)
• --deliver: アシスタントの応答をプロバイダーに配信します (デフォルトはオフ)
• --thinking <level>: 送信の思考レベルを上書きする
• --timeout-ms <ms>: エージェントのタイムアウト (ミリ秒単位) (デフォルトは agents.defaults.timeoutSeconds)

​

トラブルシューティング

• ゲートウェイ ログを確認します: openclaw logs --follow。
• エージェントが実行できることを確認します: openclaw status および openclaw models status。
• チャット チャネルでメッセージが期待される場合は、配信を有効にします (/deliver on または --deliver)。
• --history-limit <n>: ロードする履歴エントリ (デフォルトは 200)

​

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

• disconnected: ゲートウェイが実行中であり、--url/--token/--password が正しいことを確認してください。
• ピッカーにエージェントがありません: openclaw agents list とルーティング設定を確認してください。
• 空のセッション ピッカー: グローバル スコープ内にいるか、まだセッションが存在しない可能性があります。