macOS App

这个苹果电脑上的小助手，就像一个住在你电脑菜单栏里的好朋友。它的主要工作是：

1. 在菜单栏里显示通知和状态。
2. 帮智能助手申请使用电脑各种功能的“门票”（比如发通知、控制屏幕、用麦克风等）。
3. 启动或连接到一个叫“网关”的控制中心。
4. 让智能助手能用一些苹果电脑才有的工具，比如画画板、摄像头、录屏和运行系统命令。
5. 可以安装一个叫 openclaw 的全局命令，让你在终端里也能用它。

这个小助手有两种工作模式，就像选择在家玩还是去朋友家玩：

• 本地模式（默认）：它会在你的电脑上找一个正在运行的“网关”一起玩。如果没找到，它会帮你安装并启动一个。
• 远程模式：它会通过 SSH 或 Tailscale 连接到另一台电脑上的“网关”，但不会在你电脑上启动“网关”进程。它会启动一个本地服务，让远程的“网关”能找到你的电脑。

怎么启动和安装它呢？

1. 首先，安装并打开 OpenClaw.app。
2. 然后，它会弹出一系列请求“许可”的窗口，你需要一个个点“允许”，就像给朋友开门一样。
3. 确保你用的是本地模式，并且“网关”正在运行。
4. 如果你也想在终端里用，可以安装 CLI 命令行工具。

要小心的事情：

• 这个小助手会用到一个叫 launchd 的系统服务来保持运行。你可以用 launchctl 命令来管理它，但通常不需要你手动操作。
• 它有一个很重要的功能叫 system.run，可以让智能助手运行电脑命令。为了安全，你可以在小助手的“设置 -> 执行批准”里管理哪些命令可以运行。这里要小心，不要随便允许不认识的命令。
• 你的 OpenClaw 数据和设置文件，最好不要放在 iCloud 或其他会自动同步的云盘文件夹里，不然可能会变慢或出问题。最好放在 ~/.openclaw 这样的本地文件夹。
• 这个小助手还注册了一个 openclaw:// 的链接协议。你可以用浏览器打开像 openclaw://agent?message=你好 这样的链接来直接给智能助手发消息。不过，如果没有设置安全密钥，它会先弹窗问你确不确定，而且消息不能太长。

如果你想连接远程的“网关”： 在远程模式下，小助手会通过 SSH 建立一个“隧道”，就像挖一条秘密通道，让你的电脑能和远程的“网关”安全地聊天。具体怎么设置，可以去看另一页叫“macOS 远程访问”的说明书。

给开发者看的部分： 如果你想自己编译或开发这个应用，可以用 swift build 和 swift run 这些命令。如果想测试连接“网关”的逻辑，可以用 swift run openclaw-mac connect 这样的调试命令。