英文 TUI
约 4 分钟
- 原始链接：https://docs.openclaw.ai/web/tui
- 来源章节：6. 官方文档：平台、客户端与 Web 界面
- 来源小节：无
- 抓取方式：jina:https://r.jina.ai/http://docs.openclaw.ai/web/tui
- 抓取时间：2026-04-05 13:47:10
- 状态：ok
中文内容
TUI（终端用户界面）
快速开始
- 启动网关。
开爪网关- 打开 TUI。
张开爪图伊- 输入消息并按 Enter。
远程网关：
openclaw tui --url ws://<主机>:<端口> --token <网关令牌>如果您的网关使用密码身份验证，请使用“--password”。
你所看到的
- 标头：连接 URL、当前代理、当前会话。
- 聊天记录：用户消息、助手回复、系统通知、工具卡片。
- 状态行：连接/运行状态（连接、运行、流式传输、空闲、错误）。
- 页脚：连接状态+代理+会话+模型+思考/快速/详细/推理+令牌计数+交付。
- 输入：具有自动完成功能的文本编辑器。
心理模型：代理+会话
-
代理是独特的 slugs（例如“main”、“research”）。网关公开该列表。
-
会话属于当前代理。
-
会话密钥存储为
agent:<agentId>:<sessionKey>。- 如果您输入“/session main”，TUI 会将其扩展为“agent::main”。
- 如果您键入“/session agent:other:main”，则会显式切换到该代理会话。
-
会议范围：
per-sender（默认）：每个代理有多个会话。global：TUI 始终使用global会话（选择器可能为空）。
-
当前代理+会话始终在页脚中可见。
发送+交付
- 消息发送到网关；默认情况下关闭向提供商的交付。
- 开启传送：
/交付- 或设置面板
- 或以
openclaw tui --deliver开头
选择器 + 覆盖
- 模型选择器：列出可用模型并设置会话覆盖。
- 代理选择器：选择不同的代理。
- 会话选择器：仅显示当前代理的会话。
- 设置：切换交付、工具输出扩展和思维可见性。
键盘快捷键
- 输入：发送消息
- Esc：中止当前运行
- Ctrl+C：清除输入（按两次退出）
- Ctrl+D：退出
- Ctrl+L：模型选择器
- Ctrl+G：代理选择器
- Ctrl+P：会话选择器
- Ctrl+O：切换工具输出扩展
- Ctrl+T：切换思维可见性（重新加载历史记录）
斜线命令
核心：
/帮助/状态/agent <id>（或/agents）/session <key>（或/sessions）/model <provider/model>（或/models）
会话控制：
/think <关|最小|低|中|高>/fast <状态|开|关>/verbose <开|全|关>/reasoning <on|off|stream>/usage <off|tokens|full>/elevated <on|off|ask|full>（别名：/elev）/activation <提及|总是>/deliver <开|关>
会话生命周期：
/new或/reset（重置会话）/abort（中止活动运行）/设置/退出
其他网关斜线命令（例如，/context）将转发到网关并显示为系统输出。请参阅斜线命令。
本地 shell 命令
- 在行前加上“!”前缀以在 TUI 主机上运行本地 shell 命令。
- TUI 每个会话提示一次以允许本地执行；拒绝会使会话禁用“!”。
- 命令在 TUI 工作目录中的全新非交互式 shell 中运行（没有持久的“cd”/env）。
- 本地 shell 命令在其环境中接收
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>：覆盖发送的思考级别--message <text>: 连接后发送初始消息--timeout-ms <ms>：代理超时（以毫秒为单位）（默认为agents.defaults.timeoutSeconds）--history-limit <n>：要加载的历史条目（默认为“200”）
注意：当您设置 --url 时，TUI 不会回退到配置或环境凭据。显式传递 --token 或 --password。缺少显式凭据是一个错误。
故障排除
发送消息后无输出：
- 在 TUI 中运行“/status”以确认网关已连接以及空闲/忙碌。
- 检查网关日志：“openclaw 日志 --follow”。
- 确认代理可以运行：“openclaw status”和“openclaw models status”。
- 如果您希望在聊天频道中收到消息，请启用传递（“/deliver on”或“--deliver”）。