← 返回 Skills 市场
matthewxmurphy

Macos Bridge

作者 Matthew Murphy · GitHub ↗ · v0.6.2 · MIT-0
cross-platform ✓ 安全检测通过
440
总下载
0
收藏
1
当前安装
4
版本数
在 OpenClaw 中安装
/install macos-bridge
功能描述
Bridge Mac-owned tools like imsg, remindctl, memo, things, and peekaboo onto a Linux OpenClaw gateway by installing explicit same-LAN SSH wrappers with optio...
使用说明 (SKILL.md)

macOS Bridge

Use this skill when a Linux OpenClaw gateway should expose Mac-owned tools as stable Linux-side commands.

This skill is for tools that are inherently macOS-backed:

  • imsg
  • remindctl
  • memo
  • things
  • peekaboo

It does not try to make Linux pretend those binaries are native. It installs explicit Linux-side wrappers that call the owning Mac over SSH.

If the matching feature is disabled in openclaw.json, do not force the bridge.

If the feature is enabled and Linux already has a working local binary, that is also acceptable. Use this skill when the enabled feature needs the Mac-owned implementation.

Use This Skill For

  • same-LAN Linux gateway to Mac node setups
  • Mac-owned tools with macOS permissions or data access
  • wrapper-backed public skills that should stay truthful on Linux
  • enabled-channel auto-selection from channels.*.enabled
  • remoteHost auto-discovery from an existing OpenClaw config
  • optional Wake-on-LAN recovery when a Mac sleeps

Do Not Use This Skill For

  • Homebrew-centric Linux augmentation where the main goal is exposing /opt/homebrew/bin tools in general
  • Linux-native tools that should be installed locally
  • patching OpenClaw internals so macOS-only tools show as green on Linux
  • WAN-routed or untrusted remote Macs

Requirements

  • Linux gateway and Mac nodes share the same trusted local network or VLAN
  • Linux gateway can SSH to the owning Mac node
  • remote binaries exist and already have the needed macOS permissions
  • Macs stay awake for work windows or support Wake-on-LAN if you expect remote resume

Workflow

1. Render A Tool Ownership Map

Run:

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

If the OpenClaw config already contains enabled macOS-backed channels, this prints an auto-discovered map for enabled tools first.

2. Install The macOS Pack

Example:

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

When no --tool or --map arguments are provided, the installer now auto-selects only the supported tools whose channels are enabled in the OpenClaw config.

The installer resolves hosts in this order:

  • explicit --map tool=user@host
  • matching remoteHost in the OpenClaw config
  • --default-host user@host
  • the single discovered Mac host if only one unique remoteHost exists
  • no repeated host questions when the OpenClaw config already resolves the owner

3. Verify The Pack

Run:

scripts/verify-macos-pack.sh \
  --target-dir /home/node/.openclaw/bin \
  --openclaw-config /home/node/.openclaw/openclaw.json

When --openclaw-config is provided, verification only checks enabled macOS-backed features instead of treating every supported tool as required.

Design Contract

  • Linux holds the wrapper paths
  • macOS holds the real binaries and OS permissions
  • published skills depend on wrapper paths, not remote binary paths
  • tool ownership stays explicit and auditable

Files

  • scripts/install-wrapper.sh: create one SSH wrapper for a remote binary
  • scripts/install-macos-pack.sh: install a batch of macOS-owned tool wrappers with auto-discovery and optional Wake-on-LAN
  • scripts/verify-macos-pack.sh: verify the installed wrapper pack
  • scripts/render-tool-map.sh: print auto-discovered or fallback ownership maps
  • references/skill-readiness.md: publishability rules for wrapper-backed skills
安全使用建议
This skill appears coherent for its stated purpose, but review and consider the following before installing: ensure the target Linux gateway and Macs are on a trusted LAN (the wrappers will SSH to the Macs and may send Wake-on-LAN broadcast packets); provide explicit --ssh-key and --known-hosts or verify SSH host keys to avoid MITM risks; inspect the generated wrapper scripts in the chosen target directory before making them executable (they run remote binaries via SSH); confirm the remote macOS binaries exist and have appropriate permissions; and be aware the skill requires python3 for OpenClaw config parsing and Wake-on-LAN support. If you do not trust the network or the remote hosts, do not use this bridge.
功能分析
Type: OpenClaw Skill Name: macos-bridge Version: 0.6.2 The macOS-bridge skill bundle provides a legitimate utility for Linux gateways to execute macOS-specific tools (like iMessage or Reminders) on a remote Mac via SSH wrappers. The implementation in 'scripts/install-wrapper.sh' and 'scripts/install-macos-pack.sh' uses proper shell escaping (printf %q) to mitigate command injection risks and includes a standard Python-based Wake-on-LAN implementation. No evidence of data exfiltration, unauthorized persistence, or malicious prompt injection was found; the code remains strictly aligned with its stated purpose of cross-platform tool bridging.
能力评估
✓ Purpose & Capability
The name/description match the shipped scripts and SKILL.md. The bundle only needs SSH reachability, an OpenClaw config for auto-discovery, and (optionally) Wake-on-LAN mapping — all appropriate for bridging macOS tools to Linux wrappers.
✓ Instruction Scope
Runtime instructions and scripts only read the provided OpenClaw config (or $HOME/.openclaw/openclaw.json), create local wrapper scripts in the target dir, invoke SSH to the discovered Mac hosts, and optionally send Wake-on-LAN UDP broadcasts on the local network. They do not call external web endpoints or request unrelated system files or environment secrets.
✓ Install Mechanism
This is instruction-only (no package manager downloads). All code is included in the skill bundle (bash scripts and small Python snippets) and nothing is fetched from arbitrary URLs or remote servers during install.
✓ Credentials
The skill does not declare required env vars or credentials. It accepts optional SSH key and known_hosts file paths as arguments (reasonable for SSH use). There are no unexplained SECRET/TOKEN requirements.
✓ Persistence & Privilege
always:false and no attempt to modify other skills or global agent settings. The scripts write wrappers only to the user-specified target directory and do not request persistent elevated privileges.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install macos-bridge
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /macos-bridge 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v0.6.2
macos-bridge 0.6.2 - Improved auto-discovery by selecting only enabled macOS-backed tools via `channels.*.enabled` in OpenClaw config. - `install-macos-pack.sh` now installs wrappers only for enabled tools when no tools are listed explicitly. - `verify-macos-pack.sh` checks only enabled features when OpenClaw config is provided, no longer requiring all supported tools by default. - Updated documentation to clarify enabled-channel auto-selection and fallback behavior.
v0.6.1
Patch wrapper forwarding refresh and ClawHub-managed bridge install.
v0.6.0
# macos-bridge 0.6.0 - Added ClawHub card emoji metadata. - No behavior change; this is a presentation and registry metadata update.
v0.5.0
# macos-bridge 0.5.0 - First public release. - Adds same-LAN wrapper installation for macOS-backed tools such as `imsg`, `remindctl`, `memo`, `things`, and `peekaboo`. - Includes optional Wake-on-LAN support and OpenClaw config auto-discovery.
元数据
Slug macos-bridge
版本 0.6.2
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 4
常见问题

Macos Bridge 是什么？

Bridge Mac-owned tools like imsg, remindctl, memo, things, and peekaboo onto a Linux OpenClaw gateway by installing explicit same-LAN SSH wrappers with optio... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 440 次。

如何安装 Macos Bridge？

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

Macos Bridge 是免费的吗？

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

Macos Bridge 支持哪些平台？

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

谁开发了 Macos Bridge？

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

推荐 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.
⬇ 191113 · 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

💬 留言讨论