← Back to Skills Marketplace
294
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install mac-remote-access
Description
Diagnose, configure, and recover remote access to a macOS machine over Tailscale. Use when setting up or troubleshooting Mac SSH, Screen Sharing/VNC, RealVNC...
README (SKILL.md)
Mac Remote Access
Set up or troubleshoot remote access to a Mac over Tailscale.
Workflow
- Check the Mac side first.
- Verify TCP reachability from the remote client.
- Check Tailscale ACLs before tuning VNC clients.
- Preserve at least one command-line recovery path (SSH).
- Recommend a layered setup: SSH fallback, AnyDesk primary GUI fallback, VNC secondary.
Mac-side checks
Run these first when local access to the Mac exists:
tailscale status
tailscale ip -4
sudo systemsetup -getremotelogin
sudo /usr/sbin/netstat -anv -p tcp | grep '\.5900 .*LISTEN'
nc -vz \x3CMac-IP> 5900
If Screen Sharing looks stuck, restart it:
sudo launchctl kickstart -k system/com.apple.screensharing
Windows-side checks
Use PowerShell and prefer TCP tests over ping:
Test-NetConnection \x3CMac-IP> -Port 22
Test-NetConnection \x3CMac-IP> -Port 5900
Interpretation:
- 22=False and 5900=False → check Tailscale ACL / policy first
- 22=True and 5900=False → check Mac Screen Sharing / VNC service
- 22=True and 5900=True → move to client auth/compatibility
ACL guidance
Prefer explicit ACLs during troubleshooting.
Read references/acl-template.md for a minimal working example.
References
references/acl-template.md— minimal ACL templatereferences/checklist.md— baseline checklistreferences/sop.md— end-to-end operating procedurereferences/anydesk-rustdesk.md— GUI fallback setup and troubleshooting notes
Usage Guidance
This skill appears coherent and focused on admin diagnostics. Before using it: (1) verify the skill author/source since the registry metadata has no homepage; (2) review any sudo commands you run and understand they will modify local services (restarting Screen Sharing is benign but disruptive); (3) when installing AnyDesk/RustDesk follow official vendor downloads and be cautious granting Accessibility/Screen Recording and unattended-access passwords; (4) avoid pasting sensitive outputs (logs, private keys, passwords) into public chat; and (5) if you plan to let the agent run autonomously, restrict that behavior or review suggested commands before execution.
Capability Analysis
Type: OpenClaw Skill
Name: mac-remote-access
Version: 1.0.0
The skill bundle provides legitimate documentation and diagnostic commands for troubleshooting macOS remote access via Tailscale, SSH, and VNC. It includes standard system checks (e.g., netstat, launchctl, and Test-NetConnection) and configuration guidance for third-party tools like AnyDesk and RustDesk without any evidence of malicious intent, data exfiltration, or unauthorized persistence.
Capability Assessment
Purpose & Capability
Name/description (Mac remote access over Tailscale, SSH/VNC/AnyDesk/RustDesk) match the SKILL.md and reference files. No unrelated binaries, credentials, or config paths are requested.
Instruction Scope
Runtime instructions are limited to local diagnostics and administrative actions (tailscale status/ip, netstat, nc, Test-NetConnection, restart screensharing). They do not direct data to external endpoints beyond standard remote-access tools. Note: several commands require sudo and will modify local services (e.g., kickstart screensharing), which is expected for this purpose.
Install Mechanism
No install spec and no code files — instruction-only. The static scanner had no files needing code analysis.
Credentials
The skill declares no environment variables, credentials, or config paths. The included ACL template references typical Tailscale ACL fields but does not demand secrets from the user.
Persistence & Privilege
always:false (default). The skill can be invoked autonomously (platform default) but does not request persistent system-wide privileges or modify other skills/configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install mac-remote-access - After installation, invoke the skill by name or use
/mac-remote-access - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Tailscale-based Mac remote access troubleshooting, ACL guidance, SSH/VNC checks, and AnyDesk/RustDesk fallback notes.
Metadata
Frequently Asked Questions
What is Mac Remote Access?
Diagnose, configure, and recover remote access to a macOS machine over Tailscale. Use when setting up or troubleshooting Mac SSH, Screen Sharing/VNC, RealVNC... It is an AI Agent Skill for Claude Code / OpenClaw, with 294 downloads so far.
How do I install Mac Remote Access?
Run "/install mac-remote-access" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Mac Remote Access free?
Yes, Mac Remote Access is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Mac Remote Access support?
Mac Remote Access is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Mac Remote Access?
It is built and maintained by liu liang (@lliangcol); the current version is v1.0.0.
More Skills