| name | remote-mac |
| description | Control a remote macOS machine from Linux/VPS via SSH |
Execute commands, take screenshots, control apps, and transfer files on a remote macOS machine over SSH.
Copy the example config and fill in your details:
cp skills/our/remote-mac/remote-mac.conf.example ~/.remote-mac.conf
# Edit ~/.remote-mac.conf with your SSH host/user
Or set environment variables directly:
export MAC_SSH_HOST="your-mac-ip-or-hostname"
export MAC_SSH_USER="your-username"
export MAC_SSH_PORT="22" # optional, default 22
export MAC_BRIDGE_URL="http://your-mac-ip:19999/health" # optional
bash skills/our/remote-mac/scripts/mac_exec.sh --run "ls -la ~"
bash skills/our/remote-mac/scripts/mac_exec.sh --run "sw_vers"
bash skills/our/remote-mac/scripts/mac_exec.sh --run "some-long-cmd" 120 # 120s timeout
bash skills/our/remote-mac/scripts/mac_exec.sh --screenshot
bash skills/our/remote-mac/scripts/mac_exec.sh --screenshot /tmp/screen.png
bash skills/our/remote-mac/scripts/mac_exec.sh --app "open:Safari"
bash skills/our/remote-mac/scripts/mac_exec.sh --app "activate:Finder"
bash skills/our/remote-mac/scripts/mac_exec.sh --app "quit:Safari"
bash skills/our/remote-mac/scripts/mac_exec.sh --app "kill:AppName" # force kill (pkill -x)
# Mac โ local
bash skills/our/remote-mac/scripts/mac_exec.sh --file "get:~/Desktop/file.txt:/tmp/file.txt"
# local โ Mac
bash skills/our/remote-mac/scripts/mac_exec.sh --file "put:/tmp/local.txt:~/Desktop/"
bash skills/our/remote-mac/scripts/channel_check.sh
# Output: { "ssh": { "available": true, ... }, "ag_bridge": { ... }, "preferred": "ssh" }
If you have an OpenClaw Node agent running on the Mac, you can use the nodes.run tool directly from the AI for low-latency commands โ no SSH needed:
nodes: action=run, node=<your-node-id>, command=["bash", "-c", "your command"]
bash skills/our/remote-mac/scripts/mac_exec.sh --run "caffeinate -d &"gtimeout โ timeout โ no timeout (macOS compatibility)