Skip to main content

​
TUI（终端界面）

​
快速开始

​
1. 启动 Gateway

openclaw gateway

​
2. 打开 TUI

openclaw tui

​
3. 输入消息并按回车

远程 Gateway： 
openclaw tui --url ws://<host>:<port> --token <gateway-token>

​
你看到的内容

  • 头部：连接 URL、当前代理、当前会话
  • 聊天记录：用户消息、助理回复、系统通知、工具卡片
  • 状态行：连接/运行状态
  • 页脚：连接状态 + 代理 + 会话 + 模型 + 思考/详细/推理 + 令牌计数 + 发送
  • 输入框：带自动补全的文本编辑器

​
概念模型：代理 + 会话

  • 代理是唯一的标识符（如 main、research）
  • 会话属于当前代理
  • 会话键储存形式为 agent:<agentId>:<sessionKey>
  • 当前代理和会话始终显示在页脚

​
发送与发送状态

消息发送到 Gateway；默认不向提供者发出交付。 开启交付：
  • 输入 /deliver on
  • 或在设置面板切换
  • 或启动时加参数 openclaw tui --deliver

​
键盘快捷键

  • 回车：发送消息
  • 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>
  • /activation <mention|always>
  • /deliver <on|off>
会话生命周期：
  • /new 或 /reset
  • /abort
  • /settings
  • /exit

​
本地 shell 命令

  • 行首加 ! 可运行本地 shell 命令
  • TUI 每个会话提示一次是否允许本地执行
  • 命令在 TUI 工作目录的全新非交互 shell 中运行

​
工具输出

  • 工具调用以卡片形式展示参数和结果
  • Ctrl+O 切换收起/展开视图
  • 工具运行时，内容会流式更新在同一卡片中

​
选项

  • --url <url>：Gateway WebSocket URL
  • --token <token>：Gateway 令牌
  • --password <password>：Gateway 密码
  • --session <key>：会话键
  • --deliver：将助理回复交付给提供者
  • --thinking <level>：发送时覆盖思考等级
  • --timeout-ms <ms>：代理超时
  • --history-limit <n>：加载的历史条目数（默认 200）

​
故障排查

​
发送消息后无输出

  • 在 TUI 中运行 /status
  • 检查 Gateway 日志：openclaw logs --follow
  • 确认代理可运行：openclaw status

​
连接故障排查

  • disconnected：确保 Gateway 正在运行且 --url/--token/--password 设置正确
  • 选择器无代理：检查 openclaw agents list
  • 会话选择器为空：可能处于全局范围或尚无会话

​
相关文档