このページの内容
このページの内容
CLI commands
TUI
openclaw tui
Gateway に接続されたターミナル UI を開くか、ローカル埋め込みモードで実行します。
関連ガイド: TUI
オプション
| フラグ | デフォルト | 説明 |
|---|---|---|
--local |
false |
Gateway の代わりにローカルの埋め込みエージェントランタイムを使用して実行します。 |
--url <url> |
設定の gateway.remote.url |
Gateway WebSocket URL。 |
--token <token> |
（なし） | 必要な場合の Gateway トークン。 |
--password <pass> |
（なし） | 必要な場合の Gateway パスワード。 |
--tls-fingerprint <sha256> |
gateway.remote.tlsFingerprint |
固定された wss:// Gateway に期待される TLS 証明書フィンガープリント。 |
--session <key> |
main（スコープがグローバルの場合は global） |
セッションキー。エージェントワークスペース内では、プレフィックスがない限り、そのエージェントが自動選択されます。 |
--deliver |
false |
設定済みのチャンネルを通じてアシスタントの応答を配信します。 |
--thinking <level> |
（モデルのデフォルト） | 思考レベルを上書きします。 |
--message <text> |
（なし） | 接続後に最初のメッセージを送信します。 |
--timeout-ms <ms> |
agents.defaults.timeoutSeconds |
エージェントのタイムアウト。無効な値は警告がログに記録され、無視されます。 |
--history-limit <n> |
200 |
アタッチ時に読み込む履歴エントリ数。 |
エイリアス: 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 と
設定を参照してください。
関連項目
Was this useful?
