7.5 TUI终端界面

TUI（终端用户界面）是 OpenClaw 的终端交互界面，提供在命令行环境中与 AI 代理交互的能力。

快速开始

# 启动 Gateway 和 TUI 界面
openclaw tui

# 连接到远程 Gateway
openclaw tui --url ws://remote-host:18789

界面概览

TUI 界面由以下视觉元素组成：

• 头部 - 显示连接状态和当前会话信息
• 聊天日志 - 显示对话历史和 AI 响应
• 状态行 - 显示当前状态和提示信息
• 底部 - 显示可用的快捷键
• 输入编辑器 - 多行文本输入区域

心智模型

TUI 中的代理和会话作为组织单位，支持以下作用域选项：

• 全局作用域 - 跨所有会话共享
• 会话作用域 - 限定于当前会话
• 实例作用域 - 限定于当前实例

核心功能

消息发送

• 发送消息和切换投递选项
• 支持多行输入
• 支持流式响应显示

选择器和覆盖面板

• 会话选择器 - 切换和管理会话
• 代理选择器 - 切换不同的 AI 代理
• 覆盖面板 - 用于导航和高级操作

键盘快捷键

快捷键	功能
Enter	发送消息
Shift+Enter	换行
Ctrl+C	取消/退出
Ctrl+L	清屏
Up/Down	浏览历史
Tab	命令补全

斜杠命令

TUI 支持多种斜杠命令：

核心命令

/help          # 显示帮助信息
/clear         # 清除聊天历史
/quit          # 退出 TUI

会话控制

/session list  # 列出所有会话
/session new   # 创建新会话
/session switch <id>  # 切换到指定会话

生命周期命令

/restart       # 重启代理
/reload        # 重新加载配置
/status        # 显示状态信息

本地 Shell 命令

可以在 TUI 中直接执行本地 shell 命令：

!ls -la        # 执行 ls 命令
!pwd           # 显示当前目录
!cat file.txt  # 查看文件内容

工具输出显示

TUI 提供工具输出的显示和管理功能，支持折叠/展开长输出。

连接详情

• 注册模式 - 首次连接时自动注册
• 重连行为 - 断线后自动尝试重连

命令行选项

openclaw tui [选项]

选项:
  --url <url>           Gateway WebSocket URL
  --auth <token>        认证令牌
  --session <id>        指定会话 ID
  --timeout <ms>        连接超时时间（毫秒）
  --no-color            禁用颜色输出
  --debug               启用调试模式

故障排除

常见问题及解决方案：

• 连接失败 - 检查 Gateway 是否运行，URL 是否正确
• 认证错误 - 验证令牌是否正确配置
• 显示问题 - 确保终端支持 UTF-8 和 256 色
• 快捷键冲突 - 检查终端模拟器的快捷键设置

# 检查 Gateway 状态
openclaw status

# 使用调试模式启动 TUI
openclaw tui --debug

# 指定完整连接参数
openclaw tui --url ws://127.0.0.1:18789 --auth your-token