WebChat

​

WebChat（Gateway 网关 WebSocket UI）

状态：macOS/iOS SwiftUI 聊天 UI 直接与 Gateway 网关 WebSocket 通信。

​

它是什么

• 用于网关的原生聊天 UI（无嵌入式浏览器，无本地静态服务器）。
• 使用与其他渠道相同的会话和路由规则。
• 确定性路由：回复始终返回到 WebChat。

​

快速入门

1. 启动网关。
2. 打开 WebChat UI（macOS/iOS 应用）或控制 UI 聊天选项卡。
3. 确保已配置网关身份验证（默认情况下是必需的，即使在回环上也是如此）。

​

它是如何工作的（行为）

• UI 连接到 Gateway 网关 WebSocket 并使用 chat.history、chat.send 和 chat.inject。
• chat.history 为保持稳定性而受限：Gateway 网关 可能会截断长文本字段、省略繁重的元数据，并用 [chat.history omitted: message too large] 替换超大条目。
• chat.inject 将助手备注直接附加到记录并广播到 UI（不运行代理）。
• 中止的运行可以使部分助手输出在 UI 中保持可见。
• 当存在缓冲输出时，Gateway 网关 会将中止的部分助手文本保存到记录单历史记录中，并用中止元数据标记这些条目。
• 历史记录始终从网关获取（无本地文件监视）。
• 如果无法访问网关，WebChat 将变为只读。

​

控制 UI 代理工具面板

• 控制 UI /agents 工具面板有两个独立的视图：
  • 当前可用 使用 tools.effective(sessionKey=...) 并显示当前 会话在运行时实际可用的内容，包括核心、插件和渠道拥有的工具。
  • 工具配置 使用 tools.catalog 并专注于配置文件、覆盖和 目录语义。
• 运行时可用性是会话范围的。在同一代理上切换会话可能会更改 当前可用 列表。
• 配置编辑器并不暗示运行时可用性；有效访问仍然遵循策略 优先级 (allow/deny，以及每个代理和提供商/渠道的覆盖)。

​

远程使用

• 远程模式通过 SSH/Tailscale 隧道传输网关 WebSocket。
• 您不需要运行单独的 WebChat 服务器。

​

配置参考 (WebChat)

完整配置：Configuration

渠道选项：

• 没有专用的 webchat.* 块。WebChat 使用下面的网关端点 + 身份验证设置。

相关全局选项：

• gateway.port, gateway.bind: WebSocket 主机/端口。
• gateway.auth.mode, gateway.auth.token, gateway.auth.password: WebSocket 身份验证 (令牌/密码)。
• gateway.auth.mode: "trusted-proxy": 用于浏览器客户端的反向代理身份验证 (请参阅 Trusted Proxy Auth)。
• gateway.remote.url, gateway.remote.token, gateway.remote.password: 远程网关目标。
• session.*: 会话存储和主密钥默认值。

---

本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。