← 返回 Skills 市场
292
总下载
0
收藏
3
当前安装
2
版本数
在 OpenClaw 中安装
/install macos-contacts
功能描述
Access and search Apple Contacts on macOS using AppleScript. Use when the user asks to look up a contact, find a phone number or email, search contacts by na...
使用说明 (SKILL.md)
Apple Contacts (AppleScript)
Uses osascript to query the macOS Contacts app. macOS only. Requires Contacts permission on first run — macOS will show a prompt, click Allow.
Setup
No installation required. Just ensure the skill's scripts/ directory is intact after installing.
Usage
# List all contacts
osascript \x3Cskill_dir>/scripts/contacts.applescript list
# Search by name (case-insensitive)
osascript \x3Cskill_dir>/scripts/contacts.applescript search "Alice"
# Get full details for a contact
osascript \x3Cskill_dir>/scripts/contacts.applescript get "Alice Smith"
Replace \x3Cskill_dir> with the absolute path to this skill's directory (use pwd inside the skill folder if unsure).
Output format
list/search: one line per match →Name | Phone | Emailget: full details (all phones, emails, birthday, notes), contacts separated by---
Notes
- First run may trigger a macOS Contacts permission dialog — user must click Allow
- If no contacts found, returns a descriptive message instead of empty output
- Script supports partial name matching (e.g. "Ali" matches "Alice Smith")
安全使用建议
This skill's purpose (reading Apple Contacts via osascript) is plausible, but the package as published contains only SKILL.md and no scripts. Before installing: (1) do not install or enable the skill unless the package includes the referenced scripts/contacts.applescript files — ask the publisher for the missing files or a verified release. (2) If you obtain the scripts, inspect their contents before running to ensure they only access local Contacts and do not transmit data elsewhere. (3) Be aware enabling the skill will trigger macOS Contacts permission and allow the script to read your address book (sensitive personal data). (4) Prefer installing/testing in a controlled macOS account or sandboxed environment and confirm no network calls are made by the scripts. If the publisher cannot supply the missing scripts or a trustworthy source, treat the skill as incomplete/untrusted.
功能分析
Type: OpenClaw Skill
Name: macos-contacts
Version: 1.0.1
The skill is a macOS-specific utility designed to search and retrieve information from the Apple Contacts app using AppleScript. While it accesses sensitive personal data (including contact notes), its behavior is transparently documented and strictly aligned with its stated purpose in SKILL.md, with no evidence of malicious intent, data exfiltration, or obfuscation in the provided files.
能力评估
Purpose & Capability
The stated purpose (querying macOS Contacts via AppleScript) is coherent with using osascript, but the SKILL.md requires a scripts/contacts.applescript under the skill directory. The package manifest contains only SKILL.md and no scripts or code files, so the skill as published cannot perform the claimed functionality without additional files not present in the package.
Instruction Scope
Instructions are narrowly scoped to running osascript against a local AppleScript to read Contacts. That behavior legitimately requires macOS Contacts permission and will access sensitive personal data (all address-book entries). The instructions do not ask to read unrelated files or exfiltrate data, but they do direct the agent to access local contacts — a privacy-sensitive action that should be explicit to users.
Install Mechanism
There is no install spec (instruction-only), which is low-risk in general. However the SKILL.md's 'ensure scripts/ directory is intact' requirement is inconsistent with the manifest's lack of any scripts. Either required script files were omitted from the package or SKILL.md is stale; both are problematic because the skill will fail or depend on out-of-band downloads.
Credentials
No environment variables, credentials, or config paths are requested — appropriate for a local Contacts lookup. Note that the skill will request macOS Contacts permission at runtime, which grants access to the user's address book (sensitive personal data).
Persistence & Privilege
always is false and autonomous invocation is allowed (platform default). There is no evidence the skill requests permanent presence or modifies other skills or system-wide settings.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install macos-contacts - 安装完成后，直接呼叫该 Skill 的名称或使用
/macos-contacts触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
Fix: removed hardcoded user path
v1.0.0
Initial release: search and look up Apple Contacts via AppleScript
元数据
常见问题
Apple Contacts 是什么？
Access and search Apple Contacts on macOS using AppleScript. Use when the user asks to look up a contact, find a phone number or email, search contacts by na... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 292 次。
如何安装 Apple Contacts？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install macos-contacts」即可一键安装，无需额外配置。
Apple Contacts 是免费的吗？
是的，Apple Contacts 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Apple Contacts 支持哪些平台？
Apple Contacts 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Apple Contacts？
由 NeriRos（@neriros）开发并维护，当前版本 v1.0.1。
推荐 Skills