macos-bridge_skill

Overview

This skill bridges Mac-owned CLI tools onto a Linux OpenClaw gateway by installing explicit SSH-backed wrappers. It exposes tools like imsg, remindctl, memo, things, and peekaboo as stable Linux-side commands while keeping the real binaries and permissions on the Mac.

How this skill works

The skill installs lightweight wrapper scripts on the Linux gateway that SSH into the owning Mac to invoke the real macOS binaries. It supports auto-discovery of remoteHost entries from an OpenClaw config, explicit host mapping, and optional Wake-on-LAN to wake sleeping Macs before a call. Verification and ownership mapping tools ensure the wrappers are auditable and correctly configured.

When to use it

• You need Linux-side commands that actually run macOS-backed tools without moving data or permissions off the Mac.
• A same-LAN OpenClaw gateway should expose Mac-native utilities to other Linux-hosted skills.
• You want wrapper-backed published skills that remain truthful about tool ownership.
• You require optional Wake-on-LAN resume for Macs that may sleep between uses.
• You already maintain an OpenClaw config and want automatic remoteHost discovery.

Best practices

• Keep the Linux gateway and Macs on the same trusted LAN or VLAN; do not use across untrusted WANs.
• Ensure SSH key-based access from the gateway to each Mac and verify remote binaries have correct macOS permissions.
• Prefer explicit mapping in the installer or OpenClaw remoteHost entries to avoid interactive prompts.
• Enable Wake-on-LAN only for Macs that support it and provide accurate MAC addresses for reliable resume.
• Use the verification script after install to confirm wrappers call the expected remote binaries.

Example use cases

• Expose a team Mac’s memo and imsg tools to a shared Linux gateway for scripted automation.
• Run remindctl on a Mac from Linux cron jobs without granting Linux direct access to macOS data stores.
• Publish a wrapper-backed skill that uses things on macOS while keeping authoritative binaries on the owner Mac.
• Auto-discover the Mac owner from an existing OpenClaw config and install wrappers non-interactively.
• Wake a sleeping Mac before invoking a tool to support intermittent workstation uptime.