远程控制

此流程让 macOS 应用充当在另一台主机（桌面/服务器）上运行的 OpenClaw 网关的完整远程控制。这是应用的通过 SSH 远程（远程运行）功能。所有功能——健康检查、语音唤醒转发和 Web 聊天——重用来自 设置 → 常规 的相同远程 SSH 配置。

- 本地（此 Mac）：所有内容都在笔记本电脑上运行。不涉及 SSH。

- ''通过 SSH 远程（默认）''：OpenClaw 命令在远程主机上执行。Mac 应用使用 ''-o BatchMode'' 加上您选择的身份/密钥和本地端口转发打开 SSH 连接。

- 远程直接（ws/wss）：没有 SSH 隧道。Mac 应用直接连接到网关 URL（例如，通过 Tailscale Serve 或公共 HTTPS 反向代理）。

远程模式支持两种传输：

- ''SSH 隧道''（默认）：使用 ''ssh -N -L ...'' 将网关端口转发到本地主机。由于隧道是回环，网关将看到节点的 IP 为 ''127.0.0.1''。

- 直接（ws/wss）：直接连接到网关 URL。网关看到真实的客户端 IP。

1. 安装 Node + pnpm 并构建/安装 OpenClaw CLI（''pnpm install && pnpm build && pnpm link --global''）。

2. 确保 ''openclaw'' 在非交互式 shell 的 PATH 中（如果需要，符号链接到 ''/usr/local/bin'' 或 ''/opt/homebrew/bin''）。

3. 使用密钥身份验证打开 SSH。我们推荐 Tailscale IP 以实现稳定的局域网外可达性。

1. 打开 设置 → 常规。

2. 在 OpenClaw 运行 下，选择 通过 SSH 远程 并设置：

- 传输：SSH 隧道 或 直接（ws/wss）。

- ''SSH 目标''：''user@host''（可选 '':port''）。

- 如果网关在同一局域网上并广播 Bonjour，请从发现的列表中选择它以自动填充此字段。

- ''网关 URL''（仅直接）：''wss://gateway.example.ts.net''（或 ''ws://...'' 用于本地/局域网）。

- 身份文件（高级）：您的密钥的路径。

- 项目根目录（高级）：用于命令的远程检出路径。

- ''CLI 路径''（高级）：可运行的 ''openclaw'' 入口点/二进制文件的可选路径（广播时自动填充）。

3. 点击 ''测试远程''。成功表示远程 ''openclaw status --json'' 正确运行。失败通常意味着 PATH/CLI 问题；退出 127 意味着远程找不到 CLI。

4. 健康检查和 Web 聊天现在将通过此 SSH 隧道自动运行。

- SSH 隧道：Web 聊天通过转发的 WebSocket 控制端口（默认 18789）连接到网关。

- 直接（ws/wss）：Web 聊天直接连接到配置的网关 URL。

- 不再有单独的 WebChat HTTP 服务器。

- 远程主机需要与本地相同的 TCC 批准（自动化、辅助功能、屏幕录制、麦克风、语音识别、通知）。在该机器上运行入门程序以一次性授予权限。

- 节点通过 ''node.list'' / ''node.describe'' 广播其权限状态，以便代理知道可用的内容。

- 优先在远程主机上使用回环绑定，并通过 SSH 或 Tailscale 连接。

- 如果您将网关绑定到非回环接口，则需要令牌/密码身份验证。

- 请参阅 ''安全'' 和 ''Tailscale''。

- 在''远程主机''上运行 ''openclaw channels login --verbose''。使用手机上的 WhatsApp 扫描二维码。

- 如果身份验证过期，请在该主机上重新运行登录。健康检查将显示链接问题。

- ''退出 127 / 未找到''：''openclaw'' 不在非登录 shell 的 PATH 中。将其添加到 ''/etc/paths''、您的 shell rc，或符号链接到 ''/usr/local/bin''/''/opt/homebrew/bin''。

- ''健康探测失败''：检查 SSH 可达性、PATH，以及 Baileys 是否已登录（''openclaw status --json''）。

- Web 聊天卡住：确认网关在远程主机上运行，并且转发的端口与网关 WS 端口匹配；UI 需要健康的 WS 连接。

- 节点 IP 显示 127.0.0.1：这是 SSH 隧道的预期行为。如果您希望网关看到真实的客户端 IP，请将传输切换到直接（ws/wss）。

- 语音唤醒：触发短语在远程模式下自动转发；不需要单独的转发器。

从带有 ''openclaw'' 和 ''node.invoke'' 的脚本中为每个通知选择声音，例如：

openclaw nodes notify --node '<id>' --title "Ping" --body "Remote gateway ready" --sound Glass

应用中不再有全局的"默认声音"切换；调用者根据请求选择声音（或无声音）。