openclaw tui
打开连接到 Gateway 网关的终端 UI，或以本地嵌入式模式运行它。
相关指南：TUI
选项
| 标志 | 默认值 | 描述 |
|---|---|---|
--local | false | 使用本地嵌入式智能体运行时，而不是 Gateway 网关运行。 |
--url <url> | 配置中的 gateway.remote.url | Gateway 网关 WebSocket URL。 |
--token <token> | （无） | 如有需要，使用 Gateway 网关令牌。 |
--password <pass> | （无） | 如有需要，使用 Gateway 网关密码。 |
--session <key> | main（或当作用域为全局时为 global） | 会话键。在智能体工作区内，除非添加前缀，否则它会自动选择该智能体。 |
--deliver | false | 通过已配置的渠道发送助手回复。 |
--thinking <level> | （模型默认值） | 思考级别覆盖。 |
--message <text> | （无） | 连接后发送初始消息。 |
--timeout-ms <ms> | agents.defaults.timeoutSeconds | 智能体超时。无效值会记录警告并被忽略。 |
--history-limit <n> | 200 | 附加时加载的历史条目数。 |
openclaw chat 和 openclaw terminal 会调用此命令，并隐含
--local。
说明
--local不能与--url、--token或--password组合使用。tui会在可能时解析已配置的 Gateway 网关认证 SecretRefs，用于令牌/密码认证 （env/file/exec提供商）。- 如果没有显式 URL 或端口，
tui会跟随正在运行的 Gateway 网关记录的活动本地 Gateway 网关端口。 显式--url、OPENCLAW_GATEWAY_URL、OPENCLAW_GATEWAY_PORT和远程 Gateway 网关配置保持优先级。 - 从已配置的智能体工作区目录内启动时，TUI 会自动选择
该智能体作为会话键默认值（除非
--session显式为agent:<id>:...）。 - 若要在页脚中为非本地 URL 支持的连接显示 Gateway 网关主机名，
请运行
openclaw config set tui.footer.showRemoteHost true。默认关闭； 对 local loopback 或嵌入式本地连接绝不显示。 - 本地模式直接使用嵌入式智能体运行时。大多数本地工具可用， 但仅 Gateway 网关支持的功能不可用。
- 本地模式会向 TUI 命令界面添加
/auth [provider]。 - 插件审批门禁在本地模式下仍然适用：需要审批的工具 会在终端中提示决策，不会静默自动批准任何内容。
- 会话目标会显示在页脚中，并可通过
/goal管理。
示例
配置修复循环
使用本地模式让嵌入式智能体检查当前配置，将其与文档对比， 并从同一个终端帮助修复它。 如果openclaw config validate 已经失败，请先运行 openclaw configure 或
openclaw doctor --fix；openclaw chat 不会绕过
无效配置保护。
openclaw config set 或 openclaw configure 应用定向修复，然后
重新运行 openclaw config validate。请参阅 TUI 和
配置。