核心用法
Homebrew Bridge 是一套用于 Linux OpenClaw 网关的 SSH 封装方案，核心目标是将 Mac 节点上的 /opt/homebrew/bin 工具链（如 brew、gh、claude 等）暴露给 Linux 环境使用。通过生成轻量级 SSH 转发脚本，Linux 端可以像调用本地命令一样透明地执行远程 Mac 上的 Homebrew CLI。
部署流程三步：
1. 渲染工具归属映射 — 通过 render-tool-map.sh 解析 OpenClaw 配置，推断或回退确定每个工具的 Mac 宿主。
2. 安装封装包 — install-homebrew-pack.sh 批量创建 SSH 转发脚本，支持显式主机映射、默认主机、以及单 Mac 场景下的配置自发现；可选集成 Wake-on-LAN，在调用前自动唤醒休眠的 Mac。
3. 验证封装包 — verify-homebrew-pack.sh 检查 wrapper 路径与可执行性。
显著优点
- 零侵入 Mac 端：仅需 SSH 可达，无需在 Mac 安装代理或守护进程。
- 配置灵活性高：支持显式
--map、默认主机、OpenClaw 配置单主机自发现三级回退，减少重复交互。 - 节能友好：Wake-on-LAN 集成允许 Mac 休眠，按需唤醒，适合家庭/工作室环境。
- 职责边界清晰：Linux 端持有稳定 wrapper 路径，Mac 端持有真实二进制；公共技能依赖 wrapper，不硬编码远程路径。
潜在缺点与局限性
- 网络耦合：严格依赖同 LAN/VLAN，跨 WAN 或 NAT 场景不适用。
- 延迟开销：每次调用需建立 SSH 会话，高频短命令场景下延迟明显（毫秒级 SSH 握手累积）。
- 单点可用性：若 Mac 离线或 SSH 不可达，工具链即失效；wrapper 本身无容错或 fallback 机制。
- 权限与状态隔离：远程执行环境受 SSH 登录 shell 限制，与 Mac 本地 GUI session 的权限、环境变量、钥匙串访问可能不一致。
- Wake-on-LAN 非百分百可靠：依赖网络广播可达、Mac 硬件支持及 BIOS/EFI 配置，部分网络设备会过滤 WoL 魔术包。
适合人群
- 拥有异构 homelab 的用户（Linux 网关 + Mac 工作站/mini）。
- 希望将 Mac 作为「Homebrew 后端节点」，为轻量级 Linux 设备（如 Pi、NAS、边缘网关）提供 CLI 能力的开发者。
- 已在使用 OpenClaw 配置体系、希望减少重复 host 询问的自动化运维者。
常规风险
- SSH 密钥管理：wrapper 脚本需以特定用户身份 SSH 到 Mac，私钥泄露或配置不当可导致未授权访问。
- 路径注入：若
--target-dir目录权限过宽，本地恶意进程可能替换 wrapper 脚本。 - 命令解析歧义：远程 shell 引号转义、参数含空格或特殊字符时，wrapper 需确保正确传递；本 skill 未展示详尽的引号处理实现，存在潜在边缘 case。
- WoL 竞争条件：并发调用同一休眠 Mac 时，多个 wrapper 可能同时触发唤醒，虽无害但造成网络冗余流量。
- Mac 端资源耗尽：高频调用可能堆积 SSH 会话，若 Mac 未配置
MaxSessions或存在 ulimit，可能触发拒绝服务。