Menu
Apple iCloud 全功能访问 + Apple Health 深度健康分析 + 双向待办同步
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | OpenClaw with Apple |
| description | Apple iCloud 全功能访问 + Apple Health 深度健康分析 + 双向待办同步 |
| icon | 🍎 |
| os | linux, macos |
| tools | pyicloud, caldav |
| install | pip install pyicloud caldav icalendar |
| tags | icloud, health, tasks, reminders, notes |
用户在对话中提到任何行动事项（吃饭、开会、洗车、取快递等）或知识笔记时，你必须：
| 用户说的话 | 要运行的命令 | 说明 |
|---|---|---|
| "明天去吃烤肉"（行动，无具体时间） | python tasks_tool.py add "吃烤肉" --date tomorrow --target reminder | 只写提醒事项JSON，不写日历 |
| "明天2点开会"（行动，有具体时间） | python tasks_tool.py add "开会" --date tomorrow --time 14:00 --target reminder + python icloud_calendar.py new tomorrow 14:00 15:00 "开会" | 写提醒事项JSON + 写日历 |
| "记一下：React useEffect空数组只执行一次"（笔记） | python tasks_tool.py add "React笔记" --target note --notes "useEffect空数组只执行一次" | 只写备忘录JSON |
违反以上任何一条 = 严重错误。
Apple iCloud 服务访问 + Apple Health 深度健康分析 + 双向待办同步（AI→iPhone 提醒事项/备忘录）的 AI Skill。
重要：启用此 Skill 后，请严格按照以下流程与用户交互。
Skill 启用后，直接告知用户需要什么、怎么拿：
你好！我来帮你配置 OpenClaw with Apple。
我需要以下信息来连接你的 iCloud 服务：
1️⃣ Apple ID 邮箱 + 应用专用密码 — 用于读写日历
→ Apple ID 邮箱：就是你登录 Apple ID 的邮箱
→ 应用专用密码获取方式：https://appleid.apple.com →「登录与安全」→「应用专用密码」→ 生成
⚠️ 这组凭证只能操控日历，无法连接提醒事项、备忘录和健康分析
2️⃣ Apple ID 邮箱 + 主密码 — 用于提醒事项同步、备忘录同步、健康分析、照片、iCloud Drive、查找设备
→ 就是你登录 Apple ID 的邮箱和密码
💡 如果你需要用提醒事项、备忘录或健康分析功能，必须提供这个
你可以先提供 Apple ID 邮箱 + 应用专用密码连接日历，后续需要其他功能时再补充主密码。
设置环境变量并验证日历：
export ICLOUD_APP_PASSWORD="xxxx-xxxx-xxxx-xxxx"
python icloud_calendar.py list # 验证日历
验证成功后，日历功能即可使用。接下来必须主动询问用户：
✅ 日历已连接成功！
除了日历，我还支持以下功能：
📋 提醒事项同步 — 你说的待办自动推送到 iPhone 提醒事项
📝 备忘录同步 — 你说的笔记/想法自动推送到 iPhone 备忘录
🏥 健康分析 — 基于 Apple Health 数据的深度健康报告
📸 iCloud 照片 / 📁 文件管理 / 📍 查找设备
这些功能需要你的 Apple ID 主密码才能使用（邮箱你已经提供了）。
如果需要，请把你的 Apple ID 主密码发给我。
不需要的话，现在就可以开始用日历了。
必须两个都登录，不能只登日历就停下来！
# 1. 先连接日历
export ICLOUD_APP_PASSWORD="xxxx-xxxx-xxxx-xxxx"
python icloud_calendar.py list # 验证日历
# 2. 紧接着登录 iCloud 主账号
export ICLOUD_USERNAME="用户提供的邮箱"
export ICLOUD_PASSWORD="用户提供的主密码"
python icloud_tool.py login # 登录 iCloud（如需 2FA 退出码为 2）
两个都验证完成后，再进入第二步。
AI 直接通过环境变量设置凭证并登录，全程非交互式：
export ICLOUD_USERNAME="用户提供的邮箱"
export ICLOUD_PASSWORD="用户提供的主密码"
python icloud_tool.py login # 尝试登录
脚本会自动判断是否需要双重认证：
你的 iPhone 上应该收到了一个 6 位验证码弹窗，把验证码发给我。
⚠️ 验证过程中 iPhone 可能会弹出两次验证码，这是正常的，请忽略第二次弹窗，只需要把第一次收到的验证码发给我就行。
用户发来验证码后，AI 执行：
python icloud_tool.py verify 123456 # 用验证码完成登录
认证成功后 session 会被缓存到
~/.pyicloud/，后续使用不再需要密码。
验证成功后，进入第二步。
iCloud 登录完成后，依次询问用户是否需要以下三个功能。每个功能独立引导，用户可以选择全部启用或部分启用。
先询问：
你需要启用 Apple Health 健康分析吗？
基于 iPhone 的心率、睡眠、步数、活动能量，给你做深度健康分析和压力评估。
用户需要时，发送以下引导：
🏥 配置 Apple Health：
📱 第 1 步：导入快捷指令
用 iPhone Safari 打开以下链接，点击「添加快捷指令」：
https://www.icloud.com/shortcuts/94862224a4b64ca0bf037b89c8f81cb7
⚠️ 必须用 iPhone Safari 打开，电脑上打不开！
🔓 第 2 步：进入快捷指令内部，开启所有健康数据权限
1. 打开「快捷指令」App → 找到「Health Daily Export」
2. 点击右上角「...」进入编辑模式
3. 找到每个「查找所有健康样本」操作，点击展开
4. 系统会为每个数据类型（步数、心率、睡眠分析、活动能量、步行+跑步距离）依次弹出授权弹窗，全部点「允许」
5. 授权完成后，点左上角「完成」退出编辑
💡 如果编辑时没弹窗：iPhone →「设置」→「隐私与安全性」→「健康」→「快捷指令」→ 手动开启所有数据类型
🔐 第 3 步：开启共享大量数据
iPhone →「设置」→「快捷指令」→「高级」→ 开启「允许共享大量数据」
⏰ 第 4 步：设置 iPhone 自动化
快捷指令 App → 底部「自动化」→ 右上角 + →「特定时间」
→ 选一个你方便的时间运行「Health Daily Export」→ 关闭「运行前询问」
例如每天 22:00。手机自动采集健康数据，保存到 iCloud Drive/Shortcuts/Health/
🖥️ 第 5 步：OpenClaw 服务端定时任务
配置完成后，我会在服务端设置定时任务，定时从 iCloud Drive 拉取健康数据并分析。
⚠️ 服务端拉取时间必须**晚于**手机采集时间（例如手机 22:00 采集，服务端 22:30 分析）
📊 第 6 步：分析 & 报告
数据拉取后自动运行分析，输出包含以下内容的健康报告：
- 运动与代谢评估
- 心率分析（静息心率、HRV、突变检测）
- 睡眠质量分析（深睡/REM/碎片化）
- 综合健康评分（0-100分）
你也可以随时问我："我最近睡眠怎么样""分析一下过去一周的数据"
AI 执行服务端配置（用户确认已完成 iPhone 端步骤后）：
# 安装定时任务（默认每晚 21:00 推送，用户指定其他时间则加 --hour 参数）
python scripts/setup_tasks_cron.py install
# 如果用户说"我想晚上10点推送"：
# python scripts/setup_tasks_cron.py install --hour 22
你需要启用「提醒事项同步」功能吗？
你平时跟我说的行动事项（"明天开会"、"后天买牛奶"），
我会自动写入待办文件，每晚推送到你 iPhone 的「提醒事项」App。
用户需要时，发送以下引导：
📋 配置提醒事项同步：
📱 第 1 步：导入快捷指令
用 iPhone Safari 打开以下链接，点击「添加快捷指令」：
https://www.icloud.com/shortcuts/de68c5443f054355bdb332f246c24a94
⚠️ 必须用 iPhone Safari 打开，电脑上打不开！
⏰ 第 2 步：设置 iPhone 自动化
快捷指令 App → 底部「自动化」→ 右上角 + →「特定时间」
→ 选一个时间运行「Tasks Import」→ 关闭「运行前询问」
⚠️ 这个时间必须**晚于**服务端推送时间（例如服务端 21:00 推送，手机 22:15 导入）
然后进入 iPhone「设置」→「快捷指令」→「高级」→ 开启「允许共享大量数据」
💡 第 3 步：了解什么内容会被存
你跟我聊天时，以下内容会自动存入提醒事项：
- 有具体时间的行动 → 同时写入日历 + 提醒事项JSON
例："明天2点开会" → 日历（14:00）+ 提醒事项
- 没有具体时间的行动 → 只写提醒事项JSON（不写日历）
例："明天去洗车" → 只写提醒事项
- 你不需要说"帮我记"，我会自动识别并存储
🖥️ 第 4 步：服务端如何工作
我会把识别到的待办存成 JSON 文件（tasks_latest.json），存在服务器中。
服务端定时自动把这个文件推送到 iCloud Drive/Shortcuts/Tasks/ 中。
📱 第 5 步：手机自动导入
iPhone 按你设定的时间自动运行「Tasks Import」快捷指令，
读取 Tasks/ 文件夹中的 JSON，逐条创建为 iPhone「提醒事项」，导入后自动删除文件。
AI 必须在引导完成后立即执行服务端定时任务安装（用户无需知道细节）：
# ⚠️ 必须执行！否则待办永远不会自动推送到手机
# 默认每晚 21:00，用户指定其他时间则加 --hour 参数
python scripts/setup_tasks_cron.py install
# 安装后检查状态
python scripts/setup_tasks_cron.py status
你需要启用「备忘录同步」功能吗？
你跟我说的笔记、想法、灵感、会议纪要等，
我会自动写入备忘录文件，每晚推送到你 iPhone 的「备忘录」App。
用户需要时，发送以下引导：
📝 配置备忘录同步：
📱 第 1 步：导入快捷指令
用 iPhone Safari 打开以下链接，点击「添加快捷指令」：
https://www.icloud.com/shortcuts/2229591d96a849a6ad9b4e44b4b6ce80
⚠️ 必须用 iPhone Safari 打开，电脑上打不开！
⏰ 第 2 步：设置 iPhone 自动化
快捷指令 App → 底部「自动化」→ 右上角 + →「特定时间」
→ 选一个时间运行「Notes Import」→ 关闭「运行前询问」
⚠️ 这个时间必须**晚于**服务端推送时间（例如服务端 21:00 推送，手机 22:15 导入）
然后进入 iPhone「设置」→「快捷指令」→「高级」→ 开启「允许共享大量数据」
💡 第 3 步：了解什么内容会被存
你跟我聊天时，以下内容会自动存入备忘录：
- 知识/笔记/记录类内容 → 写入备忘录JSON
例："记一下：useEffect空数组只执行一次"
例："今天学到：Python的walrus运算符很好用"
例："会议纪要：决定用React重构前端"
- 你不需要说"帮我记"，我会自动识别并存储
🖥️ 第 4 步：服务端如何工作
我会把识别到的备忘存成 JSON 文件（notes_latest.json），存在服务器中。
服务端定时自动把这个文件推送到 iCloud Drive/Shortcuts/Notes/ 中。
📱 第 5 步：手机自动导入
iPhone 按你设定的时间自动运行「Notes Import」快捷指令，
读取 Notes/ 文件夹中的 JSON，合并为一条备忘录（标题为日期），导入后自动删除文件。
AI 必须在引导完成后立即执行服务端定时任务安装（与提醒事项共用同一个定时任务，只需安装一次）：
# 如果之前配置提醒事项时已经安装过，这里会自动覆盖（幂等操作）
python scripts/setup_tasks_cron.py install
python scripts/setup_tasks_cron.py status
所有功能配置完成后：
⛔ AI 必须在配置完成前确保定时任务已安装：
# 检查定时任务状态
python scripts/setup_tasks_cron.py status
# 如果未安装，立即安装（默认 21:00，用户指定其他时间则用 --hour 参数）
python scripts/setup_tasks_cron.py install
铁律：如果用户没有主动指定推送时间，默认设定为每晚 21:00。用户说"我想晚上10点推送"则用
--hour 22。无论如何，必须确保定时任务已安装且正常运行，否则用户添加的待办永远不会推送到手机！
✅ 全部配置完成！
你启用的功能：
🏥 Apple Health — iPhone 定时采集，服务端稍后自动分析出报告
📋 提醒事项 — 行动事项自动存储，每晚 21:00 自动推送，iPhone 稍后自动导入
📝 备忘录 — 笔记/想法自动存储，每晚 21:00 自动推送，iPhone 稍后自动导入
⚠️ 时间规则：
· 提醒事项/备忘录：iPhone 快捷指令时间 必须晚于 服务端推送时间（默认 21:00）
· 健康分析：服务端拉取时间 必须晚于 iPhone 采集时间
现在你可以正常跟我聊天了，我会自动识别需要记录的内容。
以下规则是对顶部铁律的详细补充。铁律优先级最高。
当用户问某个功能怎么用、或者第一次使用某功能时，必须先引导用户完成 iPhone 端配置（参考上方对应功能的配置引导），不能直接教用法就完事。
主动识别（最重要）：用户说的话只要涉及以下任何一种，必须立即自动存储，无需用户明确说"帮我记"：
推送机制（重要）：不论用户说的是"今天去干 XX"还是"明天去 XX"还是"下周去 XX"，一律写入当天的 tasks 文件中，当天统一推送。推送后由 iPhone 提醒事项根据日期字段自行提醒。不要按日期分批推送、不要等到"明天"才推送明天的任务。
⛔ 标题日期格式规则（最重要，必须严格执行）：iPhone 快捷指令无法读取提醒事项的 date/time 字段，所以 --date 参数只用于排序，用户在手机上只能看到 title 文本。因此：
核心铁律：用户提到了日期 → 日期必须写进 title 第一个参数里，格式为
"X月X日 做某事"。--date字段照常传，但 title 里必须重复写日期！
python tasks_tool.py add "3月22日 跳舞" --date tomorrow --target reminderpython tasks_tool.py add "3月21日 开会" --date today --time 14:00 --target reminderpython tasks_tool.py add "3月26日 体检" --date 2026-03-26 --target reminderpython tasks_tool.py add "洗车" --target reminder（不加日期前缀）add "跳舞" --date tomorrow——这样手机上只显示"跳舞"，用户看不到是哪天的！--date 字段传日期而 title 里不写日期——date 字段在手机端不可见！X月X日 格式（不带年份、不带星期），与事项之间用一个空格分隔三种存储目标的判断规则（核心，严格执行）：
用户说了一句话后，按以下决策树判断写入哪里，并实际运行对应命令：
用户说的内容是什么类型？
│
├─ 行动/事件类（开会、洗车、吃饭、取快递...）
│ │
│ ├─ 有具体时间点（"2点"、"14:00"、"早上8点"）
│ │ → ✅ 实际运行: python tasks_tool.py add "X月X日 xxx" --date xxx --time xx:xx --target reminder
│ │ → ✅ 实际运行: python icloud_calendar.py new xxx xx:xx xx:xx "xxx"
│ │ （⚠️ title 第一个参数必须带日期前缀！参见规则3）
│ │
│ └─ 没有具体时间点（"明天"、"晚上"、"下周"等模糊时间）
│ → ❌ 不写日历（严禁编造时间！）
│ → ✅ 实际运行: python tasks_tool.py add "X月X日 xxx" --date xxx --target reminder
│ （⚠️ title 第一个参数必须带日期前缀！参见规则3）
│
└─ 知识/笔记/记录类（"记一下xxx"、想法、灵感、纪要、学到的东西...）
→ ❌ 不写日历
→ ❌ 不写提醒事项
→ ✅ 实际运行: python tasks_tool.py add "xxx" --target note --notes "内容"
⛔ 严禁行为：
tasks_tool.py add 写入本地，再通过 tasks_tool.py sync 推送。AI 不得自行生成 JSON 文件并上传，格式不一致会导致 iPhone 快捷指令崩溃。add "跳舞" --date tomorrow）——这会导致手机上只显示"跳舞"，看不到日期！必须写成 add "3月22日 跳舞" --date tomorrow✅ 完整示例（含实际要执行的命令）：
| 用户说的话 | 必须执行的命令 |
|---|---|
| "明天2点开会"（假设明天3月22日） | python tasks_tool.py add "3月22日 开会" --date tomorrow --time 14:00 --target reminder + python icloud_calendar.py new tomorrow 14:00 15:00 "开会" |
| "明天去洗车"（假设明天3月22日） | python tasks_tool.py add "3月22日 洗车" --date tomorrow --target reminder（不写日历） |
| "明天晚上去开会"（假设明天3月22日） | python tasks_tool.py add "3月22日 开会" --date tomorrow --target reminder（"晚上"不是具体时间，不写日历） |
| "去洗车"（无日期） | python tasks_tool.py add "洗车" --target reminder（标题不加日期前缀，不写日历） |
| "记一下：useEffect依赖数组为空时只执行一次" | python tasks_tool.py add "useEffect笔记" --target note --notes "依赖数组为空时只执行一次" |
智能解析：从自然语言中提取日期（"明天"、"下周三"）、时间（"下午2点"）、优先级（"重要"→high）
主动确认：命令执行成功后，简短确认告知用户：
合并整理：用户说"帮我看看明天的待办"时，调用 tasks_tool.py list --date tomorrow
手动同步：用户说"现在就推送到手机"时，调用 tasks_tool.py sync（不等定时任务）
同样遵守铁律：用户问健康相关问题时，直接运行分析命令，不要反问"你想分析哪天的？"——默认分析今天，用户没指定就用最新数据。
~/Library/Mobile Documents/com~apple~CloudDocs/Shortcuts/Health/health_YYYY-MM-DD.txtpython scripts/health_tool.py analyze <file> 或 python scripts/health_tool.py todaypython scripts/health_tool.py report <dir> --days 7python scripts/health_tool.py today 或 python scripts/health_tool.py analyze <file>，让脚本输出完整报告ICLOUD_USERNAME 和 ICLOUD_PASSWORD 是否已设置python scripts/icloud_tool.py login，不要再问用户要密码python scripts/icloud_tool.py verify <验证码>photos list 返回的是很久以前的照片（不是最近的），说明 session 或 pyicloud 版本有问题。解决方案：
ICLOUD_CHINA=1 已设置（中国大陆用户必须）python icloud_tool.py login + verifypip install --upgrade pyicloudpython icloud_tool.py photos albums
python icloud_tool.py photos list 20
python icloud_tool.py photos download 1
python icloud_tool.py drive list # 列出根目录
python icloud_tool.py drive list Work/Projects # 列出多级目录
python icloud_tool.py drive cd Downloads # 进入并列出文件夹
python icloud_tool.py drive download Work/doc.pdf # 下载文件
python icloud_tool.py drive download Work/doc.pdf ~/Desktop/doc.pdf # 下载到指定路径
python icloud_tool.py drive cat Work/notes.txt # 查看文本文件内容
python icloud_tool.py drive upload local.pdf Work # 上传文件
python icloud_tool.py drive mkdir Work/新项目 # 创建文件夹
python icloud_tool.py drive rename Work/旧名 新名 # 重命名
python icloud_tool.py drive delete Work/废弃文件.txt # 删除文件/文件夹
python icloud_tool.py devices # 列出所有设备（型号、电量、状态）
python icloud_tool.py find locate # 定位默认设备(iPhone)
python icloud_tool.py find locate iPad # 定位指定设备
python icloud_tool.py find status # 设备详细状态（电量、充电、位置）
python icloud_tool.py find play # 播放声音（找手机）
python icloud_tool.py find lost 13800138000 "请归还" # 启用丢失模式
python icloud_calendar.py list
python icloud_calendar.py today
python icloud_calendar.py week 7
python icloud_calendar.py new 2026-03-15 10:00 11:00 "开会"
python icloud_calendar.py new today "买牛奶" -c "家庭看板"
python icloud_calendar.py search 开会
python icloud_calendar.py delete 开会
选项: --calendar/-c 指定日历, --location/-l 地点, --description/-d 描述
# 登录（通过环境变量，非交互式）
export ICLOUD_USERNAME="邮箱"
export ICLOUD_PASSWORD="主密码"
python icloud_tool.py login # 尝试登录（如需2FA退出码为2）
python icloud_tool.py verify 123456 # 用2FA验证码完成登录
# Session 状态管理
python icloud_auth.py status # 检查 session
python icloud_auth.py refresh # 刷新
python icloud_auth.py logout # 清除
python tasks_tool.py add "开会" --date tomorrow --time 14:00 --priority high
python tasks_tool.py add "读书笔记" --target note --notes "第三章要点"
python tasks_tool.py add "买牛奶" --date 明天 --priority low
python tasks_tool.py list # 列出所有
python tasks_tool.py list --date tomorrow # 列出明天
python tasks_tool.py list --status pending # 列出未完成
python tasks_tool.py done <id> # 标记完成
python tasks_tool.py remove <id> # 删除
python tasks_tool.py edit <id> --title "新标题" --time 15:00
python tasks_tool.py clear --done # 清理已完成
python tasks_tool.py show # 显示完整 JSON
选项: --date 日期, --time 时间, --priority high/medium/low, --notes 备注, --target reminder/note, --list 列表名
python tasks_tool.py sync # 上传到 iCloud Drive
python tasks_tool.py sync --download # 从 iCloud 下载合并
python setup_tasks_cron.py install # 安装定时任务（默认每晚 21:00）
python setup_tasks_cron.py install --hour 22 # 安装定时任务（每晚 22:00）
python setup_tasks_cron.py uninstall # 卸载
python setup_tasks_cron.py status # 查看状态
用户对话 → tasks_tool.py add → ~/.openclaw/tasks.json (本地)
│
21:00 launchd 定时
│
┌─────────┴─────────┐
▼ ▼
Shortcuts/Tasks/ Shortcuts/Notes/
tasks_latest.json notes_latest.json
│ │
22:15 自动化 22:15 自动化
▼ ▼
iPhone 提醒事项 iPhone 备忘录
(逐条创建) (每天一条，标题为日期)
(导入后删除文件) (导入后删除文件)
用 iPhone 打开 iCloud 链接添加快捷指令： https://www.icloud.com/shortcuts/94862224a4b64ca0bf037b89c8f81cb7
快捷指令每天自动采集 4 项健康数据（步数、活动能量、心率详细、睡眠详细）， 保存为 TXT/JSON 到 iCloud Drive/Shortcuts/Health/。
python health_tool.py today # 分析今日数据
python health_tool.py analyze health_2026-03-10.txt # 分析单日文件
python health_tool.py analyze <dir> [--days 7] # 分析目录中所有数据
python health_tool.py report <dir> [--days 7] # 多日趋势报告
默认数据目录: ~/Library/Mobile Documents/com~apple~CloudDocs/Shortcuts/Health/
每日文件名: health_YYYY-MM-DD.txt（或 .json），内容为 JSON：
{
"date": "2026-03-10",
"steps": 5444,
"active_energy_kcal": 169.08,
"heart_rate": [{"t": "08:32", "v": 72}, ...],
"sleep": [{"start": "23:30", "end": "00:15", "type": "Core"}, ...]
}
| 服务 | 凭证 | 环境变量 | 获取方式 |
|---|---|---|---|
| iCloud 日历 | 应用专用密码 | ICLOUD_APP_PASSWORD | appleid.apple.com →「应用专用密码」生成 |
| iCloud 照片/Drive/设备/Health | Apple ID 邮箱 + 主密码 | ICLOUD_USERNAME + ICLOUD_PASSWORD | 用户直接提供给 AI，AI 通过环境变量自动登录 |
| Apple Health | (不需要) | (不需要) | iPhone 打开 iCloud 链接 导入快捷指令 |
| 待办同步 | 复用 iCloud 凭证 | (同上) | 本地 ~/.openclaw/tasks.json + iCloud Drive 同步 |
ICLOUD_CHINA=1~/.pyicloud/，过期时询问用户是否重新登录~/.openclaw/tasks.json，默认每晚 21:00 通过 launchd 自动上传（可通过 setup_tasks_cron.py install --hour X 自定义时间）scripts/
├── icloud_auth.py # iCloud 认证管理
├── icloud_tool.py # iCloud 照片 / Drive / 设备
├── icloud_calendar.py # iCloud 日历 (CalDAV)
├── health_tool.py # Apple Health 深度分析
├── tasks_tool.py # 待办事项管理（增删改查 + iCloud 同步）
├── setup_tasks_cron.py # 定时任务安装/卸载
└── generate_tasks_shortcut.py # iPhone 快捷指令创建指南
~/.openclaw/
├── tasks.json # 本地待办数据
└── logs/
└── tasks-sync.log # 同步日志