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 chat と openclaw terminal は、--local が暗黙指定された同じコマンドを呼び出します。
注記:
chatとterminalはopenclaw 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で管理できます。
例
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 は無効な
設定ガードを迂回しません。
openclaw chatその後、TUI 内で次を実行します。
!openclaw config file!openclaw docs gateway auth token secretref!openclaw config validate!openclaw doctoropenclaw config set または openclaw configure で対象を絞って修正を適用し、その後
openclaw config validate を再実行します。TUI と Config を参照してください。
関連
Was this useful?