TUI（终�?UI�?

快速开�?

  1. 启动 Gateway�?
openclaw gateway
  1. 打开 TUI�?
openclaw tui
  1. 输入消息并按 Enter�?

远程 Gateway�?

openclaw tui --url ws://<host>:<port> --token <gateway-token>

如果你的 Gateway 使用密码认证，使�?--password�?

界面说明

  • 标题栏：连接 URL、当前代理、当前会话�?
  • 聊天日志：用户消息、助手回复、系统通知、工具卡片�?
  • 状态栏：连�?运行状态（connecting、running、streaming、idle、error）�?
  • 页脚：连接状�?+ 代理 + 会话 + 模型 + think/verbose/reasoning + token 计数 + deliver�?
  • 输入：带自动补全的文本编辑器�?

心智模型：代�?+ 会话

  • 代理是唯一�?slug（例�?main、research）。Gateway 公开该列表�?
  • 会话属于当前代理�?
  • 会话键存储为 agent:<agentId>:<sessionKey>�?
    • 如果你输�?/session main，TUI 将其展开�?agent:<currentAgent>:main�?
    • 如果你输�?/session agent:other:main，你显式切换到那个代理会话�?
  • 会话范围�?
    • per-sender（默认）：每个代理有多个会话�?
    • global：TUI 始终使用 global 会话（选择器可能为空）�?
  • 当前代理 + 会话始终显示在页脚�?

发�?+ 交付

  • 消息发送到 Gateway；默认关闭交付到 provider�?
  • 开启交付：
    • /deliver on
    • 或设置面�?
    • 或使�?openclaw tui --deliver 启动

选择�?+ 覆盖�?

  • 模型选择器：列出可用模型并设置会话覆盖�?
  • 代理选择器：选择不同的代理�?
  • 会话选择器：仅显示当前代理的会话�?
  • 设置：切�?deliver、工具输出展开和思考可见性�?

键盘快捷�?

  • Enter：发送消�?
  • Esc：中止活动运�?
  • Ctrl+C：清除输入（按两次退出）
  • 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

其他 Gateway 斜杠命令（例�?/context）被转发�?Gateway 并显示为系统输出。参见斜杠命令�?

本地 shell 命令

  • 在一行前�?! 以在 TUI 主机上运行本�?shell 命令�?
  • TUI 每次会话提示一次以允许本地执行；拒绝则在该会话中保�?! 禁用�?
  • 命令�?TUI 工作目录中的新非交互�?shell 中运行（无持久的 cd/环境）�?
  • 单独�?! 作为普通消息发送；前导空格不会触发本地执行�?

工具输出

  • 工具调用显示为带参数 + 结果的卡片�?
  • Ctrl+O 在折�?展开视图之间切换�?
  • 工具运行时，部分更新流式传输到同一卡片�?

历史 + 流式传输

  • 连接时，TUI 加载最新历史（默认 200 条消息）�?
  • 流式响应在原地更新直到完成�?
  • TUI 还会监听代理工具事件以获得更丰富的工具卡片�?

连接详情

  • TUI �?Gateway 注册�?mode: "tui"�?
  • 重新连接显示系统消息；事件间隙显示在日志中�?

选项

  • --url <url>：Gateway WebSocket URL（默认为配置�?ws://127.0.0.1:<port>�?
  • --token <token>：Gateway token（如果需要）
  • --password <password>：Gateway 密码（如果需要）
  • --session <key>：会话键（默认：main，或当范围为 global 时是 global�?
  • --deliver：向 provider 交付助手回复（默认关闭）
  • --thinking <level>：覆盖发送的思考级�?
  • --timeout-ms <ms>：代理超时毫秒数（默认为 agents.defaults.timeoutSeconds�?

注意：当你设�?--url 时，TUI 不会回退到配置或环境凭证。显式传�?--token �?--password。缺少显式凭证是错误�?

故障排除

发送消息后无输出：

  • �?TUI 中运�?/status 确认 Gateway 已连接且空闲/忙碌�?
  • 检�?Gateway 日志：openclaw logs --follow�?
  • 确认代理可以运行：openclaw status �?openclaw models status�?
  • 如果你在聊天频道中期望消息，启用交付（/deliver on �?--deliver）�?
  • --history-limit <n>：要加载的历史条目数（默�?200�?

连接故障排除

  • disconnected：确�?Gateway 正在运行且你�?--url/--token/--password 正确�?
  • 选择器中没有代理：检�?openclaw agents list 和你的路由配置�?
  • 会话选择器为空：你可能处�?global 范围或还没有会话�?