← 返回 Skills 市场

cal-candy: a Markdown calendar

Name: cal-candy: a Markdown calendar
Author: goog

作者 Jay · GitHub ↗ · v1.0.1 · MIT-0

cross-platform ✓ 安全检测通过

160

总下载

当前安装

版本数

在 OpenClaw 中安装

/install cal-candy

功能描述

Manage local markdown-based calendar: add, list, view monthly, check today/upcoming events, set reminders, and delete events efficiently.

使用说明 (SKILL.md)

Cal-Candy - Markdown Calendar

基于本地 Markdown 文件的日历系统，事件默认存储在 ~/.openclaw/workspace/calendar/ 目录, user can set the location by env MDCAL_DIR。

快速开始

所有命令通过 python scripts/mdcal.py \x3Ccommand> 执行：

添加事件

python scripts/mdcal.py add \x3Cdate> \x3Ctime> \x3Ctitle> [desc] [-r minutes]

date: 日期 (YYYY-MM-DD) 或 today/tomorrow
time: 时间 (HH:MM)
title: 事件标题
desc: 可选描述
-r: 可选提醒（提前分钟数）

示例:

python scripts/mdcal.py add today 14:00 团队会议 :: 讨论项目进度 -r 15
python scripts/mdcal.py add 2026-04-01 10:00 "openclaw meeting"

查看事件

python scripts/mdcal.py list [month] [-a]

month: 月份 (YYYY-MM 或 MM)，默认当月
-a: 显示所有事件包括过去的

示例:

python scripts/mdcal.py list          # 当月事件
python scripts/mdcal.py list -a       # 显示所有
python scripts/mdcal.py list 2026-03  # 指定月

日历视图

python scripts/mdcal.py view [year] [month]

以日历格式显示本月或指定月份。

今日事件

python scripts/mdcal.py today

即将到来

python scripts/mdcal.py upcoming [-d days]

默认显示未来7天事件。

设置提醒

python scripts/mdcal.py remind [event_id] [minutes]

查看或设置事件提醒。

删除事件

python scripts/mdcal.py delete \x3Cevent_id>

事件ID为5位UUID，列出会显示在事件后面。

数据存储

日历文件: ~/.openclaw/workspace/calendar/YYYY-MM.md
提醒文件: ~/.openclaw/workspace/calendar/reminders.json

事件格式：

- [ ] 2026-03-22 14:00 会议标题 :: 描述 #abc12

常用场景

查看今天有啥安排: python scripts/mdcal.py today
查看本月日程: python scripts/mdcal.py list
添加会议: python scripts/mdcal.py add tomorrow 15:00 会议 :: 讨论Q1目标 -r 10
添加提醒: python scripts/mdcal.py remind \x3Cevent_id> 15

安全使用建议

This skill appears to do what it says: it stores calendar entries and reminders as files under ~/.openclaw/workspace/calendar (or MDCAL_DIR if set). Before installing, consider: (1) the repository/source is listed as unknown and no homepage is provided — if provenance matters, verify the author or inspect the included scripts (you already have them); (2) it requires Python and the 'rich' package but does not declare dependencies — install those in your environment or a virtualenv; (3) the script writes files to your home directory (calendar Markdown files and reminders.json), so back them up or choose a custom MDCAL_DIR if you want them elsewhere; (4) event IDs are only the first 5 characters of a UUID (higher collision risk) — avoid relying on IDs for critical automation. If you want extra caution, run the script in a sandboxed environment or review/modify the code to suit your security/privacy policies.

功能分析

Type: OpenClaw Skill Name: cal-candy Version: 1.0.1 The cal-candy skill is a legitimate local calendar management tool that stores events in Markdown files and reminders in a JSON file within a dedicated workspace directory (~/.openclaw/workspace/calendar/). The Python script (scripts/mdcal.py) implements standard calendar functionality such as adding, listing, viewing, and deleting events without any high-risk behaviors like network access, shell execution, or sensitive data exfiltration.

能力评估

✓ Purpose & Capability

Name/description match the implementation: the script implements add, list, view, today, upcoming, remind, and delete operations against Markdown files in a per-user calendar directory. The optional MDCAL_DIR environment variable is used as documented.

✓ Instruction Scope

SKILL.md instructs the agent to run `python scripts/mdcal.py <command>`. The runtime actions are limited to creating/reading/writing ~/.openclaw/workspace/calendar/*.md and reminders.json. There are no instructions to read unrelated files, contact external services, or gather secrets.

ℹ Install Mechanism

No install spec is provided (instruction-only), which keeps risk low. However, the script imports the third-party 'rich' Python package but the SKILL.md does not declare Python version or dependencies; the environment must have Python and the 'rich' package installed or the script will fail. No network downloads or external installers are present.

✓ Credentials

The skill requests no credentials and uses a single optional env var (MDCAL_DIR) to override the calendar location, which is proportionate to its function. It does write files under the user's home directory as expected.

✓ Persistence & Privilege

The skill is not always-enabled and can be invoked by the user. It does not modify other skills or global agent settings. Its persistent artifacts are calendar Markdown files and reminders.json in the user's workspace directory.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install cal-candy
安装完成后，直接呼叫该 Skill 的名称或使用 /cal-candy 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.1

- Added support for configuring the calendar storage directory via the MDCAL_DIR environment variable. - Clarified default storage location and updated documentation to reflect configurable data directory. - Improved documentation examples for adding events with quoted titles.

v1.0.0

Initial release of cal-candy: a local, markdown-based calendar for event and reminder management. - Add calendar events with date, time, title, and optional description. - List upcoming or past events, including monthly and "today" views. - View events as a markdown calendar. - Set and manage reminders for events. - Delete events by unique ID. - All data stored locally in markdown and json files for privacy and simplicity.

元数据

Slug cal-candy

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题