什么是 Apple Photos 集成？

Apple Photos 技能在您的 macOS 媒体库和终端环境之间建立了高性能的桥梁。通过利用直接的 SQLite 查询，此集成允许快速检索照片元数据、相册组织和基于人物的分层。它专为需要自动化媒体处理或执行超出标准 GUI 功能的复杂搜索的用户而设计。

将此工具添加到您的 Openclaw Skills 库中，使您能够将照片收藏视为可搜索的数据库。无论您是通过机器学习寻找特定的视觉内容，还是按日期组织多年的记忆，此技能都提供了与您的 Apple Photos 数据高效且可靠地交互的技术基础。

下载入口:https://github.com/openclaw/skills/tree/main/skills/tyler6204/apple-photos

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Apple Photos 集成 应用场景

• 自动化导出用于 Web 开发或文档的近期照片。
• 利用人脸识别元数据在海量库中查找特定人物。
• 执行基于机器学习的对象或场景内容搜索。
• 通过命令行生成库统计信息并审核相册内容。
• 在批量导出工作流程中以编程方式将 HEIC 图像转换为 JPEG。

1. 建立与 macOS Photos.app SQLite 数据库的只读连接。
2. 执行优化的 Shell 脚本以查询相册、人物和时间戳的元数据。
3. 根据请求，利用内置的 macOS ML 功能进行基于内容的视觉搜索。
4. 通过唯一的 UUID 识别特定资产，以确保信息检索过程中的精确性。
5. 处理文件系统操作，将媒体文件导出并转换为 JPEG 等通用格式。

Apple Photos 集成 配置指南

要在您的 Openclaw Skills 环境中使用此集成，请按照以下步骤操作：

1. 授予终端完全磁盘访问权限：导航至 系统设置 > 隐私与安全性 > 完全磁盘访问权限，并将您的终端应用程序切换为开启。
2. 导航至技能目录：

cd {baseDir}

3. 通过检查您的库统计信息来初始化连接：

./scripts/photos-count.sh

Apple Photos 集成 数据架构与分类体系

该技能返回结构化数据以便于解析。以下是搜索结果的主要输出架构：

此外，基于人物的查询将返回包含 ID、姓名和照片总数的表格。

name: apple-photos
description: Apple Photos.app integration for macOS. List albums, browse photos, search by date/person/content, export photos.
metadata: {"clawdbot":{"emoji":"??","os":["darwin"]}}

Apple Photos

Access Photos.app via SQLite queries. Run scripts from: cd {baseDir}

Requirements

• Full Disk Access for terminal (System Settings → Privacy → Full Disk Access)

Commands

Output

• Recent/search: Filename | Date | Type | UUID
• People: ID | Name | Photo Count
• Default export: /tmp/photo_export.jpg

Workflow: View a Photo

1. Get UUID: scripts/photos-recent.sh 1
2. Export: scripts/photos-export.sh "UUID"
3. View at /tmp/photo_export.jpg

Notes

• Date format: YYYY-MM-DD or YYYY-MM-DD HH:MM
• Content search uses ML, slower (5-10s) than date/person (100ms)
• HEIC auto-converts to JPEG on export
• Name search is case-insensitive, partial match