← 返回 Skills 市场
leocdchina

macOS Contacts

作者 Leocdchina · GitHub ↗ · v0.1.1 · MIT-0
cross-platform ⚠ suspicious
94
总下载
1
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install openclaw-macos-contacts
功能描述
Read, search, and safely create contacts in macOS Contacts (Address Book). Use when the user asks to inspect the native macOS contacts database, search conta...
安全使用建议
This skill appears coherent and implements local read/write workflows for macOS Contacts. Before installing or running it: (1) review and be comfortable with backups written to ~/.openclaw/state/macos-contacts (these contain contact data and should be protected or cleaned if needed); (2) expect to grant macOS Contacts automation/Contacts.framework permission when running Swift/AppleScript writes; (3) inspect any commands you run under contacts_txn.sh since it executes arbitrary local commands and will restore backups on failure; (4) confirm you have swift/python installed on the target mac; and (5) note there are some minor code quality issues (e.g., a bug in a Merge script's 'originals' construction and a truncated Swift file in the distribution preview) — consider testing in a safe environment or reviewing those files before using in production.
功能分析
Type: OpenClaw Skill Name: openclaw-macos-contacts Version: 0.1.1 The skill provides extensive access to the macOS Contacts database and includes a transaction wrapper (`contacts_txn.sh`) for shell command execution. While no malicious intent is evident, the scripts exhibit several high-risk patterns and vulnerabilities, specifically unsafe string interpolation of shell variables into Python heredocs in `scripts/contacts_txn.sh` and `scripts/contacts_dedupe.sh`, which could lead to code injection if command outputs contain unexpected characters. Additionally, the skill's core functionality requires broad permissions to read and modify sensitive user data in `~/Library/Application Support/AddressBook/`, which is a significant attack surface.
能力评估
Purpose & Capability
Name/description match the included artifacts: SQLite-based read script, Swift/AppleScript write paths, backup/restore and transaction wrappers, and dedupe/merge helpers. The requested capabilities (none: no env vars or external credentials) align with a local-contacts skill.
Instruction Scope
Runtime instructions explicitly target the local macOS Contacts DB and Contacts APIs. Scripts read ~/Library/Application Support/AddressBook/AddressBook-v22.abcddb (sqlite read uses mode=ro) and use osascript/Contacts.framework for writes. This is expected, but note backups and transaction wrappers write files under $HOME/.openclaw/state/macos-contacts (sensitive contact data will be present there). The txn wrapper executes the supplied mutating command and will restore backups on failure — normal for transactional safety but gives the skill the ability to run local mutating commands that you should review before invoking.
Install Mechanism
Instruction-only skill with no installer. Bundled scripts are plain Python, Bash, Swift and AppleScript wrappers that run locally — no external downloads or install steps were included.
Credentials
No environment variables, credentials, or network endpoints are requested. The skill stores runtime backups under ~/.openclaw/state/macos-contacts which is proportional for a backup/txn workflow but could be a privacy consideration since contact data is persisted there.
Persistence & Privilege
always:false and user-invocable:true (default) — normal. The skill does not modify other skills or system-wide agent settings. It creates local backup state under the user's home (expected for rollback functionality).
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install openclaw-macos-contacts
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /openclaw-macos-contacts 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.1.1
Add Chinese documentation and publishing metadata cleanup
v0.1.0
Initial private release: SQLite read + Swift Contacts.framework write/check + backup/rollback + dedupe/merge
元数据
Slug openclaw-macos-contacts
版本 0.1.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

macOS Contacts 是什么?

Read, search, and safely create contacts in macOS Contacts (Address Book). Use when the user asks to inspect the native macOS contacts database, search conta... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 94 次。

如何安装 macOS Contacts?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install openclaw-macos-contacts」即可一键安装,无需额外配置。

macOS Contacts 是免费的吗?

是的,macOS Contacts 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

macOS Contacts 支持哪些平台?

macOS Contacts 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 macOS Contacts?

由 Leocdchina(@leocdchina)开发并维护,当前版本 v0.1.1。

💬 留言讨论