/install mac-remote-access
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
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install mac-remote-access - 安装完成后,直接呼叫该 Skill 的名称或使用
/mac-remote-access触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 294 次。
如何安装 Mac Remote Access?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install mac-remote-access」即可一键安装,无需额外配置。
Mac Remote Access 是免费的吗?
是的,Mac Remote Access 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Mac Remote Access 支持哪些平台?
Mac Remote Access 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Mac Remote Access?
由 liu liang(@lliangcol)开发并维护,当前版本 v1.0.0。