CLI commands

TUI

openclaw tui

Gateway に接続されたターミナル UI を開くか、ローカル埋め込み モードで実行します。

関連:

  • TUI ガイド: TUI

オプション

フラグ デフォルト 説明
--local false Gateway ではなく、ローカル埋め込みエージェントランタイムに対して実行します。
--url <url> config の gateway.remote.url Gateway WebSocket URL。
--token <token> (なし) 必要な場合の Gateway トークン。
--password <pass> (なし) 必要な場合の Gateway パスワード。
--session <key> main (スコープがグローバルの場合は global) セッションキー。エージェントワークスペース内では、接頭辞がない限りそのエージェントを自動選択します。
--deliver false 設定済みチャンネル経由でアシスタントの返信を配信します。
--thinking <level> (モデルのデフォルト) Thinking レベルの上書き。
--message <text> (なし) 接続後に初期メッセージを送信します。
--timeout-ms <ms> agents.defaults.timeoutSeconds エージェントのタイムアウト。無効な値は警告をログに記録して無視されます。
--history-limit <n> 200 アタッチ時に読み込む履歴エントリ数。

エイリアス: openclaw chatopenclaw terminal は、--local が暗黙指定された同じコマンドを呼び出します。

注記:

  • chatterminalopenclaw tui --local のエイリアスです。
  • --local--url--token、または --password と組み合わせることはできません。
  • tui は、可能な場合、トークン/パスワード認証用に設定された Gateway 認証 SecretRefs を解決します (env/file/exec プロバイダー)。
  • 設定済みエージェントワークスペースディレクトリ内から起動された場合、TUI はセッションキーのデフォルトとしてそのエージェントを自動選択します (--session が明示的に agent:<id>:... でない限り)。
  • 非ローカルの URL ベース接続でフッターに Gateway ホスト名を表示するには、openclaw config set tui.footer.showRemoteHost true を実行します。ホストラベルはデフォルトでオフであり、ループバック接続や埋め込みローカル接続では表示されません。
  • ローカルモードは埋め込みエージェントランタイムを直接使用します。ほとんどのローカルツールは動作しますが、Gateway 専用機能は利用できません。
  • ローカルモードでは、TUI コマンドサーフェス内に /auth [provider] が追加されます。
  • Plugin 承認ゲートはローカルモードでも適用されます。承認が必要なツールはターミナルで判断を求めます。Gateway が関与しないからといって、何かが黙って自動承認されることはありません。
  • セッションのゴールはフッターに表示され、/goal で管理できます。

bash
openclaw chatopenclaw tui --localopenclaw tuiopenclaw tui --url ws://127.0.0.1:18789 --token <token>openclaw tui --session main --deliveropenclaw chat --message "Compare my config to the docs and tell me what to fix"# when run inside an agent workspace, infers that agent automaticallyopenclaw tui --session bugfix

設定修復ループ

現在の設定がすでに検証に通っており、埋め込みエージェントにそれを 調べさせ、ドキュメントと比較し、同じターミナルから修復を支援させたい場合は、 ローカルモードを使用します。

openclaw config validate がすでに失敗している場合は、先に openclaw configure または openclaw doctor --fix を使用します。openclaw chat は無効な 設定ガードを迂回しません。

bash
openclaw chat

その後、TUI 内で次を実行します。

text
!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctor

openclaw config set または openclaw configure で対象を絞って修正を適用し、その後 openclaw config validate を再実行します。TUIConfig を参照してください。

関連

Was this useful?
On this page

On this page