核心用法
Homebrew Bridge 是一套SSH包装器方案，用于在Linux OpenClaw网关上暴露Mac节点的Homebrew工具链。核心流程包括：
1. 渲染工具归属映射 —— 通过 render-tool-map.sh 解析OpenClaw配置，推断每个Homebrew工具对应的Mac主机
2. 批量安装包装器 —— 使用 install-homebrew-pack.sh 为指定工具（如brew、gh、claude）创建SSH透明包装脚本，支持多层级主机解析：显式--map → --default-host → OpenClaw配置单Mac自动发现
3. 唤醒与重试机制 —— 可选Wake-on-LAN支持，通过MAC地址唤醒休眠主机，配置等待时间与重试次数
4. 验证安装完整性 —— verify-homebrew-pack.sh 检查包装器路径与可执行性
显著优点
- 零侵入架构：Linux侧仅持有轻量包装脚本，真实二进制始终保留在Mac
/opt/homebrew/bin，符合"Linux管路径、Mac管实现"的设计契约 - 智能主机解析：优先显式配置，回退至OpenClaw配置自动发现，避免重复询问
- 局域网优化：针对同一可信LAN/VLAN场景设计，SSH延迟可控
- 技能链兼容：公开技能可依赖稳定的包装器路径，无需感知底层Mac细节
潜在局限与风险
| 维度 | 说明 |
|------|------|
| **网络依赖** | 完全依赖同LAN可达性，跨WAN或路由隔离场景不适用 |
| **Mac可用性** | 需Mac保持唤醒或支持WoL；工具执行期间Mac不可休眠 |
| **SSH开销** | 每个工具调用均产生SSH会话建立开销，高频调用场景性能受限 |
| **版本漂移** | Mac侧Homebrew更新不会自动同步到Linux侧技能依赖声明 |
| **凭证管理** | SSH密钥需预置在Linux网关，密钥轮转需手动维护 |
适合人群
- 拥有常驻LAN Mac工作站、希望复用其Homebrew生态的Linux网关维护者
- 开发依赖
gh、brew等工具链的OpenClaw技能，但不愿在Linux侧重复安装的用户
常规风险
- 包装器路径与真实Mac路径解耦，若Mac节点离线或SSH配置变更，调用将失败
- Wake-on-LAN依赖目标Mac硬件支持与网络唤醒配置，部分Mac机型或企业网络可能禁用
- 多Mac环境若无显式
--map配置，自动发现可能解析到非预期主机