CLI commands

TUI

OmeniaClaw 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 の場合は global セッションキー。エージェントワークスペース内では、接頭辞がない限りそのエージェントが自動選択されます。
--deliver false 設定済みチャンネル経由でアシスタントの返信を配信します。
--thinking <level> (モデルの既定値) Thinking レベルの上書き。
--message <text> (なし) 接続後に初期メッセージを送信します。
--timeout-ms <ms> agents.defaults.timeoutSeconds エージェントタイムアウト。無効な値は警告をログに記録して無視されます。
--history-limit <n> 200 アタッチ時に読み込む履歴エントリ数。

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

注記:

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

bash
OmeniaClaw chatOmeniaClaw tui --localOmeniaClaw tuiOmeniaClaw tui --url ws://127.0.0.1:18789 --token <token>OmeniaClaw tui --session main --deliverOmeniaClaw chat --message "Compare my config to the docs and tell me what to fix"# when run inside an agent workspace, infers that agent automaticallyOmeniaClaw tui --session bugfix

Config 修復ループ

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

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

bash
OmeniaClaw chat

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

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

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

関連

Was this useful?
On this page

On this page