Skip to main content

4. OpenClaw TUI 交互

TUI（Text User Interface，文本用户界面）是 OpenClaw 的“命令行聊天窗口”。当你在 Jetson 上不方便打开网页控制台，或者你是通过 SSH 远程连接时，用 TUI 就能在终端里完成大多数日常交互：对话、切模型、查看状态、管理会话、调用技能等。

OpenClaw TUI 界面（可替换为你的截图）

1. 如何进入 TUI​

在终端中执行：

openclaw tui

如果你已经在另一个终端启动了 OpenClaw gateway（例如网关/服务端），可以直接执行 openclaw tui 进入交互界面

对于非Docker版本来说，openclaw gateway不需要手动启动，会开机自启

对于docker版本来说（如JetsonNano），需要先开启一个终端，手动运行openclaw gateway来启动网关

2. TUI 界面是什么​

你可以把 TUI 理解成一个“带命令的聊天框”：

  • 上方：对话历史（你发的消息、模型回复、工具/技能输出）
  • 下方：输入框（输入问题或发送斜杠命令）
  • 发送方式：输入完回车发送

建议第一次进入先做两件事：

xxxxxxxxxx /status

3. 斜杠命令​

斜杠命令一般需要作为以 / 开头的独立消息发送，用于控制会话和运行操作。

命令作用什么时候用示例
/help查看帮助与命令列表不知道有哪些命令/help
/status查看当前状态怀疑没连上、想看上下文占用/status
/new新开一条对话线（新会话）话题切换、避免上下文干扰/new
/reset重置会话（等价于重新开始，和new一个效果）对话跑偏、想清空上下文/reset
/model / /models list查看/切换模型想换更快或更强的模型/models list
/think medium设置思考深度日常推荐用low或者关闭/think medium
/stop中止当前任务卡住、想立即停下/stop
/context detail查看当前注入的上下文排查“为什么它记得/忘了某些内容”/context detail
/compact压缩较早历史为摘要对话太长、上下文快满/compact
/skill <name>运行某个技能你知道技能名并想直接跑/skill web_search

补充两条“日常手感”建议：

  • 一条消息里只写一个斜杠命令，最稳妥
  • 想快速浏览所有命令，用 /help 或 /commands

4. 会话（Session）与记忆（Memory）​

在 OpenClaw 里，这两个概念分工很清晰：

  • 会话（Session）：管理“这次对话聊到哪了”。你在 TUI 里使用 /new、/reset，本质是在切换/重开会话。
  • 记忆（Memory）：管理“跨会话也应该长期保留的内容”。它会写入磁盘（Markdown），在需要时再检索回当前会话使用。

4.1 会话文件在哪​

会话会以 JSONL 的形式落盘保存，常见位置（以实际安装路径为准）：

  • 索引：~/.openclaw/agents/<agentId>/sessions/sessions.json
  • 转录：~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl

实际排查时更省事的方式是先执行：

xxxxxxxxxx openclaw status

它通常会给出 store path 以及最近会话信息。

4.2 记忆怎么“用起来”​

你可以把 Memory 理解成“让机器人写笔记”：

  • memory/YYYY-MM-DD.md：每天的过程记录，适合记录进度、临时决定
  • MEMORY.md：长期稳定信息（偏好、固定规则、项目约束等）

实操建议：

  • 想让某个结论跨会话也能用：直接对机器人说“把这条写进 MEMORY.md”
  • 准备 /new 切到新话题：先用 /compact 或把关键决策写进 Memory，再切会话

5. 快速上手流程​

  1. 进入 TUI：openclaw tui
  2. 确认状态：/status
  3. 选择模型：/models list → /model <编号或名称>
  4. 日常对话：直接输入问题回车
  5. 话题切换：/new
  6. 上下文太长：/compact
  7. 关键结论要长期保留：让机器人写入 Memory

6. 常见问题排查​

6.1 输入了命令没反应​

  • 确认命令是独立一行发送的（不要和普通文本混在一起）
  • 先用 /help 看看当前版本支持哪些命令

6.2 觉得“它开始胡说、听不懂人话”或被历史干扰​

  • 开新会话：/new 或 /reset
  • 看上下文注入了什么：/context detail

6.3 响应越来越慢​

  • 降低思考深度：/think low 或 /think minimal
  • 压缩历史：/compact