Wiki AI

macOS 远程控制

3分钟阅读

概述

macOS 应用支持通过 SSH 远程控制运行在其他主机上的 OpenClaw Gateway。健康检查、Voice Wake 转发和 Web Chat 均复用 Settings → General 中的同一 SSH 配置。

运行模式

模式说明
本地（此 Mac）一切在本机运行，无 SSH
远程 SSH（默认）通过 SSH 隧道连接，Gateway 看到节点 IP 为 127.0.0.1
远程直连（ws/wss）直接连接 Gateway URL，Gateway 看到真实客户端 IP

远程主机前置条件

# 1. 安装 Node + pnpm，构建/安装 CLI
pnpm install && pnpm build && pnpm link --global
 
# 2. 确保 openclaw 在非交互式 shell 的 PATH 中
# 可软链到 /usr/local/bin 或 /opt/homebrew/bin
 
# 3. 开启 SSH 密钥认证（推荐 Tailscale IP 保证稳定可达性）

macOS 应用配置

  1. 打开 Settings → General
  2. 在 OpenClaw runs 下选择 Remote over SSH，设置：
    • Transport：SSH tunnel 或 Direct (ws/wss)
    • SSH target：user@host（可选 :port）
    • Gateway URL（仅 Direct 模式）：wss://gateway.example.ts.net
  3. 点击 Test remote 验证（失败通常是 PATH/CLI 问题；exit 127 表示 CLI 未找到）

Web Chat

  • SSH tunnel 模式：通过转发的 WebSocket 控制端口（默认 18789）连接
  • Direct 模式：直接连接配置的 Gateway URL

安全建议

  • 远程主机优先使用 loopback 绑定，通过 SSH 或 Tailscale 连接
  • SSH 隧道使用严格主机密钥检查，先信任主机密钥（~/.ssh/known_hosts）
  • 非 loopback 绑定时，要求有效 Gateway 认证（token、password 或 trusted-proxy）

故障排查

  • exit 127 / not found：openclaw 不在非登录 shell 的 PATH 中，软链到 /usr/local/bin
  • Health probe failed：检查 SSH 可达性、PATH 和 Baileys 登录状态
  • Web Chat 卡住：确认远程 Gateway 运行中，转发端口与 Gateway WS 端口匹配
  • Node IP 显示 127.0.0.1：SSH 隧道的预期行为，切换到 Direct 模式可获取真实 IP
  • Mac 能力离线：检查菜单栏设备区域，确认 Mac 是否 paired · disconnected

相关链接

关系图谱

反向链接