SecretRefs 会先帮你找门票
如果 token 或 password 被藏在 env / file / exec 里，TUI 会尽量把它们翻出来，不让你手动乱抄。
Cli 导读
一条命令打开终端 UI，自动帮你填好认证和会话
执行 `openclaw tui` 即可启动连接到 Gateway 的终端界面，无需手动拼 URL 或 token——它会自动解析配置中的 SecretRef（支持 env/file/exec 三种 provider）。如果你在 agent 工作目录下运行，还会自动选中当前 agent 作为默认会话，省去 `--session` 参数。
先讲这一页到底在解决什么
一条命令打开终端 UI，自动帮你填好认证和会话
执行 `openclaw tui` 即可启动连接到 Gateway 的终端界面，无需手动拼 URL 或 token——它会自动解析配置中的 SecretRef（支持 env/file/exec 三种 provider）。如果你在 agent 工作目录下运行，还会自动选中当前 agent 作为默认会话，省去 `--session` 参数。
第一站
🖥 先想画面：你坐在终端前，但后面连着一整栋楼
官方开头很短，因为它想先把边界说清楚。TUI 是终端 UI，真正干活的还是 Gateway 那头。
openclaw tui像在你眼前打开一块终端驾驶屏。你坐下就能开始用。
--url ws://127.0.0.1:18789 --token <token>像你要去另一栋楼坐驾驶舱，所以得先带地址，再带门票。
--session main --deliver像你一进门就指定“今天我要坐哪个工位，还要把消息送出去”。
⭐ 一句话
TUI 是终端里的前台，后面仍然是 Gateway 在撑着。
第二站
🪪 这页最先要懂的，是“门票怎么来”
官方 notes 只有两句，但都很关键。它在提醒你：TUI 不是乱连的，auth 和 session 默认都会尽量帮你选好。
它先帮你把能拿到的都拿来
像出门前家里人先帮你把钥匙找好，你不用每次都弯腰翻抽屉。
session 默认会看你现在在哪个工位
如果你就在一个配置好的 agent 工作区里，TUI 会很聪明地默认选那个 agent。
一句话
门票能自动找的，TUI 会先帮你找；工位能自动认的，它也会先认。
第三站
🎒 `openclaw tui` 的几条例子，其实是在讲“怎么从不同门口坐进去”
官方的 example 不多，但每一条都很像实际坐车的几种方式。
openclaw tui像你坐到本机默认驾驶舱里，先看看当前楼里谁在值班。
openclaw tui --url ws://127.0.0.1:18789 --token <token>像你手里拿着地址和门票，明确告诉它要去哪个 Gateway。
openclaw tui --session main --deliver像你坐下后就先把“我要发出去”这盏灯打开，不然消息可能只会在车厢里转。
openclaw tui --session bugfix像你直接钻进一个叫 bugfix 的抽屉里，专心修这一件事。
第四站
🪑 这个终端驾驶舱，本质上还是在帮你坐对工位
很多人第一次用 TUI 会以为它只是聊天框。其实它更像工位切换器。
坐哪一个 agent
如果你在一个配置好的 agent 工作区里，TUI 会尽量替你对号入座。
看哪一段 session
session 像抽屉，TUI 让你在抽屉之间走来走去，不用每次重开。
消息要不要送出去
--deliver 就像把“只看不发”切成“真的把消息递出去”。
默认行为尽量聪明
它会尽量帮你选对身份，但你也可以自己手动指定，不必完全靠猜。
第五站
🌙 这页真正的味道，是“少跳一层网页，多一层手感”
TUI 的意义不是炫技，而是让你在终端里直接做平时会去浏览器里做的事。它更快，也更像手边工具。
⌨️ 更像敲键盘的人
如果你习惯 shell，TUI 就像把网页里那些常用按钮收进键盘里。
🪟 少开一扇窗
很多时候你不想来回切浏览器，那就直接在终端里完成。
🔗 背后还是 Gateway
这不是本地离线聊天小屋，而是 Gateway 的前台驾驶舱。
🎈 一句话
TUI 的便利来自“少切一个界面”，不是来自“换了一套系统”。
最后总结
🎈 把 `openclaw tui` 压成一句话
`openclaw tui` 就是终端里的 OpenClaw 总控室：它会尽量帮你找好门票、认好工位，然后让你在 shell 里直接和 Gateway 说话。
如果你下一页只想继续看一页，我建议看 `/web/tui`。那一页会把这个终端驾驶舱的界面讲得更像房间布置图。