🎁 Get the FREE AI Skills Starter GuideSubscribe →
BytesAgainBytesAgain
🦀 ClawHub

Openclaw With Apple

by @gzww

Apple iCloud 全功能访问 + Apple Health 深度健康分析 + 双向待办同步

Versionv1.0.0
Downloads461
TERMINAL
clawhub install openclaw-with-apple

📖 About This Skill


name: OpenClaw with Apple description: Apple iCloud 全功能访问 + Apple Health 深度健康分析 + 双向待办同步 icon: 🍎 os: linux, macos version: 1.0.0 tools: pyicloud, caldav install: | pip install pyicloud caldav icalendar tags: icloud, health, tasks, reminders, notes

⛔ 铁律(最高优先级,必须无条件遵守)

用户在对话中提到任何行动事项(吃饭、开会、洗车、取快递等)或知识笔记时,你必须:

1. 立刻运行命令写入,不要口头回复"好的"然后什么都不做。 2. 不要反问"几点?""要我记吗?""记到哪儿?"——用户说了就是指令,直接执行。 3. 不要编造用户没说的信息(比如自己编一个时间)。 4. 先执行命令,再回复用户

该运行什么命令?

| 用户说的话 | 要运行的命令 | 说明 | |-----------|-------------|------| | "明天去吃烤肉"(行动,无具体时间) | 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 |

