Webインターフェース

TUI

クイックスタート

  1. ゲートウェイを起動します。
openclaw gateway
  1. TUIを開きます。
openclaw tui
  1. メッセージを入力し、Enterキーを押します。

リモートゲートウェイの場合:

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

ゲートウェイがパスワード認証を使用している場合は、--passwordを使用してください。

表示内容

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

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

  • エージェントは一意のスラッグです (例: 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/環境変数は永続しません)。
  • ローカルシェルコマンドは、環境変数 OPENCLAW_SHELL=tui-local を受け取ります。
  • 単独の ! は通常のメッセージとして送信されます。先頭のスペースはローカル実行をトリガーしません。

ツール出力

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

履歴 + ストリーミング

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

接続の詳細

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

オプション

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

注意: --url を設定すると、TUIは設定や環境変数の認証情報にフォールバックしません。--token または --password を明示的に渡してください。明示的な認証情報がない場合はエラーになります。

トラブルシューティング

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

  • TUI内で /status を実行し、ゲートウェイが接続され、アイドル/ビジー状態であることを確認します。
  • ゲートウェイのログを確認します: openclaw logs --follow。
  • エージェントが実行可能であることを確認します: openclaw status および openclaw models status。
  • チャットチャネルにメッセージが表示されることを期待する場合は、配信を有効にしてください (/deliver on または --deliver)。
  • --history-limit <n>: 読み込む履歴エントリ数 (デフォルト200)

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

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

WebChat