Apple Notes管理助手

技能简介

notesctl 是一个面向 OpenClaw 的 Apple Notes 辅助技能，通过确定性脚本封装苹果备忘录操作，替代原有基于 UI 自动化的方案，避免生成标题为”New Notes”的错误笔记，并减少 LLM 调用次数。

业务背景

面向macOS用户的备忘录自动化场景，本技能以确定性脚本替代UI自动化操作，消除生成无标题笔记的差错，同时减少大语言模型调用开销。支持批量创建、检索与导出，让苹果备忘录成为结构化知识沉淀的可靠载体。

落地案例：项目经理需将每日站会纪要归档至Apple Notes的「项目文档」文件夹，以往UI自动化常产生「New Notes」空标题笔记。现通过notesctl传入JSON参数指定标题、正文与目标文件夹，一键生成格式规范的会议记录；月末按关键词搜索该文件夹内所有笔记，交互式选择后批量导出为本地文件备份。

能做什么

• 通过 JSON 或命令行参数创建新笔记（支持指定标题、正文、文件夹）
• 列出指定文件夹内的所有笔记
• 按关键词搜索笔记，可限定文件夹范围
• 交互式选择并导出笔记到指定目录

使用说明

环境要求：macOS 系统，需预先安装 python3、osascript 和 memo CLI 工具。

安装步骤：

1. 克隆或下载技能仓库到本地目录，如 /path/to/notesctl
2. 确保 scripts/ 目录下的 shell 脚本具有执行权限：chmod +x /path/to/notesctl/scripts/*.sh
3. 验证 memo 命令可用：which memo

常用操作：

1. 通过 JSON 创建笔记（推荐用于自动化）：

echo '{"title":"会议记录","body":"讨论要点\n待办事项","folder":"工作"}' | "/path/to/notesctl/scripts/notes_post.sh"

2. 直接传参创建笔记：

"/path/to/notesctl/scripts/notes_new.sh" "购物清单" $'牛奶\n鸡蛋\n面包' "个人"

3. 列出文件夹内笔记：

"/path/to/notesctl/scripts/notes_list.sh" "工作"

4. 搜索笔记：

# 全局搜索
"/path/to/notesctl/scripts/notes_search.sh" "项目计划"
# 限定文件夹搜索
"/path/to/notesctl/scripts/notes_search.sh" "项目计划" "工作"

5. 交互式导出笔记：

"/path/to/notesctl/scripts/notes_export.sh" "合同" "工作" "/Users/me/Documents"

输入与输出

见下方输入与输出表格。

风险提示

• 编辑现有笔记非默认工作流，因操作较脆弱；建议采用追加模式或创建新笔记替代
• 导出功能为交互式，需人工确认选择目标笔记
• 依赖 macOS 专有组件（osascript），无法在其他操作系统运行
• memo CLI 工具需单独安装，未包含在技能包内

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/clinchcc/notesctl-skill-for-openclaw/SKILL.md
来源类型：GitHub 仓库