← 返回 Skills 市场
MacPilot : Control macOS using CLI
作者
Adhik Joshi
· GitHub ↗
· v0.7.0
384
总下载
0
收藏
2
当前安装
1
版本数
在 OpenClaw 中安装
/install macpilot
功能描述
Control macOS via CLI using MacPilot for automating UI actions, managing windows, handling file dialogs, capturing screenshots, and system tasks.
使用说明 (SKILL.md)
MacPilot Skills
Agent skills for MacPilot — a CLI tool for macOS automation via Accessibility APIs.
These skills teach AI coding agents (Claude Code, Cursor, Codex, etc.) how to use MacPilot to automate macOS tasks: clicking buttons, typing text, managing windows, handling file dialogs, taking screenshots, and more.
Install
npx skills add adhikjoshi/macpilot-skills
This uses the skills CLI to install skills into your agent of choice.
Available Skills
| Skill | Description |
|---|---|
| macpilot-automation | Core macOS automation — mouse, keyboard, apps, menus, clipboard (with history & search), notifications, shell, system controls |
| macpilot-ui-inspector | Inspect and interact with UI elements via accessibility APIs — find, click, read, and modify controls |
| macpilot-dialog-handler | Handle native file dialogs (Open, Save, Print) — navigate folders, select files, dismiss alerts, wait-for & click-primary |
| macpilot-screenshot-ocr | Capture screenshots, OCR click (find & click text on screen), screen recording with pause/resume |
| macpilot-window-manager | Manage windows — list, move, resize, snap, fullscreen, Spaces, save/restore layouts |
Prerequisites
- MacPilot installed — Build from source or download from releases
- Accessibility permission — Grant MacPilot.app access in System Settings > Privacy & Security > Accessibility
- Screen Recording permission (for screenshot/OCR skills) — Grant in System Settings > Privacy & Security > Screen Recording
Quick Start
# Install MacPilot skills into Claude Code
npx skills add adhikjoshi/macpilot-skills
# Now ask Claude Code to automate macOS:
# "Open Safari and navigate to example.com"
# "Take a screenshot of the Finder window"
# "Snap VS Code to the left half and Terminal to the right"
# "Save this file to my Desktop"
Manual Install
If you prefer not to use npx skills, copy any SKILL.md file to your agent's skills directory:
# Claude Code (project scope)
mkdir -p .claude/skills/macpilot-automation
cp skills/macpilot-automation/SKILL.md .claude/skills/macpilot-automation/
# Claude Code (global scope)
mkdir -p ~/.claude/skills/macpilot-automation
cp skills/macpilot-automation/SKILL.md ~/.claude/skills/macpilot-automation/
License
MIT
安全使用建议
This skill appears internally consistent with its description, but it depends on the third-party MacPilot binary and macOS permissions that are powerful: Accessibility lets the tool control apps and UI, and Screen Recording/screenshot+OCR can capture any visible content (passwords, private documents, chats). Before installing: (1) confirm you trust the MacPilot upstream (review its GitHub release you install), (2) only grant Accessibility/Screen Recording to the MacPilot.app you installed, (3) be cautious about allowing autonomous agent actions that perform shell commands or take screenshots—limit autonomy or require explicit user approval for sensitive tasks, and (4) avoid using the skill on machines with highly sensitive data unless you trust the binary and agent behavior. If you want stronger assurance, inspect the MacPilot binary source or run the skill in a less-privileged/testing account.
功能分析
Type: OpenClaw Skill
Name: macpilot
Version: 0.7.0
The MacPilot skill bundle provides an AI agent with extensive control over macOS, including high-risk capabilities such as arbitrary shell command execution (`macpilot shell run`), clipboard history tracking, and screen recording with OCR. While these tools are functionally relevant to the stated goal of OS automation, the lack of restricted scopes for shell access and the ability to programmatically retrieve sensitive system information (IP, WiFi, clipboard) create a significant security risk for prompt-injection-based attacks. No evidence of intentional malicious behavior or hardcoded exfiltration endpoints was found in the provided markdown instructions, primarily located in skills/macpilot-automation/SKILL.md and skills/macpilot-screenshot-ocr/SKILL.md.
能力评估
Purpose & Capability
Name/description match the content: all SKILL.md files are explicit about using the macpilot CLI to automate macOS (UI, windows, dialogs, screenshots, OCR, shell). No unrelated environment variables, binaries, or installs are requested by the skill itself. The requirement that MacPilot be installed on the machine is appropriate for the stated functionality.
Instruction Scope
Instructions tell the agent to run macpilot CLI commands (click/type/ui inspect/dialog navigation/screenshot/ocr/shell). This is coherent, but those commands enable powerful actions: arbitrary UI control, screen captures (including OCR of screen content), and execution of shell commands via macpilot shell run. These behaviors are expected for an automation skill but can expose sensitive data (visible screen contents, files) or run arbitrary commands — consider that when granting use/permissions.
Install Mechanism
Instruction-only skill with no install spec and no bundled code. The README suggests installing MacPilot itself from its GitHub releases or building from source; that is outside this skill. The lack of downloads or archive extraction in the skill package is low-risk.
Credentials
The skill does not request environment variables or credentials. It does require the user to install MacPilot and to grant Accessibility and (for screenshots/ocr/recording) Screen Recording permissions to MacPilot.app. Those OS permissions are necessary for the functionality but provide broad access to UI and visible screen contents — which is proportional to the stated purpose but inherently sensitive.
Persistence & Privilege
Skill is not always-enabled and does not request permanent platform-level privileges. It's instruction-only and doesn't modify other skills or agent configs. Autonomous invocation is permitted by default (platform behavior) — not flagged alone but combine with the sensitivity noted above when making a trust decision.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install macpilot - 安装完成后，直接呼叫该 Skill 的名称或使用
/macpilot触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v0.7.0
Programmatic macOS control for AI agents. Everything a human can do via keyboard + mouse, MacPilot can do programmatically using CLI
元数据
常见问题
MacPilot : Control macOS using CLI 是什么？
Control macOS via CLI using MacPilot for automating UI actions, managing windows, handling file dialogs, capturing screenshots, and system tasks. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 384 次。
如何安装 MacPilot : Control macOS using CLI？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install macpilot」即可一键安装，无需额外配置。
MacPilot : Control macOS using CLI 是免费的吗？
是的，MacPilot : Control macOS using CLI 完全免费（开源免费），可自由下载、安装和使用。
MacPilot : Control macOS using CLI 支持哪些平台？
MacPilot : Control macOS using CLI 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 MacPilot : Control macOS using CLI？
由 Adhik Joshi（@adhikjoshi）开发并维护，当前版本 v0.7.0。
推荐 Skills