前言¶
Agent 能写代码、能读文档,但一被问到「明天下午两点有没有空」「帮我约下周三的评审会」,通常只能编一个时间,或者反问「你日历在哪」。原因是日历数据存在 Google Calendar、Apple Calendar、Outlook Calendar 这些平台里,Agent 既没有统一的读取入口,也没有写事件的权限。结果就是排期这件事只能回到人工打开日历应用去确认。
下面介绍的 Calendar,就是专门补上这一层的 Skill。
这是什么¶
Calendar 是一个面向 Agent 的日历管理与日程安排 Skill,坐标 @ndcccccc/calendar,发布者为 ndcccccc,当前版本 1.0.0,许可证 MIT-0,来源 ClawHub(SkillHub 上有同名镜像页面)。它的定位很窄:创建事件、管理会议、跨日历平台同步,让 Agent 能在对话里直接完成查空闲、建会议这类操作。
官方页面的安全审计标记为 Pass,不需要 API Key 即可安装(标签 requires_api_key=false)。
核心功能¶
SKILL.md 里列出的能力如下,全部来自上游页面:
- 创建事件(Create events)
- 安排会议(Schedule meetings)
- 设置提醒(Set reminders)
- 查看空闲时段(View availability)
- 重复事件(Recurring events)
- 日历同步(Calendar sync)
支持的日历平台:Google Calendar、Apple Calendar、Outlook Calendar。
需要说明的是,「跨平台同步」的具体实现方式,抓取到的资料里没有进一步描述。如果你的场景要求双向同步、冲突合并这类强语义,建议先在小范围测试再决定是否纳入生产流程。
安装与启用¶
官方给出的安装方式是通过 OpenClaw CLI:
openclaw skills install @ndcccccc/calendar
这条命令会把 Skill 拉到本地,安装完成后 Agent 即可在对话中调用。页面同时提供了 npx 方式的入口(npx skills),实际以你使用的 OpenClaw 版本为准。
关于 Cursor、Codex CLI、Claude Code 的差异:抓取到的资料里没有分别说明,因此这里不展开。这类通用 SKILL.md 格式的 Skill,通常做法是把 Skill 目录放到对应客户端识别的 skills 路径下,具体路径请以各客户端文档为准。
典型用法¶
上游页面给出的用法示例是直接用自然语言下达指令:
"Schedule meeting tomorrow at 2pm"
"Show my calendar for this week"
"Find free time for a 1-hour meeting"
对应到实际工作流,一般是先让 Agent 查空闲,再创建事件,最后确认写入结果:
1、先问空闲:「Find free time for a 1-hour meeting」,Agent 返回候选时段;
2、选定时段后下指令:「Schedule meeting tomorrow at 2pm」;
3、用「Show my calendar for this week」复核事件是否落在正确平台上。
这三句示例的返回格式,抓取到的资料里没有给出样例,需要你实际跑一次再固化到你的工作流里。
适用场景与注意¶
适合的场景:个人日程的查询与创建、会议排期的初步沟通、需要在对话里快速确认「某天有没有空」的 Agent 应用。如果你的 Agent 主要处理文档、代码这类任务,日历是低频但高价值的补充能力。
需要注意的地方:
- 跨平台同步的可靠性取决于各日历平台的授权与同步策略,资料中未给出实现细节,建议先做验证;
- 时间冲突判断依赖平台返回的空闲数据,如果某个日历没有授权给 Agent,可能出现「看起来空闲但实际已排满」的情况;
- 版本 1.0.0,上游页面显示最近更新于 5 个月前,功能稳定但迭代不活跃,遇到问题可能没有后续修复;
- 许可证 MIT-0 属于宽松许可,可自行改造,但官方仓库的更新需要你自己跟进。
结尾¶
Calendar 的价值在于把日历从「人打开应用去看」变成「Agent 在对话里直接操作」,能力列表不长,但覆盖了排期里最常用的几件事。如果你要给 Agent 加日历能力,它是一个可以直接试的选项。
官方地址:https://api.skillhub.cn/zcwl/calendar
上游仓库:https://clawhub.ai/ndcccccc/calendar