最近我在折腾 OpenClaw 的时候最让我眼前一亮的就是它的 Skill 机制。简单说Skill 就像给 AI 助手装上的“专用工具包”让它不只停留在聊天而是能真正操作你本地的 App 和服务。而在我试过的所有技能里apple-notes 技能是出镜率最高、也最让我觉得“这不就是私人助理吗”的一个——它能让 OpenClaw 直接读写你的苹果备忘录把碎片灵感、待办事项、阅读摘录统统丢进去再按需取出来。这篇内容适合两类人一类是刚接触 OpenClaw、想搞明白 Skill 到底怎么玩的读者另一类是已经在用 macOS 和 Apple Notes、想把它变成个人知识库入口的重度用户。我会从 Skill 的底层结构讲起再给你看一个能直接跑起来的 apple-notes 技能定义最后把我踩过的坑和排查思路一并交代清楚。如果你正准备把手边的笔记流程交给 AI 托管这篇就是把“能聊”变成“能干活”的关键一步。1. 先弄明白OpenClaw 的 Skill 机制到底是怎么回事1.1 为什么 Apple Notes 值得单独做一个 SkillOpenClaw 这类工具之所以强调 Skill是因为模型本身不擅长“精确控制系统命令”也不该让它靠瞎猜去拼命令。一个 Skill 本质上是把“用户意图 → 固定的工具调用 → 可校验的返回结果”这个闭环打包好让模型按模板走而不是自由发挥。Apple Notes 是我认为最适合先做的对象之一。它的同步机制非常省心你不需要自己搭服务器只要登录了 iCloudMac 上和手机上的笔记自动同步。这对 AI 助手来说意味着OpenClaw 在 Mac 上写入一条笔记几秒钟后你的 iPhone 上就能看到那种“无缝感”是很多第三方笔记工具做不到的。另一个原因是 Apple Notes 本身支持富文本、标签、文件夹、附件你不需要绕道去改一堆兼容性接口直接用系统能力就能把信息组织得有模有样。1.2 Skill 包的核心构成一个标准的 OpenClaw Skill 包通常包含三样东西SKILL.md主文件、资源文件夹放脚本或模板、以及一份可选的config.json。SKILL.md是整个技能的大脑用 Markdown 写成但里面塞满了结构化信息比如技能名称、触发条件、参数说明、调用示例。OpenClaw 在收到用户请求后会先读这个文件把里面定义的“动作”匹配到当前对话然后决定执行哪些脚本。我见过不少人一上来就想写很复杂的代码其实没必要。Skill 的核心价值是“把复杂能力封装成自然语言可调用的接口”。你甚至可以不写一行真正的程序只用 AppleScript 或 shell 命令就能完成大部分笔记操作。关键是把接口定义清楚输入什么参数、执行什么操作、返回什么结果。就像一个服务端 API只不过消费方是 AI 模型。2. apple-notes 技能的核心能力拆解2.1 能做的事从建笔记到全文检索apple-notes 技能最常见的动作有这么几类新建笔记指定标题、正文内容甚至可以指定存放的文件夹。追加内容在已有笔记末尾追加一段文字适合做日志和每日记录。搜索笔记按关键词搜标题和正文返回匹配列表。读取笔记取回指定笔记的全文内容方便后续继续处理。列出文件夹把当前账号下所有顶层文件夹列出来便于定位。这些能力组合起来能解决一个很实际的需求把“随手记”变成“无感记”。比如你在写代码时突然想到一个 bug 修复思路直接对助手说“记录一条笔记关于缓存穿透的临时想法放在开发日志目录”OpenClaw 就会调用 skill创建笔记并归到对应文件夹。全程不需要切换到备忘录 App也不打断当前思路。2.2 能力边界哪些做不了为什么做不了我先泼盆冷水Apple Notes 的自动化能力并没有想象中开放。它没有公开的第三方 APImacOS 上最直接的方式是 AppleScript但 AppleScript 能访问的 Notes 功能也是有限的。比如你不能通过它修改笔记的富文本格式也不能删除带有特定附件内容的笔记。另外普通权限下你只能操作当前登录账户的笔记如果你的 Apple ID 开启了“单独加密备忘录”或某些企业托管配置技能就会碰壁。所以在设计技能的时候别想着“接管全部备忘录”。我的做法是只实现高频操作增、查、读不做修改和删除这类低频且容易误伤的操作。AI 助手一旦能批量删笔记风险就大了这属于安全红线。把边界设清楚既是保护自己也是让技能用起来更可靠。3. 手把手实现一个可用的 apple-notes 技能3.1 环境准备与权限配置在写 Skill 之前先要让你的 Mac 允许 OpenClaw 控制备忘录。这里分两层第一层是“自动化权限”第二层是“辅助功能权限”。OpenClaw 本质上是另一个进程在调用系统能力所以在 macOS 上第一次执行 AppleScript 控制备忘录时系统会弹窗询问是否允许“终端”或“OpenClaw 宿主程序”控制 Apple Notes。这个弹窗一定不要点掉否则技能永远跑不了。如果你之前误点了“不允许”要去系统设置的“隐私与安全性”里找到自动化列表手动把宿主程序的开关打开。第二层是辅助功能。如果要执行更深入的键盘输入或读取其他 App 的界面需要辅助功能权限但纯粹访问 Notes 数据库文件不是必需。我建议只用 AppleScript避免过度授权。3.2 技能定义文件示例与核心参数解析下面给你一个最小可用的 Skill 定义骨架我已经在本地实测过。--- name: apple_notes description: 操作 Apple Notes支持新建、追加、搜索和读取备忘录。 trigger_keywords: [笔记, 备忘录, Apple Notes] --- ## Actions ### action: create_note - 描述: 新建一条笔记 - 参数: - title (string, required): 备忘录标题 - body (string, required): 备忘录正文 - folder (string, optional): 目标文件夹名称缺省为默认文件夹 - 执行脚本: scripts/create_note.applescript - 返回: 创建的笔记的唯一标识 ### action: search_notes - 描述: 按关键词搜索备忘录 - 参数: - query (string, required): 关键词 - limit (integer, optional): 最大返回条数默认 5 - 执行脚本: scripts/search_notes.applescript - 返回: 匹配的标题列表及 URL你可能会问为什么用trigger_keywords因为 OpenClaw 需要在对话里快速判断该不该唤起这个技能。关键词写得越具体误触发就越少。我在实际使用中会把“备忘录”“笔记”“随手记”都加进去但避免加太泛的词比如“记一下”否则很容易和待办事项技能抢任务。3.3 让 OpenClaw 调用系统能力的几种方式这里插一个很多人容易迷糊的点OpenClaw 本身并没有内置“操作 Apple Notes”的能力它只是负责理解语言、发起调用。真正干活的其实是脚本。你可以在 Skill 里用 AppleScript也可以用 shell 调用osascript甚至可以用 Python 读写 CoreData 数据库但复杂度完全不同。我推荐用 AppleScript因为它最贴近“系统原生”。比如新建笔记的脚本长这样on run argv set argTitle to item 1 of argv set argBody to item 2 of argv set targetFolder to 默认文件夹 if (count of argv) 2 then set targetFolder to item 3 of argv end if tell application Notes set newFolder to first folder whose name is targetFolder set newNote to make new note at newFolder with properties {name:argTitle, body:argBody} return id of newNote end tell end run这段代码的逻辑非常直白接收三个参数找到目标文件夹创建一条笔记返回它的 ID。这里有个细节body属性传入的文本不能包含换行符表示的纯文本以外的东西如果你想存多段内容建议用 或 AppleScript 的linefeed来拼接否则最终笔记会是一整行。我通常会把从模型那里拿到的正文先做一次换行符标准化再传给脚本能省掉不少后续整理时间。4. 真实场景实测几个我反复在用的组合指令4.1 “快速记录”场景我现在最常用的一个指令是“记录一下XX 项目的 API 网关在高峰期有连接池耗尽风险具体思路是把超时时间从 5s 调到 3s并增加重试退避。” 这段话丢给 OpenClaw它会自动提取 title 和 body调用create_note最后返回“已保存”。在这个场景里考验的是参数抽取能力。如果模型把整个句子都当成 title正文就空了。所以我会在 Skill 定义里加一条规则title 不能超过 30 个字超出部分自动截断正文保持完整。这样即使模型的抽取不太精准最终笔记也不会太乱。4.2 “整理阅读清单”场景另一个我从手机侧受益很多的玩法是“聚合收藏”。当我看到一篇值得细读的文章直接说“存到我的待读列表标题是《如何设计数据流管道》来源是某公众号链接我回头再补”。OpenClaw 会搜索或新建一条“待读列表”笔记然后把这条信息追加进去。如果你的列表太长可能一条笔记会变得臃肿。我的建议是给待读列表做分月笔记比如“待读-2025-06”每次追加前先搜索是否存在存在就追加不存在就新建。这个逻辑写进 Skill 的本地逻辑里交给模型判断体验很好。5. 踩坑记录与排查思路5.1 备忘录权限弹窗一直不出来怎么办很多人在第一次跑技能时发现没有任何反应也没有权限弹窗。我遇到过的原因有两个一是宿主程序被系统“静默”拦截了二是 AppleScript 里tell application Notes写错了 App 名字导致根本没触发权限请求。排查方法是先手动在终端执行一行最简单的osascript -e tell application Notes to get name of first folder如果这时弹出权限窗口说明是 OpenClaw 封装时没把宿主进程暴露给系统如果还是没反应用log show --last 5m --predicate eventMessage contains TCC看看隐私决策记录。大部分问题都能在这里找到答案。5.2 中文笔记搜索不到内容AppleScript 的search命令对中文的匹配比较奇怪。你搜索“缓存”两个字有时只能返回标题含“缓存”的笔记正文里的内容搜不到。这不是你的 skill 写错而是系统自带的搜索逻辑就偏弱。我的规避方案是不依赖系统搜索而是改用notes whose body contains query这种遍历方式注意这样性能很差。另一种更快的做法是把备忘录定期导出成纯文本或 JSON放进本地索引让 OpenClaw 用文件检索来做搜索。如果笔记总量不大直接遍历也够用超过几百条再考虑建索引。5.3 技能超时和重试机制AppleScript 执行一般很快但如果你触发了一个遍历搜索或者备忘录里有大量附件某些操作会阻塞。OpenClaw 默认可能有较短的超时限制技能一旦超时用户看到的就只是“处理失败”。我习惯在 Skill 定义里把timeout参数调大比如 30 秒同时在脚本内部主动设置with timeout语句。对于可能耗时的搜索我会在返回结果里附带一个进度提示让模型知道“操作还在进行中”。这不算最佳实践但在没有原生异步支持的阶段这样最省事。6. 进阶扩展还能往哪个方向玩6.1 本地知识库联动单一技能玩熟了以后可以把它和其他 Skill 串起来。我现在做的一个小实验是当用户问“整理一下本周的灵感”时OpenClaw 先调 apple-notes 技能搜索所有带“灵感”标签的笔记再调一个 markdown 转换技能把它们合并成一篇周报草稿最后放到 Obsidian 的文件夹里。整个过程是多个技能串联而不是每个技能单打独斗。这种组合的威力在于OpenClaw 能充当“调度中枢”而每个 Skill 是微服务。你不需要写复杂的接口协议只要定义好前一个技能的返回格式能作为后一个技能的输入就行。我建议大家在命名返回字段时尽量统一比如 always 返回id、title、content、updated_at这样串接时不用反复适配。6.2 语音触发与自动化工作流因为 Apple Notes 在手机和 Mac 上是同步的你还可以把它接到快捷指令上。比如我在手机端设置了一个语音快捷指令“记到隔空投递里”它会把剪贴板内容发到一个本地 WebhookOpenClaw 收到后调用 apple-notes 技能存成备忘。这就等于给你的 Apple Notes 装了一个 AI 语音入口连 Apple Watch 都能用。不过这里要特别注意语音转文字的结果经常有断句问题。我会在 Skill 里加一个“正文清洗”步骤把“呃”“那个”这类语气词去掉并对连续标点做规整。看起来是小事但直接影响笔记的可读性。最后再分享一个小技巧Apple Notes 的笔记 ID 是全局唯一的你在 Skill 里返回 ID 后可以把 ID 存到一个本地映射表里这样以后想对同一篇笔记追加内容就不用重新搜索了。实际测试中用 ID 比用标题定位稳定得多因为标题偶尔会重复。如果你也准备长期用这个技能建议从第一天就把 ID 作为核心索引字段来用而不是依赖标题。