Remote Control

这页在教你怎么用苹果电脑遥控另一台电脑。另一台电脑我们叫它“远程主机”，它可能在你家里，也可能在办公室。遥控成功后，你的苹果电脑上就能看到那台远程主机的状态，还能和它聊天呢！

首先，我们要在远程主机上准备一下。 就像请朋友来家里玩，得先把家里收拾好。你需要在那台远程电脑上做三件事：

1. 安装 OpenClaw。 这就像给那台电脑安装一个“大脑”。你需要先安装 Node 和 pnpm（你可以把它们想成是安装玩具需要的工具箱），然后用工具箱里的工具把 OpenClaw 这个“大脑”装好。
2. 让“大脑”随时能找到。 装好后，要确保在任何地方都能叫到它。有时候需要你手动创建一个“快捷方式”（symlink），把它放到像 /usr/local/bin 这样的“公共电话簿”里。
3. 打开一扇安全的门（SSH）。 我们需要一扇只有你有钥匙才能进的门，这样才安全。我们推荐用 Tailscale 这个工具来帮你找到那台电脑的稳定地址，这样就算不在同一个Wi-Fi下也能找到它。

然后，我们在苹果电脑的软件里设置遥控。 现在回到你的苹果电脑，打开 OpenClaw 软件。

1. 打开 Settings（设置） -> General（通用）。
2. 在 OpenClaw runs 这里，选择 Remote over SSH（通过SSH远程运行）。然后你会看到几个选项需要填写：
   • Transport（传输方式）：选 SSH tunnel（SSH隧道） 或者 Direct (ws/wss)（直连）。隧道就像挖一条秘密通道，直连就像直接打电话。
   • SSH target（SSH目标）：填写 用户名@电脑地址，比如 xiaoming@192.168.1.100。如果两台电脑在同一个Wi-Fi下，软件可能会自动发现并帮你填好。
   • Gateway URL（网关地址）：只有选“直连”时才需要填。比如 wss://gateway.example.ts.net。
   • 其他像 Identity file（钥匙文件）、Project root（项目根目录）、CLI path（CLI路径） 这些是高级选项，刚开始可以不用管。
3. 点击 Test remote（测试远程连接）。如果成功了，就说明你的苹果电脑已经能和远程电脑上的“大脑”打招呼了！如果失败了，最常见的问题是“大脑”没在“公共电话簿”里（PATH不对）。
4. 测试成功后，健康检查和网页聊天这些功能就会自动通过这个连接来工作了。

需要注意的一些重要事情：

• 权限：远程主机上的“大脑”也需要获得和你本地电脑一样的权限，比如控制鼠标、使用麦克风等。你需要在远程主机上也运行一次设置流程来批准这些权限。
• 安全提醒：为了安全，最好让远程主机上的服务只监听本地（loopback），然后通过SSH或Tailscale连接。如果用SSH隧道，第一次连接时要确认主机的“指纹”，这样它就会被记在你的“信任名单”（~/.ssh/known_hosts）里。
• 登录WhatsApp：如果你想遥控的电脑要登录WhatsApp，你必须在那台远程主机上运行 openclaw channels login --verbose 命令，然后用手机扫码。如果登录失效了，也需要在远程主机上重新登录。
• 常见问题：
  • 如果测试时提示“exit 127”或“not found”，说明远程主机上找不到 openclaw 命令，检查一下“公共电话簿”（PATH）的设置。
  • 如果健康检查失败，检查SSH能不能连通，PATH对不对，以及WhatsApp（Baileys）是否已经登录。
  • 如果网页聊天卡住了，确认远程主机上的网关服务在运行，并且苹果电脑上转发的端口号是对的。
  • 如果你看到节点的IP地址是 127.0.0.1，别担心，这是使用SSH隧道时的正常现象。如果你想让网关看到真实的客户端IP，可以把传输方式改成直连。