openclaw tui
打开连接到 Gateway 的终端 UI，或以本地嵌入式模式运行。
target 可以是 Control UI 会话 URL、简写的 host/agent/ref、类似 movies-a1166b81 的裸短引用，或字面量 agent:... 会话密钥。
URL 或主机目标会权威地选择对应的 Gateway；裸引用则使用已配置的或默认的 Gateway。你也可以直接将 Control UI URL 粘贴为 openclaw <url>，并将 TUI 选项放在其后，例如
openclaw <url> --token <token> --deliver。
裸 URL 形式接受 --token、--password、--tls-fingerprint、--deliver、--thinking、--message、--timeout-ms 和 --history-limit。
当你需要使用其他 TUI 选项时，请使用 openclaw tui <url>；--local、--url 和 --session 不能与会话 URL 同时使用。
相关指南：TUI
选项
别名：
openclaw chat 和 openclaw terminal 会以
隐含的 --local 调用此命令。
说明
--local不能与--url、--token、--password或--tls-fingerprint结合使用。- 只能传入一个 Gateway 目标。URL 目标不能与
--url结合使用，任何位置目标都不能与--session或本地模式结合使用。 - URL 或主机目标不会重新使用已配置的凭据或
OPENCLAW_GATEWAY_TOKEN/OPENCLAW_GATEWAY_PASSWORD。它会使用该确切 Gateway origin 的已存储设备令牌，或显式传入的--token/--password凭据。首次连接时，传入其中一个凭据，在该 Gateway 的 Control UI 中批准配对请求，然后重试；请参阅设备。 - Session URL 必须保持无凭据状态。用户信息以及
token和password等敏感查询参数或片段参数会被拒绝。 - 短引用会通过 Gateway 解析。如果短引用存在歧义，CLI 会打印候选名称和更长的 ID 前缀，但不会连接到任何会话。
- 在没有 URL／主机目标或显式
--url的情况下，tui会在可能时解析已配置的 Gateway 身份验证 SecretRefs，以用于令牌／密码身份验证（env／file／exec／store提供程序）。 - 在没有显式 URL 或端口的情况下，
tui会遵循运行中 Gateway 记录的活动本地 Gateway 端口。显式--url、OPENCLAW_GATEWAY_URL、OPENCLAW_GATEWAY_PORT和远程 Gateway 配置具有更高优先级。 - 从已配置的 agent 工作区目录内部启动时，TUI 会自动为会话键默认值选择该 agent（除非显式使用
agent:<id>:...形式的--session）。 - 本地模式直接使用内嵌 agent 运行时。大多数本地工具都可用，但仅限 Gateway 的功能不可用。
- 本地模式要求独占拥有已配置的状态目录。当 Gateway 或其他内嵌写入程序拥有该状态时，它会拒绝启动；不使用
--local以使用活动 Gateway，或先使用openclaw gateway stop停止它。 - 本地模式会将
/auth [provider]添加到 TUI 命令界面。 - 插件批准门控在本地模式下仍然适用：需要批准的工具会在终端中提示进行决策，不会静默自动批准。
- 会话目标会显示在页脚中，并可使用
/goal进行管理。
会话目标错误
示例
配置修复循环
使用本地模式，让嵌入式代理检查当前配置，将其与文档进行比较，并帮助在同一个终端中修复它。 如果openclaw config validate 已经失败，请先运行 openclaw configure 或
openclaw doctor --fix；openclaw chat 不会绕过
无效配置保护。
openclaw config set 或 openclaw configure 应用有针对性的修复，然后
重新运行 openclaw config validate。参见 TUI 和
Config。