openclaw tui
Gateway に接続されたターミナル UI を開くか、ローカル組み込み
モードで実行します。
関連ガイド: TUI
オプション
| フラグ | デフォルト | 説明 |
|---|---|---|
--local | false | Gateway の代わりにローカル組み込みエージェントランタイムに対して実行します。 |
--url <url> | 設定の 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 chat と openclaw terminal は、このコマンドを
--local が暗黙指定された状態で呼び出します。
注意事項
--localは--url、--token、--passwordと組み合わせられません。tuiは、可能な場合にトークン/パスワード認証用の設定済み Gateway 認証 SecretRefs を解決します (env/file/execプロバイダー)。- 明示的な URL またはポートがない場合、
tuiは実行中の Gateway によって記録されたアクティブなローカル Gateway ポートに従います。 明示的な--url、OPENCLAW_GATEWAY_URL、OPENCLAW_GATEWAY_PORT、リモート Gateway 設定が優先されます。 - 設定済みエージェントワークスペースディレクトリ内から起動すると、TUI はセッションキーのデフォルトとして
そのエージェントを自動選択します (
--sessionが明示的にagent:<id>:...でない限り)。 - 非ローカル URL ベースの接続でフッターに Gateway ホスト名を表示するには、
openclaw config set tui.footer.showRemoteHost trueを実行します。デフォルトではオフです。 ループバックまたは組み込みローカル接続では表示されません。 - ローカルモードは組み込みエージェントランタイムを直接使用します。ほとんどのローカルツールは動作しますが、 Gateway 専用機能は利用できません。
- ローカルモードでは、TUI コマンドサーフェスに
/auth [provider]が追加されます。 - Plugin 承認ゲートはローカルモードでも適用されます。承認が必要なツールは ターミナルで判断を求め、暗黙に自動承認されることはありません。
- セッションの 目標 はフッターに表示され、
/goalで管理できます。
例
設定修復ループ
ローカルモードを使用すると、組み込みエージェントに現在の設定を検査させ、 ドキュメントと比較し、同じターミナルから修復を支援させることができます。openclaw config validate がすでに失敗している場合は、まず openclaw configure または
openclaw doctor --fix を実行してください。openclaw chat は
無効な設定のガードを回避しません。
openclaw config set または openclaw configure で対象を絞った修正を適用し、
その後 openclaw config validate を再実行します。TUI と
設定 を参照してください。