回复话术

  • 写了提醒事项:"已加到待办文件中,今晚九点自动同步至提醒事项 ✓"
  • 写了提醒事项+日历:"已加到待办文件和日历中,待办今晚九点同步至提醒事项 ✓📅"
  • 写了备忘录:"已加到备忘录文件中,今晚九点自动同步至备忘录 ✓"
  • 违反以上任何一条 = 严重错误。

    OpenClaw with Apple

    Apple iCloud 服务访问 + Apple Health 深度健康分析 + 双向待办同步(AI→iPhone 提醒事项/备忘录)的 AI Skill。


    🎯 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 邮箱 + 应用专用密码连接日历,后续需要其他功能时再补充主密码。

    #### 用户提供了 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       # 尝试登录
    

    脚本会自动判断是否需要双重认证:

  • 不需要 2FA → 直接登录成功
  • 需要 2FA(退出码 2)→ AI 立刻告知用户:
  • 你的 iPhone 上应该收到了一个 6 位验证码弹窗,把验证码发给我。
    ⚠️ 验证过程中 iPhone 可能会弹出两次验证码,这是正常的,请忽略第二次弹窗,只需要把第一次收到的验证码发给我就行。
    

    用户发来验证码后,AI 执行:

    python icloud_tool.py verify 123456    # 用验证码完成登录
    

    > 认证成功后 session 会被缓存到 ~/.pyicloud/,后续使用不再需要密码。

    验证成功后,进入第二步。


    第二步:依次询问并引导三个功能配置

    iCloud 登录完成后,依次询问用户是否需要以下三个功能。每个功能独立引导,用户可以选择全部启用或部分启用。


    #### 🏥 Health 健康分析配置

    先询问:

    你需要启用 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


    #### 📋 提醒事项(Tasks)配置

    你需要启用「提醒事项同步」功能吗?
    你平时跟我说的行动事项("明天开会"、"后天买牛奶"),
    我会自动写入待办文件,每晚推送到你 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


    #### 📝 备忘录(Notes)配置

    你需要启用「备忘录同步」功能吗?
    你跟我说的笔记、想法、灵感、会议纪要等,
    我会自动写入备忘录文件,每晚推送到你 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 采集时间

    现在你可以正常跟我聊天了,我会自动识别需要记录的内容。


    💡 AI 日常行为规则

    > 以下规则是对顶部铁律的详细补充。铁律优先级最高。

    用户问"xx怎么用"时

    > 当用户问某个功能怎么用、或者第一次使用某功能时,必须先引导用户完成 iPhone 端配置(参考上方对应功能的配置引导),不能直接教用法就完事。

    Tasks 相关

    1. 主动识别(最重要):用户说的话只要涉及以下任何一种,必须立即自动存储,无需用户明确说"帮我记": - 提醒类:开会、约会、取快递、交报告、还书、打电话、买东西、预约、面试、截止日期等 - 备忘类:笔记、想法、灵感、总结、读书笔记、会议纪要、学到的东西、要查的资料等 - 判断标准:如果这句话明天可能有用或需要被记住,就存 - 不存的情况:纯闲聊、问答、技术讨论、写代码、改 bug 等不涉及行动或记忆的对话

    2. 推送机制(重要):不论用户说的是"今天去干 XX"还是"明天去 XX"还是"下周去 XX",一律写入当天的 tasks 文件中,当天统一推送。推送后由 iPhone 提醒事项根据日期字段自行提醒。不要按日期分批推送、不要等到"明天"才推送明天的任务。

    3. ⛔ 标题日期格式规则(最重要,必须严格执行):iPhone 快捷指令无法读取提醒事项的 date/time 字段,所以 --date 参数只用于排序,用户在手机上只能看到 title 文本。因此:

    > 核心铁律:用户提到了日期 → 日期必须写进 title 第一个参数里,格式为 "X月X日 做某事"--date 字段照常传,但 title 里必须重复写日期!

    - ✅ "明天去跳舞"(假设明天3月22日)→ python tasks_tool.py add "3月22日 跳舞" --date tomorrow --target reminder - ✅ "今天2点开会"(假设今天3月21日)→ python tasks_tool.py add "3月21日 开会" --date today --time 14:00 --target reminder - ✅ "下周三去体检"(假设下周三3月26日)→ python tasks_tool.py add "3月26日 体检" --date 2026-03-26 --target reminder - ✅ "去洗车"(无日期)→ python tasks_tool.py add "洗车" --target reminder(不加日期前缀) - ⛔ 严禁:用户说"明天去跳舞",你传 add "跳舞" --date tomorrow——这样手机上只显示"跳舞",用户看不到是哪天的! - ⛔ 严禁:只依赖 --date 字段传日期而 title 里不写日期——date 字段在手机端不可见! - ⚠️ 日期前缀用 X月X日 格式(不带年份、不带星期),与事项之间用一个空格分隔

    4. 三种存储目标的判断规则(核心,严格执行)

    用户说了一句话后,按以下决策树判断写入哪里,并实际运行对应命令

       用户说的内容是什么类型?
       │
       ├─ 行动/事件类(开会、洗车、吃饭、取快递...)
       │   │
       │   ├─ 有具体时间点("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 "内容"
       

    严禁行为: - 用户没说几点,AI 自己脑补一个时间写进日历(如把"明天去洗车"变成"14:00 洗车") - 不执行任何命令,只在回复文字中说"已添加"或列日程表(这是欺骗用户!) - 严禁直接手写 JSON 文件推送到 iCloud Drive。所有待办/备忘录必须通过 tasks_tool.py add 写入本地,再通过 tasks_tool.py sync 推送。AI 不得自行生成 JSON 文件并上传,格式不一致会导致 iPhone 快捷指令崩溃。 - 用户提到了日期,但 title 参数里没写日期前缀(如 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 "依赖数组为空时只执行一次" |

    5. 智能解析:从自然语言中提取日期("明天"、"下周三")、时间("下午2点")、优先级("重要"→high) 6. 主动确认:命令执行成功后,简短确认告知用户: - 写了提醒事项:"已加到待办文件中,今晚九点自动同步至提醒事项 ✓" - 写了提醒事项+日历:"已加到待办文件和日历中,待办今晚九点同步至提醒事项 ✓📅" - 写了备忘录:"已加到备忘录文件中,今晚九点自动同步至备忘录 ✓" - 必须如实告知,不能说加了日历但实际没加,也不能没说几点就偷偷加日历 7. 合并整理:用户说"帮我看看明天的待办"时,调用 tasks_tool.py list --date tomorrow 8. 手动同步:用户说"现在就推送到手机"时,调用 tasks_tool.py sync(不等定时任务)

    Health 相关

    > 同样遵守铁律:用户问健康相关问题时,直接运行分析命令,不要反问"你想分析哪天的?"——默认分析今天,用户没指定就用最新数据。

    1. 定时报告:在用户设定的报告时间,自动读取 iCloud Drive 中最新的健康数据文件并生成深度分析 2. 文件路径~/Library/Mobile Documents/com~apple~CloudDocs/Shortcuts/Health/health_YYYY-MM-DD.txt 3. 分析命令python scripts/health_tool.py analyze python scripts/health_tool.py today 4. 用户主动询问:随时可以问健康相关问题,AI 自动读取对应日期的数据分析 5. 多日趋势python scripts/health_tool.py report

    --days 7 6. 必须使用 health_tool.py(最重要): - ⛔ 严禁 AI 自己看原始数据后手写健康报告。AI 没有 health_tool.py 那样的 1400 行深度分析能力(HRV 计算、睡眠周期分析、交叉关联等),手写出来的报告会非常简陋 - ✅ 必须运行 python scripts/health_tool.py todaypython scripts/health_tool.py analyze ,让脚本输出完整报告 - ✅ 脚本输出的所有内容(基础指标、心率详细、睡眠详细、深度分析、交叉关联、综合评定)必须原样呈现给用户,禁止 AI 自行二次总结或精简 - 用户喜欢判定性语句(如"HRV 低 + 睡眠不足 = 恢复能力严重受损"),这些是 health_tool.py 的核心价值,不要把它们吞掉

    iCloud 相关

    1. 用户提到日历、照片、文件、设备时,直接调用对应工具执行 2. 任何 iCloud 操作报错(含 session 过期)时,按以下顺序自动处理,不要卡住: - 第一步:检查环境变量 ICLOUD_USERNAMEICLOUD_PASSWORD 是否已设置 - 如果已设置 → 直接执行 python scripts/icloud_tool.py login,不要再问用户要密码 - 如果未设置 → 告知用户 session 过期,请求提供 Apple ID 邮箱和主密码 - 如果 login 触发 2FA(退出码 2)→ 立刻告知用户查看 iPhone 验证码弹窗 - 用户发来验证码后 → 立刻执行 python scripts/icloud_tool.py verify <验证码> - ⛔ 严禁行为:检测到 session 过期后只打印错误信息就停下来,必须立即尝试重新登录 3. 2FA 验证失败时:如果 verify 命令输出 503 相关错误,不要告诉用户密码错误,应该说"Apple 服务器暂时繁忙,请等 1-2 分钟后重试"。脚本已内置自动重试,大多数情况下会自动恢复 4. Find My 只能定位 Apple 设备(iPhone/iPad/Mac/AirTag),无法定位安卓/华为等非 Apple 设备 5. 照片显示异常:如果 photos list 返回的是很久以前的照片(不是最近的),说明 session 或 pyicloud 版本有问题。解决方案: - 确认环境变量 ICLOUD_CHINA=1 已设置(中国大陆用户必须) - 重新登录:python icloud_tool.py login + verify - 检查 pyicloud 版本:pip install --upgrade pyicloud


    📋 功能参考

    🍎 Apple iCloud

    #### 照片

    python icloud_tool.py photos albums
    python icloud_tool.py photos list 20
    python icloud_tool.py photos download 1
    

    #### iCloud Drive

    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                         # 列出所有设备(型号、电量、状态)
    

    #### 查找设备 (Find My)

    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 "请归还"   # 启用丢失模式
    

    #### 日历 (CalDAV)

    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 描述

    #### Session 管理

    # 登录(通过环境变量,非交互式)
    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 # 清除


    📋 待办同步 (Tasks)

    #### 管理待办

    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                      # 标记完成
    python tasks_tool.py remove                    # 删除
    python tasks_tool.py edit  --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 备忘录
                            (逐条创建)          (每天一条,标题为日期)
                            (导入后删除文件)     (导入后删除文件)
    


    🏥 Apple Health

    #### 导入快捷指令

    用 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   [--days 7]              # 分析目录中所有数据
    python health_tool.py report    [--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"}, ...]
    }
    

    #### 分析深度

  • 运动与代谢: 步数评估、每步能耗效率、活动强度判断
  • 心率:
  • - 静息心率 / 夜间精确静息心率 - HRV (RMSSD) 自主神经系统评估 - 心率突变事件检测(精确到时间点) - 昼夜心率差异分析 - 按时段分布(夜间/上午/下午/晚间)
  • 睡眠:
  • - 睡眠周期完整性(Deep→REM 循环计数) - Deep/REM/Core 前后半夜分布对比 - 碎片化指数、睡眠效率 - 最长连续睡眠段、夜间醒来次数 - 入睡时间与褪黑素窗口评估
  • 交叉关联:
  • - 低运动量 ↔ 低深度睡眠恶性循环检测 - 高运动量 + 睡眠不足 = 恢复失衡警告 - 心率偏高 + 低睡眠效率 = 慢性压力信号 - 晚睡 + 低活动量的昼夜节律紊乱
  • 综合评定: 0-100 分健康评分 + 等级判定

  • 🔐 凭证汇总

    | 服务 | 凭证 | 环境变量 | 获取方式 | |------|------|---------|---------| | 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 同步 |


    ⚠️ 注意事项

    1. iCloud 中国大陆:默认已启用 ICLOUD_CHINA=1 2. iCloud Session:缓存在 ~/.pyicloud/,过期时询问用户是否重新登录 3. 云上贵州 2FA 说明:中国大陆 iCloud(云上贵州)的 2FA 验证链路偶尔会出现 Apple 网关 503 错误。脚本已内置重试机制,如果仍然失败,等 1-2 分钟后重试即可。503 不是密码错误,是 Apple 服务器临时负载问题 4. Apple Health 零凭证:无需密码/token,通过 iCloud 链接导入快捷指令 5. Apple Health 权限:首次运行快捷指令需手动逐项授权(步数、心率、睡眠、活动能量) 6. Apple Health 共享数据:设置→快捷指令→高级→允许共享大量数据 7. Health 报告时间:必须晚于快捷指令的数据采集时间,否则数据不完整 8. 待办同步:本地数据在 ~/.openclaw/tasks.json,默认每晚 21:00 通过 launchd 自动上传(可通过 setup_tasks_cron.py install --hour X 自定义时间) 9. Tasks/Notes iPhone 端:Tasks Import 和 Notes Import 需设置在服务端推送时间之后执行(如服务端 21:00 → iPhone 22:15),各自读取对应文件夹中的 JSON 后删除文件


    📋 文件结构

    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 # 同步日志