OpenClaw如何开启TUI功能

想要更直观的交互体验？OpenClaw的TUI（终端用户界面）功能让命令行操作变得像图形界面一样简单！

本文将详细介绍什么是TUI功能、如何开启以及如何使用，帮助你提升OpenClaw的使用效率。

什么是TUI功能？

TUI（Text-based User Interface，文本用户界面）是一种在终端中运行的图形化界面。与传统的命令行界面（CLI）相比，TUI提供了：

可视化操作：菜单、按钮、表格等图形元素
交互式导航：使用键盘方向键或鼠标进行操作
实时反馈：操作结果即时显示，无需记忆复杂命令
分屏显示：多个面板同时展示不同信息

对于OpenClaw来说，TUI功能让你可以更直观地：

查看和管理会话
监控任务执行状态
浏览文件和目录
配置系统设置

如何开启TUI功能

方法一：启动时直接开启

在启动OpenClaw时添加 --tui 参数：

openclaw --tui

方法二：配置文件中启用

编辑OpenClaw配置文件（通常位于 ~/.openclaw/config.yaml）：

# 添加或修改以下配置
tui:
  enabled: true
  theme: "default"  # 可选主题：default, dark, light
  mouse: true       # 启用鼠标支持

保存后重启OpenClaw即可生效。

方法三：运行时切换

在OpenClaw运行过程中，随时可以通过命令切换到TUI模式：

/tui

或者在交互式提示符中输入：

> tui

TUI界面介绍

成功开启TUI后，你会看到类似以下的界面布局：

┌─────────────────────────────────────────────────────────┐
│  OpenClaw TUI - Main Menu                               │
├──────────────┬──────────────────────────────────────────┤
│              │                                          │
│  [Sessions]  │  Session List                            │
│  [Tasks]     │  ┌──────┬──────────┬────────┬─────────┐  │
│  [Files]     │  │ Name │ Status   │ Type   │ Runtime │  │
│  [Config]    │  ├──────┼──────────┼────────┼─────────┤  │
│  [Logs]      │  │ main │ active   │ agent  │ 2h 15m  │  │
│  [Help]      │  │ cron │ idle     │ cron   │ 5m 30s  │  │
│              │  └──────┴──────────┴────────┴─────────┘  │
│              │                                          │
│              │  [Details] [Actions] [Refresh]           │
│              │                                          │
└──────────────┴──────────────────────────────────────────┘
Status: Connected | Mode: TUI | Press 'q' to quit

主要区域说明

左侧导航栏：

Sessions：查看和管理所有会话
Tasks：监控任务执行状态
Files：浏览和编辑文件
Config：修改系统配置
Logs：查看运行日志
Help：获取帮助信息

右侧内容区：

显示当前选中功能的详细信息
支持表格、列表、文本等多种展示形式

底部状态栏：

显示当前连接状态
显示操作模式
显示常用快捷键提示

常用操作指南

键盘快捷键

按键	功能
`↑` / `↓`	上下移动选择
`←` / `→`	左右切换面板
`Enter`	确认选择/进入详情
`Esc` / `q`	返回上一级/退出
`Tab`	切换焦点区域
`Ctrl + R`	刷新当前页面
`Ctrl + Q`	退出TUI模式

鼠标操作

如果启用了鼠标支持（mouse: true），你可以：

单击：选择项目或按钮
双击：进入详情或执行操作
滚动：浏览长列表

常见问题

Q: TUI界面显示乱码怎么办？

A: 确保你的终端支持UTF-8编码，并安装了支持Unicode的字体。

# 检查终端编码
echo $LANG

# 应该输出类似：en_US.UTF-8 或 zh_CN.UTF-8

Q: 鼠标无法使用？

确认配置中启用了鼠标：mouse: true
确认你的终端支持鼠标（如：iTerm2、Windows Terminal等）
某些SSH客户端可能不支持鼠标转发

Q: 如何快速切换回CLI模式？

A: 按 Ctrl + Q 或输入命令 /cli。

总结

OpenClaw的TUI功能让命令行操作变得更加直观和高效。无论是会话管理、任务监控还是文件浏览，TUI都提供了比传统CLI更好的用户体验。

建议：

日常使用推荐开启TUI模式
脚本自动化时可以使用CLI模式
根据个人喜好自定义主题和快捷键

赶快开启你的TUI体验吧！

本文基于OpenClaw v2.x版本编写，不同版本功能可能略有差异。