openclaw tui 是终端 UI 命令，可连接远程 Gateway 或本地直接启动智能体。使用 --url 指定 WebSocket 地址，–token 或 --password 认证；本地模式用 --local 或别名 openclaw chat，不会绕过配置校验。支持 --session 切换会话、–deliver 通过渠道投递回复、–timeout-ms 和 --history-limit 调参。在工作区目录内自动选择对应智能体。注意 --local 不能与 --url/–token/–password 混用。

openclaw tui：终端 UI 怎么连接 Gateway 或本地运行 #

打开连接到 Gateway 的终端 UI，或直接使用本地嵌入式智能体运行时。

相关文档：

• TUI 使用指南：TUI

选项 #

别名：openclaw chat 和 openclaw terminal 会以隐含 --local 的方式执行相同命令。

补充说明：

• chat 和 terminal 是 openclaw tui --local 的别名。
• --local 不能与 --url、--token、--password 同时使用。
• tui 在可能的情况下解析配置中 Gateway 认证的 SecretRef（支持 env/file/exec 提供方），自动完成 token/密码认证。
• 如果在某个智能体工作区目录内启动，TUI 会自动将该智能体设为会话 key 的默认值（除非通过 --session 显式指定 agent:<id>:... 格式）。
• 本地模式直接使用嵌入式智能体运行时。大部分本地工具可用，但 Gateway 专属功能不可用。
• 本地模式在 TUI 内部命令界面增加 /auth [provider]。
• 插件审批门控在本地模式下仍然生效。需要审批的工具会在终端中提示用户决策；不会因为不涉及 Gateway 而静默自动批准。

示例 #

openclaw chat
openclaw tui --local
openclaw tui
openclaw tui --url ws://127.0.0.1:18789 --token <token>
openclaw tui --session main --deliver
openclaw chat --message "Compare my config to the docs and tell me what to fix"
# 在智能体工作区目录内运行时，自动推断对应智能体
openclaw tui --session bugfix

配置修复循环 #

当当前配置已验证通过，希望嵌入式智能体检查配置、对比文档并从同一终端修复时，使用本地模式：

如果 openclaw config validate 已经失败，请先使用 openclaw configure 或 openclaw doctor --fix。openclaw chat 不会绕过无效配置的防护。

openclaw chat

然后在 TUI 内部执行：

!openclaw config file
!openclaw docs gateway auth token secretref
!openclaw config validate
!openclaw doctor

应用针对性的修复时使用 openclaw config set 或 openclaw configure，然后重新运行 openclaw config validate。详见 TUI 和 Config。

相关文档 #

• CLI reference
• TUI 完整指南

常见问题 #

openclaw tui 报错连不上 Gateway 怎么办？ #

检查 --url 是否指向正确的 WebSocket 地址（格式 ws://host:port），是否需要 --token 或 --password。如果已在 Gateway 目录下运行，tui 会自动读取配置中的 gateway.remote.url 和 SecretRef。如果只想测试本地智能体，使用 --local 或 openclaw chat 即可绕过 Gateway。

–local 和 --url 能一起用吗？ #

不能。–local 隐含不使用 Gateway，会忽略 --url、–token、–password。如果同时指定，tui 会报错或忽略多余参数。建议只选择一种模式。

怎么在工作区目录内自动选择智能体？ #

在 openclaw 智能体工作区目录下运行 openclaw tui 时，会话默认会选用该目录对应的智能体。如果想覆盖，用 --session agent:<id>:... 显式指定。