← 返回 Skills 市场
ivy-end

Apple Calendar Ops

作者 ClawEnd · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ⚠ suspicious
558
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install apple-calendar-ops
功能描述
Read, create, update, and delete Apple Calendar events via CalDAV. Use when the user wants to inspect calendars or events, add a calendar event, change an ex...
使用说明 (SKILL.md)

Apple Calendar Ops

This skill is the Apple Calendar operation layer.

It handles stable calendar reads and writes. It does not do high-level scheduling, cross-system planning, or task prioritization.

Core boundary

Use this skill for concrete Apple Calendar operations:

  • list calendars
  • fetch events in a time range
  • create an event
  • update an event
  • delete an event

Do not use this skill to decide how the day should be planned. That belongs to a higher-level task/orchestrator.

Operating rules

Default stance:

  • reads are safe
  • writes should be dry-run-friendly
  • updates/deletes should prefer explicit event ids
  • fuzzy title matching may help locate events, but should not be the only basis for risky writes

Credentials should come from /home/agent/.openclaw/workspace/secrets.json.

Read references/boundary.md before changing the skill's scope. Read references/event-contract.md before writing or consuming event JSON.

Quick start

Read calendars

python3 /home/agent/.openclaw/workspace/skills/apple-calendar-ops/scripts/calendar_fetch.py --list-calendars

Read events

python3 /home/agent/.openclaw/workspace/skills/apple-calendar-ops/scripts/calendar_fetch.py \
  --start 2026-03-12T00:00:00+08:00 \
  --end 2026-03-13T00:00:00+08:00

Create event

python3 /home/agent/.openclaw/workspace/skills/apple-calendar-ops/scripts/calendar_create.py \
  --calendar "Calendar" \
  --title "Example event" \
  --start 2026-03-12T14:00:00+08:00 \
  --end 2026-03-12T15:00:00+08:00 \
  --dry-run

Scripts

  • scripts/calendar_common.py — shared config, secret loading, and JSON helpers
  • scripts/calendar_fetch.py — list calendars and fetch events
  • scripts/calendar_create.py — create an event
  • scripts/calendar_update.py — update an event
  • scripts/calendar_delete.py — delete an event

References

  • references/boundary.md — scope and non-goals
  • references/event-contract.md — normalized event shape for all scripts

First-version goal

Version 1 should make Apple Calendar readable and safely writable.

That means:

  • reliable read access for scheduler inputs
  • explicit create/update/delete flows
  • machine-readable output
  • conservative handling of risky writes
安全使用建议
This skill largely does what it claims (CalDAV read/write to Apple Calendar), but before installing you should: 1) Inspect /home/agent/.openclaw/workspace/secrets.json and ensure it only contains the appleCalendar keys (appleId and appSpecificPassword) — the skill reads the entire file. 2) Prefer using an Apple app‑specific password (not your main Apple password). 3) Confirm the caldav baseUrl (defaults to caldav.icloud.com) and any configured calendarUrls to restrict which calendars the skill can access. 4) Because the registry metadata does not declare the secrets/config path, treat that as a packaging omission — either update the registry entry or avoid running the skill until you can control where credentials come from. 5) Run first with --dry-run or --list-calendars to verify behavior. If you are not comfortable with a local secrets.json being read, do not install/run the skill until the credential handling is clarified.
功能分析
Type: OpenClaw Skill Name: apple-calendar-ops Version: 0.1.0 The skill bundle provides a standard implementation for managing Apple Calendar events via the CalDAV protocol. It includes scripts for fetching, creating, updating, and deleting events (calendar_fetch.py, calendar_create.py, etc.) and correctly handles credentials from the designated workspace secrets file. No evidence of data exfiltration to unauthorized endpoints, malicious execution, or prompt injection was found; the code uses standard libraries like urllib and icalendar for its stated purpose.
能力评估
Purpose & Capability
The code implements CalDAV operations (discover, list, fetch, create, update, delete) which matches the description. However the SKILL metadata declares no required config paths or credentials while the SKILL.md and the code hard‑code a secrets file path (/home/agent/.openclaw/workspace/secrets.json). The skill legitimately needs Apple ID + app‑specific password, but the registry metadata omission is an incoherence.
Instruction Scope
Runtime instructions and scripts are narrowly scoped to CalDAV operations and call only the CalDAV endpoint (default https://caldav.icloud.com). The SKILL.md explicitly instructs the agent to read a local secrets.json for credentials; the code's load_all_secrets() reads the whole JSON file. This is within expected scope for an Apple Calendar CalDAV tool, but the explicit dependency on a workspace secrets file should be noted and checked.
Install Mechanism
There is no install spec or external download. The skill is instruction-plus-scripts included in the bundle. No network install or archive extraction is performed at install time, which lowers install-time risk.
Credentials
The skill requires Apple credentials (appleId and appSpecificPassword) which are proportionate to CalDAV access. However the declared registry requirements list no env vars or config paths while the code expects and reads a workspace secrets.json containing these credentials. The code reads the full secrets.json (load_all_secrets()), not only the appleCalendar keys, so if that file contains unrelated sensitive values they would be accessible to this skill.
Persistence & Privilege
The skill does not request always:true and does not attempt to modify other skills or global agent settings. It runs as contained scripts and only acts when invoked.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install apple-calendar-ops
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /apple-calendar-ops 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.1.0
Initial release: Apple Calendar read/create/update/delete via CalDAV with structured JSON output.
元数据
Slug apple-calendar-ops
版本 0.1.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Apple Calendar Ops 是什么?

Read, create, update, and delete Apple Calendar events via CalDAV. Use when the user wants to inspect calendars or events, add a calendar event, change an ex... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 558 次。

如何安装 Apple Calendar Ops?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install apple-calendar-ops」即可一键安装,无需额外配置。

Apple Calendar Ops 是免费的吗?

是的,Apple Calendar Ops 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Apple Calendar Ops 支持哪些平台?

Apple Calendar Ops 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Apple Calendar Ops?

由 ClawEnd(@ivy-end)开发并维护,当前版本 v0.1.0。

💬 留言讨论