ClawCN - OpenClaw 中文版

主题

TUI(终端用户界面) ​

快速开始 ​

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

远程 Gateway:

bash
openclaw tui --url ws://<host>:<port> --token <gateway-token>

如果您的 Gateway 使用密码认证,请使用 --password。

界面显示 ​

  • 顶部栏:连接 URL、当前代理、当前会话。
  • 聊天日志:用户消息、助手回复、系统通知、工具卡片。
  • 状态行:连接/运行状态(连接中、运行中、流式传输中、空闲、错误)。
  • 底部栏:连接状态 + 代理 + 会话 + 模型 + think/verbose/reasoning + token 计数 + deliver。
  • 输入框:带自动完成的文本编辑器。

概念模型:代理 + 会话 ​

  • 代理是唯一标识符(例如 main、research)。Gateway 公开代理列表。
  • 会话属于当前代理。
  • 会话键存储为 agent:<agentId>:<sessionKey>。
    • 如果您输入 /session main,TUI 会将其扩展为 agent:<currentAgent>:main。
    • 如果您输入 /session agent:other:main,您将显式切换到该代理会话。
  • 会话作用域:
    • per-sender(默认):每个代理有多个会话。
    • global:TUI 始终使用 global 会话(选择器可能为空)。
  • 当前代理 + 会话始终在底部栏中可见。

发送 + 投递 ​

  • 消息发送到 Gateway;默认情况下不投递到提供商。
  • 开启投递:
    • /deliver on
    • 或通过设置面板
    • 或使用 openclaw tui --deliver 启动

选择器 + 覆盖层 ​

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

键盘快捷键 ​

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

斜杠命令 ​

核心:

  • /help
  • /status
  • /agent <id>(或 /agents)
  • /session <key>(或 /sessions)
  • /model <provider/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

其他 Gateway 斜杠命令(例如 /context)会被转发到 Gateway 并显示为系统输出。参见 斜杠命令。

本地 Shell 命令 ​

  • 在行首添加 ! 前缀以在 TUI 主机上运行本地 shell 命令。
  • TUI 每个会话提示一次以允许本地执行;拒绝将在该会话中禁用 !。
  • 命令在 TUI 工作目录中的全新非交互式 shell 中运行(无持久 cd/环境)。
  • 单独的 ! 作为普通消息发送;前导空格不会触发本地执行。

工具输出 ​

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

历史 + 流式传输 ​

  • 连接时,TUI 加载最新历史记录(默认 200 条消息)。
  • 流式响应就地更新直到完成。
  • TUI 还监听代理工具事件以获得更丰富的工具卡片。

连接详情 ​

  • TUI 以 mode: "tui" 的身份向 Gateway 注册。
  • 重新连接显示系统消息;事件间隙会在日志中显示。

选项 ​

  • --url <url>:Gateway WebSocket URL(默认为配置或 ws://127.0.0.1:<port>)
  • --token <token>:Gateway token(如果需要)
  • --password <password>:Gateway 密码(如果需要)
  • --session <key>:会话键(默认:main,或当作用域为全局时为 global)
  • --deliver:将助手回复投递到提供商(默认关闭)
  • --thinking <level>:覆盖发送的思考级别
  • --timeout-ms <ms>:代理超时时间(毫秒)(默认为 agents.defaults.timeoutSeconds)

故障排除 ​

发送消息后没有输出:

  • 在 TUI 中运行 /status 以确认 Gateway 已连接且处于空闲/繁忙状态。
  • 检查 Gateway 日志:openclaw logs --follow。
  • 确认代理可以运行:openclaw status 和 openclaw models status。
  • 如果您期望在聊天频道中看到消息,请启用投递(/deliver on 或 --deliver)。
  • --history-limit <n>:要加载的历史条目数(默认 200)

故障排除 ​

  • disconnected:确保 Gateway 正在运行且您的 --url/--token/--password 正确。
  • 选择器中没有代理:检查 openclaw agents list 和您的路由配置。
  • 会话选择器为空:您可能处于全局作用域或尚未创建会话。