← Back to Skills Marketplace
matthewxmurphy

Macos Bridge

by Matthew Murphy · GitHub ↗ · v0.6.2 · MIT-0
cross-platform ✓ Security Clean
440
Downloads
0
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install macos-bridge
Description
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...
README (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
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
✓ 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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install macos-bridge
  3. After installation, invoke the skill by name or use /macos-bridge
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug macos-bridge
Version 0.6.2
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 4
Frequently Asked Questions

What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 440 downloads so far.

How do I install Macos Bridge?

Run "/install macos-bridge" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Macos Bridge free?

Yes, Macos Bridge is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Macos Bridge support?

Macos Bridge is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Macos Bridge?

It is built and maintained by Matthew Murphy (@matthewxmurphy); the current version is v0.6.2.

More 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

💬 Comments