{"id":206,"date":"2026-03-21T22:47:22","date_gmt":"2026-03-21T14:47:22","guid":{"rendered":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/platforms-macos\/"},"modified":"2026-03-21T23:08:52","modified_gmt":"2026-03-21T15:08:52","slug":"platforms-macos","status":"publish","type":"post","link":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/platforms-macos\/","title":{"rendered":"macOS \u5e94\u7528"},"content":{"rendered":"<h1>macOS \u5e94\u7528<\/h1>\n<h1>OpenClaw macOS \u914d\u5957\u5e94\u7528\uff08\u83dc\u5355\u680f + Gateway \u7f51\u5173\u4ee3\u7406\uff09<\/h1>\n<p>macOS \u5e94\u7528\u662f OpenClaw \u7684<strong>\u83dc\u5355\u680f\u914d\u5957\u5e94\u7528<\/strong>\u3002\u5b83\u62e5\u6709\u6743\u9650\uff0c\u5728\u672c\u5730\u7ba1\u7406\/\u9644\u52a0\u5230 Gateway \u7f51\u5173\uff08launchd \u6216\u624b\u52a8\uff09\uff0c\u5e76\u4f5c\u4e3a\u8282\u70b9\u5411\u667a\u80fd\u4f53\u66b4\u9732 macOS \u529f\u80fd\u3002<\/p>\n<h2>\u529f\u80fd<\/h2>\n<ul>\n<li>\u5728\u83dc\u5355\u680f\u4e2d\u663e\u793a\u539f\u751f\u901a\u77e5\u548c\u72b6\u6001\u3002<\/li>\n<li>\u62e5\u6709 TCC \u63d0\u793a\uff08\u901a\u77e5\u3001\u8f85\u52a9\u529f\u80fd\u3001\u5c4f\u5e55\u5f55\u5236\u3001\u9ea6\u514b\u98ce\u3001\u8bed\u97f3\u8bc6\u522b\u3001\u81ea\u52a8\u5316\/AppleScript\uff09\u3002<\/li>\n<li>\u8fd0\u884c\u6216\u8fde\u63a5\u5230 Gateway \u7f51\u5173\uff08\u672c\u5730\u6216\u8fdc\u7a0b\uff09\u3002<\/li>\n<li>\u66b4\u9732 macOS \u4e13\u7528\u5de5\u5177\uff08Canvas\u3001\u76f8\u673a\u3001\u5c4f\u5e55\u5f55\u5236\u3001<code>system.run<\/code>\uff09\u3002<\/li>\n<li>\u5728<strong>\u8fdc\u7a0b<\/strong>\u6a21\u5f0f\u4e0b\u542f\u52a8\u672c\u5730\u8282\u70b9\u4e3b\u673a\u670d\u52a1\uff08launchd\uff09\uff0c\u5728<strong>\u672c\u5730<\/strong>\u6a21\u5f0f\u4e0b\u505c\u6b62\u5b83\u3002<\/li>\n<li>\u53ef\u9009\u5730\u6258\u7ba1 <strong>PeekabooBridge<\/strong> \u7528\u4e8e UI \u81ea\u52a8\u5316\u3002<\/li>\n<li>\u6839\u636e\u8bf7\u6c42\u901a\u8fc7 npm\/pnpm \u5b89\u88c5\u5168\u5c40 CLI\uff08<code>openclaw<\/code>\uff09\uff08\u4e0d\u5efa\u8bae\u4f7f\u7528 bun \u4f5c\u4e3a Gateway \u7f51\u5173\u8fd0\u884c\u65f6\uff09\u3002<\/li>\n<\/ul>\n<h2>\u672c\u5730 vs \u8fdc\u7a0b\u6a21\u5f0f<\/h2>\n<ul>\n<li><strong>\u672c\u5730<\/strong>\uff08\u9ed8\u8ba4\uff09\uff1a\u5982\u679c\u5b58\u5728\u8fd0\u884c\u4e2d\u7684\u672c\u5730 Gateway \u7f51\u5173\uff0c\u5e94\u7528\u9644\u52a0\u5230\u5b83\uff1b\u5426\u5219\u901a\u8fc7 <code>openclaw gateway install<\/code> \u542f\u7528 launchd \u670d\u52a1\u3002<\/li>\n<li><strong>\u8fdc\u7a0b<\/strong>\uff1a\u5e94\u7528\u901a\u8fc7 SSH\/Tailscale \u8fde\u63a5\u5230 Gateway \u7f51\u5173\uff0c\u4ece\u4e0d\u542f\u52a8\u672c\u5730\u8fdb\u7a0b\u3002<br \/>\n  \u5e94\u7528\u542f\u52a8\u672c\u5730<strong>\u8282\u70b9\u4e3b\u673a\u670d\u52a1<\/strong>\uff0c\u4ee5\u4fbf\u8fdc\u7a0b Gateway \u7f51\u5173\u53ef\u4ee5\u8bbf\u95ee\u6b64 Mac\u3002<br \/>\n  \u5e94\u7528\u4e0d\u4f1a\u5c06 Gateway \u7f51\u5173\u4f5c\u4e3a\u5b50\u8fdb\u7a0b\u751f\u6210\u3002<\/li>\n<\/ul>\n<h2>Launchd \u63a7\u5236<\/h2>\n<p>\u5e94\u7528\u7ba1\u7406\u4e00\u4e2a\u6807\u8bb0\u4e3a <code>bot.molt.gateway<\/code> \u7684\u6bcf\u7528\u6237 LaunchAgent\uff08\u4f7f\u7528 <code>--profile<\/code>\/<code>OPENCLAW_PROFILE<\/code> \u65f6\u4e3a <code>bot.molt.&lt;profile&gt;<\/code>\uff1b\u65e7\u7248 <code>com.openclaw.*<\/code> \u4ecd\u4f1a\u5378\u8f7d\uff09\u3002<\/p>\n<p>&#8220;`bash  theme={&#8220;theme&#8221;:{&#8220;light&#8221;:&#8221;min-light&#8221;,&#8221;dark&#8221;:&#8221;min-dark&#8221;}}<br \/>\nlaunchctl kickstart -k gui\/$UID\/bot.molt.gateway<br \/>\nlaunchctl bootout gui\/$UID\/bot.molt.gateway<\/p>\n<pre><code>\n\u8fd0\u884c\u547d\u540d\u914d\u7f6e\u6587\u4ef6\u65f6\uff0c\u5c06\u6807\u7b7e\u66ff\u6362\u4e3a `bot.molt.&lt;profile&gt;`\u3002\n\n\u5982\u679c LaunchAgent \u672a\u5b89\u88c5\uff0c\u4ece\u5e94\u7528\u4e2d\u542f\u7528\u5b83\u6216\u8fd0\u884c `openclaw gateway install`\u3002\n\n## \u8282\u70b9\u529f\u80fd\uff08mac\uff09\n\nmacOS \u5e94\u7528\u5c06\u81ea\u8eab\u5448\u73b0\u4e3a\u4e00\u4e2a\u8282\u70b9\u3002\u5e38\u7528\u547d\u4ee4\uff1a\n\n* Canvas\uff1a`canvas.present`\u3001`canvas.navigate`\u3001`canvas.eval`\u3001`canvas.snapshot`\u3001`canvas.a2ui.*`\n* \u76f8\u673a\uff1a`camera.snap`\u3001`camera.clip`\n* \u5c4f\u5e55\uff1a`screen.record`\n* \u7cfb\u7edf\uff1a`system.run`\u3001`system.notify`\n\n\u8282\u70b9\u62a5\u544a\u4e00\u4e2a `permissions` \u6620\u5c04\uff0c\u4ee5\u4fbf\u667a\u80fd\u4f53\u53ef\u4ee5\u51b3\u5b9a\u4ec0\u4e48\u662f\u5141\u8bb8\u7684\u3002\n\n\u8282\u70b9\u670d\u52a1 + \u5e94\u7528 IPC\uff1a\n\n* \u5f53\u65e0\u5934\u8282\u70b9\u4e3b\u673a\u670d\u52a1\u8fd0\u884c\u65f6\uff08\u8fdc\u7a0b\u6a21\u5f0f\uff09\uff0c\u5b83\u4f5c\u4e3a\u8282\u70b9\u8fde\u63a5\u5230 Gateway \u7f51\u5173 WS\u3002\n* `system.run` \u5728 macOS \u5e94\u7528\u4e2d\u6267\u884c\uff08UI\/TCC \u4e0a\u4e0b\u6587\uff09\u901a\u8fc7\u672c\u5730 Unix \u5957\u63a5\u5b57\uff1b\u63d0\u793a + \u8f93\u51fa\u4fdd\u7559\u5728\u5e94\u7528\u5185\u3002\n\n\u56fe\u793a\uff08SCI\uff09\uff1a\n\n<\/code><\/pre>\n<p>Gateway -&gt; Node Service (WS)<br \/>\n                 |  IPC (UDS + token + HMAC + TTL)<br \/>\n                 v<br \/>\n             Mac App (UI + TCC + system.run)<\/p>\n<pre><code>\n## Exec \u5ba1\u6279\uff08system.run\uff09\n\n`system.run` \u7531 macOS \u5e94\u7528\u4e2d\u7684 **Exec \u5ba1\u6279**\u63a7\u5236\uff08\u8bbe\u7f6e \u2192 Exec approvals\uff09\u3002\u5b89\u5168 + \u8be2\u95ee + \u5141\u8bb8\u5217\u8868\u672c\u5730\u5b58\u50a8\u5728 Mac \u4e0a\uff1a\n\n<\/code><\/pre>\n<p>~\/.openclaw\/exec-approvals.json<\/p>\n<pre><code>\n\u793a\u4f8b\uff1a\n\n```json  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n{\n  &quot;version&quot;: 1,\n  &quot;defaults&quot;: {\n    &quot;security&quot;: &quot;deny&quot;,\n    &quot;ask&quot;: &quot;on-miss&quot;\n  },\n  &quot;agents&quot;: {\n    &quot;main&quot;: {\n      &quot;security&quot;: &quot;allowlist&quot;,\n      &quot;ask&quot;: &quot;on-miss&quot;,\n      &quot;allowlist&quot;: [{ &quot;pattern&quot;: &quot;\/opt\/homebrew\/bin\/rg&quot; }]\n    }\n  }\n}\n<\/code><\/pre>\n<p>\u6ce8\u610f\u4e8b\u9879\uff1a<\/p>\n<ul>\n<li><code>allowlist<\/code> \u6761\u76ee\u662f\u89e3\u6790\u540e\u4e8c\u8fdb\u5236\u8def\u5f84\u7684 glob \u6a21\u5f0f\u3002<\/li>\n<li>\u5728\u63d0\u793a\u4e2d\u9009\u62e9&#8221;Always Allow&#8221;\u4f1a\u5c06\u8be5\u547d\u4ee4\u6dfb\u52a0\u5230\u5141\u8bb8\u5217\u8868\u3002<\/li>\n<li><code>system.run<\/code> \u73af\u5883\u8986\u76d6\u4f1a\u88ab\u8fc7\u6ee4\uff08\u5220\u9664 <code>PATH<\/code>\u3001<code>DYLD_*<\/code>\u3001<code>LD_*<\/code>\u3001<code>NODE_OPTIONS<\/code>\u3001<code>PYTHON*<\/code>\u3001<code>PERL*<\/code>\u3001<code>RUBYOPT<\/code>\uff09\uff0c\u7136\u540e\u4e0e\u5e94\u7528\u7684\u73af\u5883\u5408\u5e76\u3002<\/li>\n<\/ul>\n<h2>\u6df1\u5ea6\u94fe\u63a5<\/h2>\n<p>\u5e94\u7528\u4e3a\u672c\u5730\u64cd\u4f5c\u6ce8\u518c <code>openclaw:\/\/<\/code> URL \u65b9\u6848\u3002<\/p>\n<h3><code>openclaw:\/\/agent<\/code><\/h3>\n<p>\u89e6\u53d1 Gateway \u7f51\u5173 <code>agent<\/code> \u8bf7\u6c42\u3002<\/p>\n<p>&#8220;`bash  theme={&#8220;theme&#8221;:{&#8220;light&#8221;:&#8221;min-light&#8221;,&#8221;dark&#8221;:&#8221;min-dark&#8221;}}<br \/>\nopen &#8216;openclaw:\/\/agent?message=Hello%20from%20deep%20link&#8217;<\/p>\n<pre><code>\n\u67e5\u8be2\u53c2\u6570\uff1a\n\n* `message`\uff08\u5fc5\u9700\uff09\n* `sessionKey`\uff08\u53ef\u9009\uff09\n* `thinking`\uff08\u53ef\u9009\uff09\n* `deliver` \/ `to` \/ `channel`\uff08\u53ef\u9009\uff09\n* `timeoutSeconds`\uff08\u53ef\u9009\uff09\n* `key`\uff08\u53ef\u9009\u65e0\u4eba\u503c\u5b88\u6a21\u5f0f\u5bc6\u94a5\uff09\n\n\u5b89\u5168\uff1a\n\n* \u6ca1\u6709 `key` \u65f6\uff0c\u5e94\u7528\u4f1a\u63d0\u793a\u786e\u8ba4\u3002\n* \u6709\u6709\u6548\u7684 `key` \u65f6\uff0c\u8fd0\u884c\u662f\u65e0\u4eba\u503c\u5b88\u7684\uff08\u7528\u4e8e\u4e2a\u4eba\u81ea\u52a8\u5316\uff09\u3002\n\n## \u65b0\u624b\u5f15\u5bfc\u6d41\u7a0b\uff08\u5178\u578b\uff09\n\n1. \u5b89\u88c5\u5e76\u542f\u52a8 **OpenClaw.app**\u3002\n2. \u5b8c\u6210\u6743\u9650\u6e05\u5355\uff08TCC \u63d0\u793a\uff09\u3002\n3. \u786e\u4fdd**\u672c\u5730**\u6a21\u5f0f\u5904\u4e8e\u6d3b\u52a8\u72b6\u6001\u4e14 Gateway \u7f51\u5173\u6b63\u5728\u8fd0\u884c\u3002\n4. \u5982\u679c\u4f60\u60f3\u8981\u7ec8\u7aef\u8bbf\u95ee\uff0c\u5b89\u88c5 CLI\u3002\n\n## \u6784\u5efa\u548c\u5f00\u53d1\u5de5\u4f5c\u6d41\u7a0b\uff08\u539f\u751f\uff09\n\n* `cd apps\/macos &amp;&amp; swift build`\n* `swift run OpenClaw`\uff08\u6216 Xcode\uff09\n* \u6253\u5305\u5e94\u7528\uff1a`scripts\/package-mac-app.sh`\n\n## \u8c03\u8bd5 Gateway \u7f51\u5173\u8fde\u63a5\uff08macOS CLI\uff09\n\n\u4f7f\u7528\u8c03\u8bd5 CLI \u6765\u6267\u884c\u4e0e macOS \u5e94\u7528\u4f7f\u7528\u7684\u76f8\u540c\u7684 Gateway \u7f51\u5173 WebSocket \u63e1\u624b\u548c\u53d1\u73b0\u903b\u8f91\uff0c\u800c\u65e0\u9700\u542f\u52a8\u5e94\u7528\u3002\n\n```bash  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\ncd apps\/macos\nswift run openclaw-mac connect --json\nswift run openclaw-mac discover --timeout 3000 --json\n<\/code><\/pre>\n<p>Connect \u9009\u9879\uff1a<\/p>\n<ul>\n<li><code>--url &lt;ws:\/\/host:port&gt;<\/code>\uff1a\u8986\u76d6\u914d\u7f6e<\/li>\n<li><code>--mode &lt;local|remote&gt;<\/code>\uff1a\u4ece\u914d\u7f6e\u89e3\u6790\uff08\u9ed8\u8ba4\uff1a\u914d\u7f6e\u6216 local\uff09<\/li>\n<li><code>--probe<\/code>\uff1a\u5f3a\u5236\u8fdb\u884c\u65b0\u7684\u5065\u5eb7\u63a2\u6d4b<\/li>\n<li><code>--timeout &lt;ms&gt;<\/code>\uff1a\u8bf7\u6c42\u8d85\u65f6\uff08\u9ed8\u8ba4\uff1a<code>15000<\/code>\uff09<\/li>\n<li><code>--json<\/code>\uff1a\u7528\u4e8e\u6bd4\u8f83\u7684\u7ed3\u6784\u5316\u8f93\u51fa<\/li>\n<\/ul>\n<p>Discovery \u9009\u9879\uff1a<\/p>\n<ul>\n<li><code>--include-local<\/code>\uff1a\u5305\u542b\u4f1a\u88ab\u8fc7\u6ee4\u4e3a&#8221;\u672c\u5730&#8221;\u7684 Gateway \u7f51\u5173<\/li>\n<li><code>--timeout &lt;ms&gt;<\/code>\uff1a\u603b\u4f53\u53d1\u73b0\u7a97\u53e3\uff08\u9ed8\u8ba4\uff1a<code>2000<\/code>\uff09<\/li>\n<li><code>--json<\/code>\uff1a\u7528\u4e8e\u6bd4\u8f83\u7684\u7ed3\u6784\u5316\u8f93\u51fa<\/li>\n<\/ul>\n<p>\u63d0\u793a\uff1a\u4e0e <code>openclaw gateway discover --json<\/code> \u6bd4\u8f83\uff0c\u67e5\u770b macOS \u5e94\u7528\u7684\u53d1\u73b0\u7ba1\u9053\uff08NWBrowser + tailnet DNS-SD \u56de\u9000\uff09\u662f\u5426\u4e0e Node CLI \u57fa\u4e8e <code>dns-sd<\/code> \u7684\u53d1\u73b0\u4e0d\u540c\u3002<\/p>\n<h2>\u8fdc\u7a0b\u8fde\u63a5\u7ba1\u9053\uff08SSH \u96a7\u9053\uff09<\/h2>\n<p>\u5f53 macOS \u5e94\u7528\u5728<strong>\u8fdc\u7a0b<\/strong>\u6a21\u5f0f\u4e0b\u8fd0\u884c\u65f6\uff0c\u5b83\u4f1a\u6253\u5f00\u4e00\u4e2a SSH \u96a7\u9053\uff0c\u4ee5\u4fbf\u672c\u5730 UI \u7ec4\u4ef6\u53ef\u4ee5\u50cf\u5728 localhost \u4e0a\u4e00\u6837\u4e0e\u8fdc\u7a0b Gateway \u7f51\u5173\u901a\u4fe1\u3002<\/p>\n<h3>\u63a7\u5236\u96a7\u9053\uff08Gateway \u7f51\u5173 WebSocket \u7aef\u53e3\uff09<\/h3>\n<ul>\n<li>**\u76ee\u7684\uff1a**\u5065\u5eb7\u68c0\u67e5\u3001\u72b6\u6001\u3001Web Chat\u3001\u914d\u7f6e\u548c\u5176\u4ed6\u63a7\u5236\u5e73\u9762\u8c03\u7528\u3002<\/li>\n<li>**\u672c\u5730\u7aef\u53e3\uff1a**Gateway \u7f51\u5173\u7aef\u53e3\uff08\u9ed8\u8ba4 <code>18789<\/code>\uff09\uff0c\u59cb\u7ec8\u7a33\u5b9a\u3002<\/li>\n<li>**\u8fdc\u7a0b\u7aef\u53e3\uff1a**\u8fdc\u7a0b\u4e3b\u673a\u4e0a\u7684\u76f8\u540c Gateway \u7f51\u5173\u7aef\u53e3\u3002<\/li>\n<li>**\u884c\u4e3a\uff1a**\u65e0\u968f\u673a\u672c\u5730\u7aef\u53e3\uff1b\u5e94\u7528\u590d\u7528\u73b0\u6709\u7684\u5065\u5eb7\u96a7\u9053\u6216\u5728\u9700\u8981\u65f6\u91cd\u542f\u5b83\u3002<\/li>\n<li><strong>SSH \u5f62\u5f0f\uff1a<\/strong><code>ssh -N -L &lt;local&gt;:127.0.0.1:&lt;remote&gt;<\/code>\uff0c\u5e26\u6709 BatchMode + ExitOnForwardFailure + keepalive \u9009\u9879\u3002<\/li>\n<li>**IP \u62a5\u544a\uff1a**SSH \u96a7\u9053\u4f7f\u7528 loopback\uff0c\u56e0\u6b64 Gateway \u7f51\u5173\u5c06\u770b\u5230\u8282\u70b9 IP \u4e3a <code>127.0.0.1<\/code>\u3002\u5982\u679c\u4f60\u60f3\u8981\u663e\u793a\u771f\u5b9e\u7684\u5ba2\u6237\u7aef IP\uff0c\u8bf7\u4f7f\u7528 <strong>Direct (ws\/wss)<\/strong> \u4f20\u8f93\uff08\u53c2\u89c1 <a href=\"\/platforms\/mac\/remote\">macOS \u8fdc\u7a0b\u8bbf\u95ee<\/a>\uff09\u3002<\/li>\n<\/ul>\n<p>\u6709\u5173\u8bbe\u7f6e\u6b65\u9aa4\uff0c\u8bf7\u53c2\u9605 <a href=\"\/platforms\/mac\/remote\">macOS \u8fdc\u7a0b\u8bbf\u95ee<\/a>\u3002\u6709\u5173\u534f\u8bae\u8be6\u60c5\uff0c\u8bf7\u53c2\u9605 <a href=\"\/gateway\/protocol\">Gateway \u7f51\u5173\u534f\u8bae<\/a>\u3002<\/p>\n<h2>\u76f8\u5173\u6587\u6863<\/h2>\n<ul>\n<li><a href=\"\/gateway\">Gateway \u7f51\u5173\u8fd0\u7ef4\u624b\u518c<\/a><\/li>\n<li><a href=\"\/platforms\/mac\/bundled-gateway\">Gateway \u7f51\u5173\uff08macOS\uff09<\/a><\/li>\n<li><a href=\"\/platforms\/mac\/permissions\">macOS \u6743\u9650<\/a><\/li>\n<li><a href=\"\/platforms\/mac\/canvas\">Canvas<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>macOS \u5e94\u7528 OpenClaw macOS \u914d\u5957\u5e94\u7528\uff08\u83dc\u5355\u680f + Gateway \u7f51\u5173\u4ee3\u7406\uff09 macOS  [&hellip;]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-206","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/206","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=206"}],"version-history":[{"count":1,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/206\/revisions"}],"predecessor-version":[{"id":501,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/206\/revisions\/501"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=206"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=206"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=206"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}