← 返回 Skills 市场
matthewxmurphy

Homebrew Bridge

作者 Matthew Murphy · GitHub ↗ · v0.6.1 · MIT-0
cross-platform ⚠ suspicious
406
总下载
0
收藏
1
当前安装
3
版本数
在 OpenClaw 中安装
/install homebrew-bridge
功能描述
Expose Mac Homebrew tools like brew, gh, and other /opt/homebrew/bin CLIs on a Linux OpenClaw gateway by installing explicit same-LAN SSH wrappers with optio...
使用说明 (SKILL.md)

Homebrew Bridge

Use this skill when the real value is giving a Linux OpenClaw gateway access to a Mac node's Homebrew toolchain.

This skill is for /opt/homebrew/bin/\x3Ctool> wrappers such as:

  • brew
  • gh
  • other Homebrew-installed CLIs you want to expose from a Mac node

Use This Skill For

  • Linux gateways that should run Homebrew-backed tools through a Mac node
  • wrapper-backed skills that depend on brew, gh, or another Homebrew CLI
  • same-LAN Mac nodes that already hold the real Homebrew installs
  • optional host auto-discovery from OpenClaw config when only one Mac owner is known

Do Not Use This Skill For

  • tools that are inherently Mac-owned apps or permissioned CLIs like imsg or remindctl
  • Linux-native tools that should be installed on Linux directly
  • WAN-routed Macs or generic remote shell access

Requirements

  • Linux gateway and owning Mac share the same trusted local network or VLAN
  • Linux gateway can SSH to the owning Mac
  • the requested tool exists at /opt/homebrew/bin/\x3Ctool> on that Mac
  • the Mac stays awake during work windows or supports Wake-on-LAN

Workflow

1. Render A Tool Ownership Map

Run:

scripts/render-tool-map.sh /home/node/.openclaw/openclaw.json

This prints the inferred or fallback Mac owner for Homebrew-backed tools.

2. Install The Homebrew Pack

Example:

scripts/install-homebrew-pack.sh \
  --target-dir /home/node/.openclaw/bin \
  --tool brew \
  --tool gh \
  --tool claude \
  --default-host [email protected] \
  --wake-map mac-node.local=AA:BB:CC:DD:EE:FF \
  --wake-wait 20 \
  --wake-retries 2

Host resolution order:

  • explicit --map tool=user@host
  • --default-host user@host
  • the single discovered remoteHost in the OpenClaw config, if there is exactly one
  • no repeated host questions when the OpenClaw config already resolves the owner

3. Verify The Pack

Run:

scripts/verify-homebrew-pack.sh --target-dir /home/node/.openclaw/bin

Design Contract

  • Linux owns the stable wrapper paths
  • the Mac owns the real /opt/homebrew/bin binaries
  • public skills depend on wrapper paths, not Mac paths
  • wrapper names stay explicit per tool

Files

  • scripts/install-wrapper.sh: create one SSH wrapper for a remote binary
  • scripts/install-homebrew-pack.sh: install a batch of Homebrew-backed wrappers
  • scripts/verify-homebrew-pack.sh: verify the installed wrappers
  • scripts/render-tool-map.sh: print inferred or fallback tool-to-host maps
  • references/skill-readiness.md: publishability rules for Homebrew-backed wrappers
安全使用建议
This skill appears to do what it claims, but review and consider the following before installing: - The wrappers will execute commands on the remote Mac as the supplied user@host via SSH. Ensure you only point wrappers at trusted Mac nodes and that the SSH account has the expected privileges. - If you provide an SSH private key or a custom known_hosts file, keep those files secure; the scripts will reference the paths you pass in but do not attempt to hide or encrypt them. - The installer may read your OpenClaw config (~/.openclaw/openclaw.json) for auto-discovery — ensure that file contains only expected remoteHost entries. - Wake-on-LAN sends UDP broadcast packets and requires python3; verify your network policies allow this and that MAC addresses are correct. - The wrappers create executable scripts in the chosen target directory; inspect the generated wrapper script (it is human-readable) before putting it on a production gateway. - Do not use this for WAN/remote hosts or for exposing Mac-only privileged tools; the README already warns against that. If any of the above is unacceptable, do not install or run the scripts; otherwise the package is coherent for the documented use case.
功能分析
Type: OpenClaw Skill Name: homebrew-bridge Version: 0.6.1 The skill bundle facilitates remote command execution by generating executable bash wrappers that tunnel commands to a Mac node via SSH (scripts/install-wrapper.sh). While the logic is transparent and aligned with the stated goal of exposing Homebrew tools to a Linux gateway, the creation of executable scripts and the reliance on SSH for remote execution are high-risk capabilities. The bundle also includes automated host discovery by parsing local OpenClaw configuration files and a Wake-on-LAN feature implemented via Python socket programming (scripts/install-homebrew-pack.sh).
能力评估
✓ Purpose & Capability
The name/description (expose /opt/homebrew/bin tools from a Mac to a Linux gateway) matches the delivered scripts and instructions. The scripts create SSH wrappers, optionally use Wake-on-LAN, and perform OpenClaw config auto-discovery — all coherent with the stated purpose.
✓ Instruction Scope
SKILL.md instructs running the included scripts which read the OpenClaw config (~/.openclaw/openclaw.json) for optional auto-discovery and create wrapper binaries in a specified target directory. The wrappers execute the remote Homebrew binary over SSH and optionally send UDP Wake-on-LAN packets via python3. There are no instructions to read unrelated system files or to send data to unknown external endpoints.
✓ Install Mechanism
This is an instruction-only skill (no network downloads or package installs). The scripts are provided in the bundle and write wrapper files into the user-specified target directory. No remote install URLs or archive extraction steps are present.
✓ Credentials
The skill declares no required environment variables or credentials. The runtime behavior relies on standard local items (SSH access, optional SSH key and known_hosts file if supplied, python3 for WOL, and an OpenClaw config file for discovery). These are proportional to the skill's purpose.
✓ Persistence & Privilege
The skill does not request always:true or elevated platform privileges, and it does not modify other skills or global agent settings. It will create wrapper binaries in the supplied target directory, which is expected behavior for this functionality.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install homebrew-bridge
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /homebrew-bridge 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v0.6.1
Patch wrapper forwarding refresh and ClawHub-managed bridge install.
v0.6.0
# homebrew-bridge 0.6.0 - Added ClawHub card emoji metadata. - No behavior change; this is a presentation and registry metadata update.
v0.5.0
# homebrew-bridge 0.5.0 - First public release. - Adds same-LAN wrapper installation for Mac Homebrew tools exposed to a Linux OpenClaw gateway. - Covers `brew`, `gh`, and other `/opt/homebrew/bin` tools with optional Wake-on-LAN and config auto-discovery.
元数据
Slug homebrew-bridge
版本 0.6.1
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 3
常见问题

Homebrew Bridge 是什么？

Expose Mac Homebrew tools like brew, gh, and other /opt/homebrew/bin CLIs on a Linux OpenClaw gateway by installing explicit same-LAN SSH wrappers with optio... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 406 次。

如何安装 Homebrew Bridge？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install homebrew-bridge」即可一键安装，无需额外配置。

Homebrew Bridge 是免费的吗？

是的，Homebrew Bridge 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Homebrew Bridge 支持哪些平台？

Homebrew Bridge 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Homebrew Bridge？

由 Matthew Murphy（@matthewxmurphy）开发并维护，当前版本 v0.6.1。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论