> ## Documentation Index
> Fetch the complete documentation index at: https://openclawdoc.org/llms.txt
> Use this file to discover all available pages before exploring further.

# トゥイ

> 1. ゲートウェイを起動します。2. TUI を開きます。クイックスタート、あなたが見ているもの、メンタル モデル: エージェント + セッションを確認できます。

## クイックスタート

1. ゲートウェイを起動します。

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway
```

2. TUI を開きます。

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tui
```

3. メッセージを入力し、Enter キーを押します。

リモートゲートウェイ:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw tui --url ws://<host>:<port> --token <gateway-token>
```

ゲートウェイがパスワード認証を使用する場合は、`--password` を使用します。

## あなたが見ているもの

* ヘッダー: 接続 URL、現在のエージェント、現在のセッション。
* チャット ログ: ユーザー メッセージ、アシスタントの応答、システム通知、ツール カード。
* ステータス行: 接続/実行状態 (接続、実行、ストリーミング、アイドル、エラー)。
* フッター: 接続状態 + エージェント + セッション + モデル + 思考/詳細/推論 + トークン数 + 配信。
* 入力: オートコンプリート付きのテキスト エディター。

## メンタル モデル: エージェント + セッション

* エージェントは固有のスラッグです (例: `main`、`research`)。ゲートウェイはリストを公開します。
* セッションは現在のエージェントに属します。
* セッションキーは `agent:<agentId>:<sessionKey>` として保存されます。
  * `/session main` と入力すると、TUI はそれを `agent:<currentAgent>:main` に展開します。
  * `/session agent:other:main` と入力すると、そのエージェント セッションに明示的に切り替わります。
* セッションの範囲:
  * `per-sender` (デフォルト): 各エージェントには多数のセッションがあります。
  * `global`: TUI は常に `global` セッションを使用します (ピッカーが空の場合があります)。
* 現在のエージェントとセッションは常にフッターに表示されます。

## 発送+配達- メッセージはゲートウェイに送信されます。プロバイダーへの配信はデフォルトではオフになっています

* 配信をオンにします:
  * `/deliver on`
  * または設定パネル
  * または `openclaw tui --deliver` で始める

## ピッカー + オーバーレイ

* モデル ピッカー: 利用可能なモデルをリストし、セッション オーバーライドを設定します。
* エージェント ピッカー: 別のエージェントを選択します。
* セッション ピッカー: 現在のエージェントのセッションのみを表示します。
* 設定: 配信、ツール出力拡張、および思考の可視性の切り替え。

## キーボード ショートカット

* Enter: メッセージを送信
* Esc: アクティブな実行を中止します
* Ctrl+C: 入力をクリアします (終了するには 2 回押します)
* Ctrl+D: 終了
* Ctrl+L: モデルピッカー
* Ctrl+G: エージェントピッカー
* Ctrl+P: セッションピッカー
* Ctrl+O: ツール出力拡張の切り替え
* Ctrl+T: 思考の表示を切り替えます (履歴をリロードします)

## スラッシュコマンド

コア:

* `/help`
* `/status`
* `/agent <id>` (または `/agents`)
* `/session <key>` (または `/sessions`)
* `/model <provider/model>` (または `/models`)

セッションコントロール:

* `/think <off|minimal|low|medium|high>`
* `/verbose <on|full|off>`
* `/reasoning <on|off|stream>`
* `/usage <off|tokens|full>`
* `/elevated <on|off|ask|full>` (別名: `/elev`)
* `/activation <mention|always>`
* `/deliver <on|off>`

セッションのライフサイクル:

* `/new` または `/reset` (セッションをリセット)
* `/abort` (アクティブな実行を中止します)
* `/settings`
* `/exit`他のゲートウェイ スラッシュ コマンド (`/context` など) はゲートウェイに転送され、システム出力として表示されます。 [スラッシュ コマンド](/tools/slash-commands) を参照してください。

## ローカルシェルコマンド

* TUI ホスト上でローカル シェル コマンドを実行するには、行の先頭に `!` を付けます。
* TUI は、セッションごとに 1 回、ローカルでの実行を許可するようプロンプトを表示します。減少すると、`!` はセッションに対して無効のままになります。
* コマンドは、TUI 作業ディレクトリ内の新しい非対話型シェルで実行されます (永続的な `cd`/env はありません)。
* ローカル シェル コマンドは、環境内で `OPENCLAW_SHELL=tui-local` を受け取ります。
* 単独の `!` が通常のメッセージとして送信されます。先頭のスペースはローカル実行をトリガーしません。

## ツールの出力

* ツール呼び出しは、引数と結果を含むカードとして表示されます。
* Ctrl+O で、折りたたまれたビューと展開されたビューが切り替わります。
* ツールの実行中、部分的な更新が同じカードにストリーミングされます。

## 端子の色

* TUI はアシスタントの本文テキストを端末のデフォルトの前景に保持するため、暗い端末と明るい端末の両方が読みやすくなります。
* 端末が明るい背景を使用しており、自動検出が正しくない場合は、`openclaw tui` を起動する前に `OPENCLAW_THEME=light` を設定してください。
* 代わりに元の暗いパレットを強制するには、`OPENCLAW_THEME=dark` を設定します。

## 履歴 + ストリーミング- 接続時に、TUI は最新の履歴 (デフォルトでは 200 メッセージ) をロードします

* ストリーミング応答は、確定するまでその場で更新されます。
* TUI は、より豊富なツール カードのエージェント ツール イベントもリッスンします。

## 接続の詳細

* TUI はゲートウェイに `mode: "tui"` として登録されます。
* 再接続するとシステム メッセージが表示されます。イベントのギャップがログに現れます。

## オプション

* `--url <url>`: ゲートウェイ WebSocket URL (デフォルトは config または `ws://127.0.0.1:<port>`)
* `--token <token>`: ゲートウェイ トークン (必要な場合)
* `--password <password>`: ゲートウェイのパスワード (必要な場合)
* `--session <key>`: セッションキー (デフォルト: `main`、またはスコープがグローバルの場合は `global`)
* `--deliver`: アシスタントの応答をプロバイダーに配信します (デフォルトはオフ)
* `--thinking <level>`: 送信の思考レベルを上書きする
* `--timeout-ms <ms>`: エージェントのタイムアウト (ミリ秒単位) (デフォルトは `agents.defaults.timeoutSeconds`)

注: `--url` を設定すると、TUI は構成または環境の資格情報にフォールバックしません。
`--token` または `--password` を明示的に渡します。明示的な資格情報が欠落しているとエラーになります。

## トラブルシューティング

メッセージを送信しても出力がありません:- TUI で `/status` を実行して、ゲートウェイが接続されており、アイドル状態/ビジー状態であることを確認します。

* ゲートウェイ ログを確認します: `openclaw logs --follow`。
* エージェントが実行できることを確認します: `openclaw status` および `openclaw models status`。
* チャット チャネルでメッセージが期待される場合は、配信を有効にします (`/deliver on` または `--deliver`)。
* `--history-limit <n>`: ロードする履歴エントリ (デフォルトは 200)

## 接続のトラブルシューティング

* `disconnected`: ゲートウェイが実行中であり、`--url/--token/--password` が正しいことを確認してください。
* ピッカーにエージェントがありません: `openclaw agents list` とルーティング設定を確認してください。
* 空のセッション ピッカー: グローバル スコープ内にいるか、まだセッションが存在しない可能性があります。