如果你经常 SSH 到服务器管理 OpenClaw， TUI（终端用户界面）比敲命令行更直观， 比浏览器更轻量——不需要任何图形界面。
TUI vs Control UI：选哪个？
| 场景 | 推荐 |
|---|---|
| 日常本地使用，有浏览器 | Control UI（http://127.0.0.1:18789） |
| SSH 到远程服务器 | TUI（直接在终端里） |
| 低带宽/不稳定网络 | TUI（纯文字，流量极少） |
| 无头服务器（无 GUI） | TUI |
| 快速查看日志 | TUI 或 openclaw logs |
| 需要修改复杂配置 | Control UI（表单更友好） |
启动 TUI
bash
# 连接到本地 Gateway
openclaw tui
# 连接到指定远程 Gateway（通过 SSH 隧道后）
openclaw tui --gateway ws://127.0.0.1:18789
# 直接连接远程 Gateway（需要 Token）
openclaw tui --gateway wss://ai.example.com --token your-token界面布局
┌─ OpenClaw TUI ─────────────────────────────────────────────┐
│ [Agents] [Sessions] [Channels] [Nodes] [Logs] [Chat] │
├────────────────────────────────────────────────────────────┤
│ │
│ Agents Sessions │
│ ───────────────── ───────────────────── │
│ ► default running ► @alice (telegram) ✓ │
│ work-assistant idle @bob (slack) ✓ │
│ local-coder idle #dev (discord) ✓ │
│ │
│ Channels Logs │
│ ───────────────── ───────────────────── │
│ ● telegram online 14:23 [INFO] msg recv │
│ ● slack online 14:23 [INFO] → claude │
│ ○ matrix offline 14:24 [INFO] ← 312tok │
│ │
├────────────────────────────────────────────────────────────┤
│ Tab: 切换面板 | /: 搜索 | r: 刷新 | q: 退出 | ?: 帮助 │
└────────────────────────────────────────────────────────────┘
完整快捷键手册
导航
| 快捷键 | 功能 |
|---|---|
Tab | 切换到下一个面板 |
Shift+Tab | 切换到上一个面板 |
↑ / ↓ | 在列表中上下移动 |
Enter | 选择/展开当前项 |
Esc | 返回/取消 |
搜索与过滤
| 快捷键 | 功能 |
|---|---|
/ | 打开搜索框 |
f | 过滤当前列表 |
Ctrl+F | 全局搜索 |
操作
| 快捷键 | 功能 |
|---|---|
r | 刷新当前视图 |
R | 强制全量刷新 |
d | 查看选中项详情 |
e | 编辑配置（YAML/JSON） |
l | 查看日志 |
m | 发送测试消息 |
日志面板
| 快捷键 | 功能 |
|---|---|
E | 只显示 ERROR |
W | 显示 WARN 及以上 |
A | 显示所有日志 |
c | 清空日志显示 |
s | 保存日志到文件 |
Ctrl+C | 停止日志滚动 |
退出
| 快捷键 | 功能 |
|---|---|
q | 退出 TUI（Gateway 继续运行） |
Ctrl+C | 退出 TUI |
Q | 退出 TUI 并停止 Gateway |
在 TUI 中发送测试消息
1. 切换到 Sessions 面板（Tab 键）
2. 选择一个会话（↑↓ 选择，Enter 确认）
3. 按 m 打开消息发送框
4. 输入测试内容，Enter 发送
5. 观察 Logs 面板中 AI 的处理过程
用途：在服务器上快速测试 AI 是否正常响应， 不需要打开 Telegram/WhatsApp 发真实消息。
日志实时监控
切换到 Logs 面板
→ 实时显示 Gateway 日志流
→ 按 / 搜索关键词（如 "error" 或 "telegram"）
→ 按 E 过滤只显示错误
在 TUI 的日志面板等同于：
bash
openclaw logs --follow --level warn与 tmux 配合使用（推荐生产环境）
在服务器上长期运行 TUI，断开 SSH 后不丢失：
bash
# 创建 tmux 会话
tmux new-session -s openclaw
# 在 tmux 中启动 Gateway
openclaw gateway start &
# 在另一个 tmux 窗口启动 TUI
openclaw tui
# 断开 SSH（tmux 继续在后台运行）
# Ctrl+b, d
# 重新连接
ssh user@server
tmux attach -t openclawSSH 隧道 + TUI 的组合
bash
# 本地建立 SSH 隧道
ssh -N -L 18789:127.0.0.1:18789 user@server &
# 本地启动 TUI 连接远程 Gateway
openclaw tui --gateway ws://127.0.0.1:18789这样在本地终端里就能管理远程服务器的 OpenClaw， 响应速度比打开浏览器快得多。
来源：OpenClaw 官方文档 - docs.openclaw.ai/web/tui