English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Web interfaces

TUI

クイックスタート

Gatewayモード

  1. Gatewayを起動します。
openclaw gateway
  1. TUIを開きます。
openclaw tui
  1. メッセージを入力して Enter を押します。

リモートGateway:

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

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

ローカルモード

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

openclaw chat
# or
openclaw tui --local

注記:

  • openclaw chatとopenclaw terminalはopenclaw tui --localのエイリアスです。
  • --localは--url、--token、--passwordと組み合わせることはできません。
  • ローカルモードは埋め込みエージェントランタイムを直接使用します。ほとんどのローカルツールは動作しますが、Gateway専用機能は利用できません。
  • openclawとopenclaw crestodianもこのTUIシェルを使用し、Crestodianがローカルセットアップと修復チャットのバックエンドになります。

表示される内容

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

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

  • エージェントは一意のスラッグです（例: main、research）。Gatewayが一覧を公開します。
  • セッションは現在のエージェントに属します。
  • セッションキーはagent:<agentId>:<sessionKey>として保存されます。
    • /session mainと入力すると、TUIはそれをagent:<currentAgent>:mainに展開します。
    • /session agent:other:mainと入力すると、そのエージェントセッションに明示的に切り替わります。
  • セッションスコープ:
    • per-sender（デフォルト）: 各エージェントが複数のセッションを持ちます。
    • global: TUIは常にglobalセッションを使用します（ピッカーは空の場合があります）。
  • 現在のエージェント + セッションは常にフッターに表示されます。
  • --sessionなしで開始した場合、GatewayモードのTUIは、同じGateway、エージェント、セッションスコープについて最後に選択されたセッションがまだ存在するなら再開します。--session、/session、/new、/resetを渡す操作は引き続き明示的です。

送信 + 配信

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

ピッカー + オーバーレイ

  • モデルピッカー: 利用可能なモデルを一覧表示し、セッションの上書きを設定します。
  • エージェントピッカー: 別のエージェントを選択します。
  • セッションピッカー: 過去7日以内に更新された現在のエージェントのセッションを最大50件表示します。古い既知のセッションへ移動するには/session <key>を使用します。
  • 設定: 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>
  • /fast <status|on|off>
  • /verbose <on|full|off>
  • /trace <on|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

ローカルモードのみ:

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

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

ローカルシェルコマンド

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

ローカルTUIから設定を修復する

現在の設定がすでに検証に通っていて、埋め込みエージェントに同じマシン上でそれを検査させ、ドキュメントと比較させ、実行中のGatewayに依存せずにドリフトの修復を支援させたい場合は、ローカルモードを使用します。

openclaw config validateがすでに失敗している場合は、まずopenclaw configureまたはopenclaw doctor --fixから開始します。openclaw chatは無効な設定ガードを回避しません。

一般的なループ:

  1. ローカルモードを開始します。
openclaw chat
  1. 確認したい内容をエージェントに尋ねます。例:
Compare my gateway auth config with the docs and suggest the smallest fix.
  1. 正確な証拠と検証にはローカルシェルコマンドを使用します。
!openclaw config file
!openclaw docs gateway auth token secretref
!openclaw config validate
!openclaw doctor
  1. openclaw config setまたはopenclaw configureで限定的な変更を適用し、その後!openclaw config validateを再実行します。
  2. Doctorが自動移行または修復を推奨する場合は、それを確認して!openclaw doctor --fixを実行します。

ヒント:

  • openclaw.jsonを手動編集するよりも、openclaw config setまたはopenclaw configureを優先します。
  • openclaw docs "<query>"は同じマシンからライブドキュメントインデックスを検索します。
  • openclaw config validate --jsonは、構造化されたスキーマやSecretRef/解決可能性エラーが必要な場合に便利です。

ツール出力

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

ターミナルカラー

  • TUIは、暗いターミナルと明るいターミナルのどちらでも読みやすいように、アシスタント本文テキストをターミナルのデフォルト前景色のままにします。
  • ターミナルが明るい背景を使用していて自動検出が間違っている場合は、openclaw tuiを起動する前にOPENCLAW_THEME=lightを設定します。
  • 代わりに元のダークパレットを強制するには、OPENCLAW_THEME=darkを設定します。

履歴 + ストリーミング

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

接続の詳細

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

オプション

  • --local: ローカルの埋め込みエージェントランタイムに対して実行
  • --url <url>: Gateway WebSocket URL（デフォルトは設定またはws://127.0.0.1:<port>）
  • --token <token>: Gatewayトークン（必要な場合）
  • --password <password>: Gatewayパスワード（必要な場合）
  • --session <key>: セッションキー（デフォルト: main、またはスコープがglobalの場合はglobal）
  • --deliver: アシスタントの返信をプロバイダーに配信（デフォルトはオフ）
  • --thinking <level>: 送信時の思考レベルを上書き
  • --message <text>: 接続後に初期メッセージを送信
  • --timeout-ms <ms>: エージェントタイムアウト（ms単位、デフォルトはagents.defaults.timeoutSeconds）
  • --history-limit <n>: 読み込む履歴エントリ数（デフォルトは200）

トラブルシューティング

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

  • TUIで/statusを実行し、Gatewayが接続済みでアイドル/ビジーであることを確認します。
  • Gatewayログを確認します: openclaw logs --follow。
  • エージェントが実行できることを確認します: openclaw statusとopenclaw models status。
  • チャットチャネルでメッセージを想定している場合は、配信を有効にします（/deliver onまたは--deliver）。

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

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

関連

  • Control UI — Webベースの制御インターフェイス
  • Config — openclaw.jsonを検査、検証、編集する
  • Doctor — ガイド付きの修復と移行チェック
  • CLIリファレンス — CLIコマンドの完全なリファレンス