macos-suite
Installation
SKILL.md
macos-suite
macOS 本地应用对接技能(偏安全、可扩展)。通过 AppleScript / UI 自动化(System Events)/ URL Scheme / open 命令实现对系统应用的打开、读取与常用动作。
规范符合性(官方)
- Skill 目录以
SKILL.md为核心(YAML frontmatter + 说明),并使用metadata单行 JSON 进行 gating(仅 darwin、需要python3/osascript)。参见 OpenClaw 官方 Skills 规范:https://docs.openclaw.ai/tools/skills - ClawHub 发布/安装以“文件 bundle + metadata”进行版本化管理,核心仍是
SKILL.md。参见官方 ClawHub 文档:https://docs.openclaw.ai/tools/clawhub
⚠️ 安全与权限
- 本技能会触发本机应用自动化:首次调用可能弹出“允许控制某某应用”的系统授权提示。
- 读取类操作不需要
confirm=YES,但可能触发系统隐私授权(例如 Mail/Notes/Reminders/Calendar/Photos)。 - 修改型操作默认需要显式确认参数(否则拒绝执行):
mail.send/calendar.add/reminders.add/notes.createfreeform.*(绘图/排版通过 UI 自动化,会修改画板内容)
- 若缺少
confirm=YES,命令会返回needsConfirm=true的 JSON,提示用户确认并给出只读替代命令(agent 应转述并向用户发起确认)。 - Freeform 的 UI 自动化需要系统开启“辅助功能/自动化”权限;若被拦截,命令返回 JSON 中会包含
hint指引路径。