TUI

怎么开始玩？

首先，你需要一个叫“网关”（Gateway）的大管家在后台工作。然后，你就能打开TUI聊天窗口了。

1. 启动大管家。打开电脑的“终端”或“命令提示符”那个黑窗口，输入 openclaw gateway 然后按回车。看到它开始运行就可以了。
2. 打开聊天窗口。在同一个黑窗口里，再输入 openclaw tui 然后按回车。一个漂亮的聊天窗口就会弹出来啦！
3. 开始聊天。在窗口最下面输入你想说的话，然后按“回车”键，就能发送出去了。

如果你的大管家在别的电脑上，你需要告诉TUI去哪里找它。输入的命令要长一点：openclaw tui --url ws://<电脑地址>:<端口号> --token <通行证>。把 <电脑地址>、<端口号> 和 <通行证> 换成你自己的。如果大管家用的是密码，就把 --token 换成 --password。

窗口里都有什么？

窗口从上到下分成几块：

• 最顶上：显示你和谁连上了，现在在和哪个小助手聊天，聊的是哪个话题（会话）。
• 中间大片：这是聊天记录。你说的话、小助手的回答、系统的通知，还有小助手用的“工具卡片”都会显示在这里。
• 状态行：告诉你现在在干嘛，比如“正在连接”、“正在思考”、“正在说话”或者“出错了”。
• 最底下：这里信息最多，有连接状态、小助手名字、话题名字、用的模型名字，还有一些开关和计数。
• 输入框：你打字的地方，有自动补全功能哦。

小助手和聊天话题

你可以把“小助手”（Agent）想象成不同的小专家，比如有“学习专家”、“研究专家”。大管家会告诉你现在有哪些小专家可用。 “聊天话题”（Session）就是你和某个小专家聊的一个具体事情。每个小专家都可以有很多个不同的话题。 话题的名字有个固定格式，像 agent:专家名字:话题名字。在TUI里，你可以用 /session 话题名字 来快速切换。TUI会自动帮你加上专家名字。

怎么让小助手真的去干活？

你发消息，TUI会先传给大管家。但默认情况下，大管家只是听听，不会真的去叫别的地方（Provider）干活。要让小助手真的行动起来，你需要“开启交付”（Deliver）。 开启的方法有三种：

1. 在输入框输入 /deliver on。
2. 去“设置”面板里打开。
3. 或者在启动TUI时就加上 --deliver 这个选项，像这样：openclaw tui --deliver。

一些有用的快捷键和“魔法指令”

按键盘上的某些键，可以快速做事情：

• 回车：发送消息。
• Esc：如果小助手正在想啊想，按这个可以让他停下来。
• Ctrl+C：清空你正在输入的话（按两次会退出TUI）。
• Ctrl+D：直接退出TUI。
• Ctrl+L：弹出模型选择器（换一个“大脑”）。
• Ctrl+G：弹出小助手选择器（换一个专家）。
• Ctrl+P：弹出话题选择器（换一个聊天话题）。
• Ctrl+O：切换工具卡片的展开/收起。
• Ctrl+T：切换是否显示小助手的“思考过程”。

你还可以输入以 / 开头的“魔法指令”：

• /help：查看所有指令。
• /agent 名字：切换小助手。
• /session 名字：切换聊天话题。
• /model 名字：换一个模型。
• /new 或 /reset：重置当前话题，开始全新的聊天。
• /abort：停止当前运行的任务。
• /exit：退出TUI。

在TUI里运行电脑命令

如果你想在运行TUI的电脑上执行一个命令（比如看看文件列表），可以在输入框最前面加一个 !，然后输入命令。比如 !ls。 第一次这么做时，TUI会问你是否允许。如果拒绝了，这次聊天中就不能再用 ! 了。这些命令会在一个全新的、简单的环境里运行。

如果遇到问题怎么办？

• 发了消息没反应：先在TUI里输入 /status，看看大管家是不是连上了，是空闲还是正忙。也可以去大管家的日志里看看：openclaw logs --follow。
• 连接不上：检查大管家是不是在运行，还有你输入的 --url、--token 或 --password 对不对。
• 小助手列表是空的：在终端运行 openclaw agents list 命令，看看大管家那里有哪些小助手。
• 话题列表是空的：你可能处于“全局”模式，或者还没有创建过任何话题。

要记住哦：如果你启动TUI时用了 --url 指定了地址，就必须同时用 --token 或 --password 把密码也写上，TUI不会自己去别的地方找密码。如果没写，就会出错。