Skip to main content

​
openclaw tui

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

​
オプション

エイリアス: openclaw chat と openclaw terminal は、--local を指定したものとしてこのコマンドを呼び出します。

​
注記

  • --local は --url、--token、--password、--tls-fingerprint のいずれとも併用できません。
  • tui は、可能な場合、トークン／パスワード認証用に設定された Gateway 認証 SecretRef を解決します （env/file/exec プロバイダー）。
  • 明示的な URL またはポートがない場合、tui は実行中の Gateway によって記録された、アクティブなローカル Gateway ポートに従います。 明示的な --url、OPENCLAW_GATEWAY_URL、OPENCLAW_GATEWAY_PORT、およびリモート Gateway の設定が優先されます。
  • 設定済みのエージェントワークスペースディレクトリ内から起動すると、TUI はセッションキーのデフォルトとしてそのエージェントを自動選択します （--session が明示的に agent:<id>:... である場合を除きます）。
  • ローカルモードでは、埋め込みエージェントランタイムを直接使用します。ほとんどのローカルツールは動作しますが、 Gateway 専用機能は利用できません。
  • ローカルモードでは、TUI のコマンド機能に /auth [provider] が追加されます。
  • ローカルモードでも Plugin の承認ゲートは適用されます。承認が必要なツールは ターミナルで判断を求め、自動的に承認されることはありません。
  • セッションの目標はフッターに表示され、/goal で管理できます。

​
例

​
設定修復ループ

ローカルモードを使用すると、埋め込みエージェントが現在の設定を検査し、ドキュメントと比較して、同じターミナルから修復を支援できます。 openclaw config validate がすでに失敗している場合は、先に openclaw configure または openclaw doctor --fix を実行してください。openclaw chat は 無効な設定に対するガードを回避しません。
次に、TUI 内で以下を実行します。
openclaw config set または openclaw configure で対象を絞った修正を適用し、 openclaw config validate を再実行します。TUI と 設定を参照してください。

​
関連項目