openclaw 文档

简体中文

English

简体中文

English

Appearance

TUI (终端用户界面) ​

快速开始 ​

  1. 启动网关。
bash
openclaw gateway
  1. 打开TUI。
bash
openclaw tui
  1. 输入消息并按Enter键。

远程网关：

bash
openclaw tui --url ws://<主机>:<端口> --token <网关令牌>

如果您的网关使用密码认证，请使用 --password。

界面组成 ​

  • 头部：连接URL、当前代理、当前会话。
  • 聊天记录：用户消息、助手回复、系统通知、工具卡片。
  • 状态行：连接/运行状态（连接中、运行中、流式传输、空闲、错误）。
  • 底部：连接状态 + 代理 + 会话 + 模型 + 思考/详细/推理 + 令牌计数 + 交付。
  • 输入框：带自动补全的文本编辑器。

概念模型：代理 + 会话 ​

  • 代理是唯一的标识符（例如 main、research）。网关会暴露代理列表。
  • 会话属于当前代理。
  • 会话键存储为 agent:<代理ID>:<会话键>。
    • 如果您输入 /session main，TUI会将其扩展为 agent:<当前代理>:main。
    • 如果您输入 /session agent:other:main，您将显式切换到该代理会话。
  • 会话范围：
    • per-sender（默认）：每个代理有多个会话。
    • global：TUI始终使用 global 会话（选择器可能为空）。
  • 当前代理 + 会话始终在底部可见。

发送 + 交付 ​

  • 消息发送到网关；默认情况下不交付给提供商。
  • 开启交付：
    • /deliver on
    • 或通过设置面板
    • 或启动时使用 openclaw tui --deliver

选择器 + 覆盖层 ​

  • 模型选择器：列出可用模型并设置会话覆盖。
  • 代理选择器：选择不同的代理。
  • 会话选择器：仅显示当前代理的会话。
  • 设置：切换交付、工具输出展开和思考可见性。

键盘快捷键 ​

  • Enter：发送消息
  • Esc：中止活动运行
  • Ctrl+C：清除输入（按两次退出）
  • Ctrl+D：退出
  • Ctrl+L：模型选择器
  • Ctrl+G：代理选择器
  • Ctrl+P：会话选择器
  • Ctrl+O：切换工具输出展开
  • Ctrl+T：切换思考可见性（重新加载历史记录）

斜杠命令 ​

核心命令：

  • /help
  • /status
  • /agent <ID>（或 /agents）
  • /session <键>（或 /sessions）
  • /model <提供商/模型>（或 /models）

会话控制：

  • /think <off|minimal|low|medium|high>
  • /verbose <on|full|off>
  • /reasoning <on|off|stream>
  • /usage <off|tokens|full>
  • /elevated <on|off|ask|full>（别名：/elev）
  • /activation <mention|always>
  • /deliver <on|off>

会话生命周期：

  • /new 或 /reset（重置会话）
  • /abort（中止活动运行）
  • /settings
  • /exit

其他网关斜杠命令（例如 /context）会转发到网关并显示为系统输出。请参阅斜杠命令。

本地Shell命令 ​

  • 在行前加上 ! 以在TUI主机上运行本地Shell命令。
  • TUI每个会话会提示一次以允许本地执行；拒绝将使 ! 在该会话中保持禁用状态。
  • 命令在TUI工作目录的新鲜、非交互式Shell中运行（没有持久的 cd/环境变量）。
  • 单独的 ! 会作为普通消息发送；前导空格不会触发本地执行。

工具输出 ​

  • 工具调用显示为包含参数 + 结果的卡片。
  • Ctrl+O 在折叠/展开视图之间切换。
  • 当工具运行时，部分更新会流式传输到同一张卡片中。

历史记录 + 流式传输 ​

  • 连接时，TUI加载最新的历史记录（默认200条消息）。
  • 流式响应在位置更新直到最终确定。
  • TUI还监听代理工具事件以获取更丰富的工具卡片。

连接详情 ​

  • TUI以 mode: "tui" 向网关注册。
  • 重新连接会显示系统消息；事件间隙会在日志中显示。

选项 ​

  • --url <URL>：网关WebSocket URL（默认为配置或 ws://127.0.0.1:<端口>）
  • --token <令牌>：网关令牌（如果需要）
  • --password <密码>：网关密码（如果需要）
  • --session <键>：会话键（默认：main，或范围是全局时的 global）
  • --deliver：将助手回复交付给提供商（默认关闭）
  • --thinking <级别>：覆盖发送的思考级别
  • --timeout-ms <毫秒>：代理超时时间（毫秒）（默认为 agents.defaults.timeoutSeconds）

故障排除 ​

发送消息后没有输出：

  • 在TUI中运行 /status 以确认网关已连接且空闲/忙碌。
  • 检查网关日志：openclaw logs --follow。
  • 确认代理可以运行：openclaw status 和 openclaw models status。
  • 如果您期望在聊天频道中看到消息，请启用交付（/deliver on 或 --deliver）。
  • --history-limit <数量>：要加载的历史记录条目数（默认200）

故障排除 ​

  • disconnected：确保网关正在运行且您的 --url/--token/--password 正确。
  • 选择器中没有代理：检查 openclaw agents list 和您的路由配置。
  • 空的会话选择器：您可能处于全局范围或还没有任何会话。