cal-candy: a Markdown calendar — cal-candy — Markdown本地日历

Name: cal-candy: a Markdown calendar — cal-candy — Markdown本地日历
Author: Jay

Jay

cal-candy: a Markdown calendar — cal-candy — Markdown本地日历

v1.0.1

基于本地Markdown文件的日历管理工具，支持添加、列出、查看月历、查看今日/即将到来的事件、设置提醒和删除事件。

0· 120·0 当前·0 累计

by @goog (Jay)·MIT-0

生产力工具通信工具

下载技能包

License

MIT-0

最后更新

2026/4/3

安全扫描

VirusTotal

无害

查看报告

OpenClaw

安全

high confidence

该技能内部一致：管理~/.openclaw/workspace/calendar下的本地Markdown日历文件，仅读取/写入这些文件，不请求凭据或网络访问。

评估建议

该技能似乎能实现其描述的功能：将日历条目和提醒存储在~/.openclaw/workspace/calendar（或MDCAL_DIR环境变量指定的目录）下的文件中。安装前请考虑：(1) 仓库/来源标记为未知且未提供主页——如果来源很重要，请验证作者身份或检查附带的脚本（您已有）；(2) 它需要Python和'rich'包但未声明依赖——请在您的环境或虚拟环境中安装这些；(3) 脚本会将文件写入您的家目录（日历Markdown文件和reminders.json），因此请备份或选择自定义MDCAL_DIR；(4) 事件ID仅为UUID的前5个字符（碰撞风险较高）——避免依赖ID进行关键自动化操作。如需额外谨慎，请在沙盒环境中运行脚本或审查/修改代码以符合您的安全/隐私策略。...

详细分析 ▾

✓ 用途与能力

名称/描述与实现匹配：该脚本针对每个用户的日历目录中的Markdown文件实现add、list、view、today、upcoming、remind和delete操作。可选的MDCAL_DIR环境变量按文档使用。

✓ 指令范围

SKILL.md指示代理运行`python scripts/mdcal.py <command>`。运行时操作仅限于创建/读取/写入~/.openclaw/workspace/calendar/*.md和reminders.json。没有读取无关文件、联系外部服务或收集密钥的指令。

ℹ 安装机制

未提供安装规范（仅指令），这使风险较低。但是，脚本导入第三方'rich' Python包，但SKILL.md未声明Python版本或依赖；环境必须已安装Python和'rich'包，否则脚本将失败。没有网络下载或外部安装程序。

✓ 凭证需求

该技能不请求凭据，使用单个可选环境变量(MDCAL_DIR)来覆盖日历位置，这与其功能相称。它确实按预期在用户家目录下写入文件。

✓ 持久化与权限

该技能不是始终启用的，可由用户调用。它不修改其他技能或全局代理设置。其持久性产物是用户工作区目录中的日历Markdown文件和reminders.json。

安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

查看条款 ↗

运行时依赖

无特殊依赖

版本

latestv1.0.12026/3/22

- 新增支持通过MDCAL_DIR环境变量配置日历存储目录。- 澄清默认存储位置并更新文档以反映可配置的数据目录。- 改进添加带引号标题事件的文档示例。

● 无害

安装命令点击复制

官方npx clawhub@latest install cal-candy

镜像加速npx clawhub@latest install cal-candy --registry https://cn.clawhub-mirror.com

技能文档

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

快速开始

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

添加事件

python scripts/mdcal.py add    [desc] [-r minutes]
</code></pre><ul><li><code>date</code>: 日期 (YYYY-MM-DD) 或 <code>today</code>/<code>tomorrow</code></li>
<li><code>time</code>: 时间 (HH:MM)</li>
<li><code>title</code>: 事件标题</li>
<li><code>desc</code>: 可选描述</li>
<li><code>-r</code>: 可选提醒（提前分钟数）</li></ul><p><strong>示例:</strong></p><pre><code>python scripts/mdcal.py add today 14:00 团队会议 :: 讨论项目进度 -r 15
python scripts/mdcal.py add 2026-04-01 10:00 "openclaw meeting"
</code></pre><h3>查看事件</h3><pre><code>python scripts/mdcal.py list [month] [-a]
</code></pre><ul><li><code>month</code>: 月份 (YYYY-MM 或 MM)，默认当月</li>
<li><code>-a</code>: 显示所有事件包括过去的</li></ul><p><strong>示例:</strong></p><pre><code>python scripts/mdcal.py list # 当月事件
python scripts/mdcal.py list -a # 显示所有
python scripts/mdcal.py list 2026-03 # 指定月
</code></pre><h3>日历视图</h3><pre><code>python scripts/mdcal.py view [year] [month]
</code></pre><p>以日历格式显示本月或指定月份。</p><h3>今日事件</h3><pre><code>python scripts/mdcal.py today
</code></pre><h3>即将到来</h3><pre><code>python scripts/mdcal.py upcoming [-d days]
</code></pre><p>默认显示未来7天事件。</p><h3>设置提醒</h3><pre><code>python scripts/mdcal.py remind [event_id] [minutes]
</code></pre><p>查看或设置事件提醒。</p><h3>删除事件</h3><pre><code>python scripts/mdcal.py delete <event_id>
</code></pre><p>事件ID为5位UUID，列出会显示在事件后面。</p><h2>数据存储</h2><ul><li><strong>日历文件</strong>: <code>~/.openclaw/workspace/calendar/YYYY-MM.md</code></li>
<li><strong>提醒文件</strong>: <code>~/.openclaw/workspace/calendar/reminders.json</code></li></ul><p>事件格式：</p><pre><code>- [ ] 2026-03-22 14:00 会议标题 :: 描述 #abc12
</code></pre><h2>常用场景</h2><ul><li><strong>查看今天有啥安排</strong>: <code>python scripts/mdcal.py today</code></li>
<li><strong>查看本月日程</strong>: <code>python scripts/mdcal.py list</code></li>
<li><strong>添加会议</strong>: <code>python scripts/mdcal.py add tomorrow 15:00 会议 :: 讨论Q1目标 -r 10</code></li>
<li><strong>添加提醒</strong>: <code>python scripts/mdcal.py remind <event_id> 15</code></li></ul></div><div id="doc-en" class="skill-content lang-en" style="display:none"><p>基于本地 Markdown 文件的日历系统，事件默认存储在 <code>~/.openclaw/workspace/calendar/</code> 目录, user can set the location by env MDCAL_DIR。</p><h2>快速开始</h2><p>所有命令通过 <code>python scripts/mdcal.py <command></code> 执行：</p><h3>添加事件</h3>
<pre><code>python scripts/mdcal.py add <date> <time> <title> [desc] [-r minutes]
</code></pre>
<ul><li><code>date</code>: 日期 (YYYY-MM-DD) 或 <code>today</code>/<code>tomorrow</code></li>
<li><code>time</code>: 时间 (HH:MM)</li>
<li><code>title</code>: 事件标题</li>
<li><code>desc</code>: 可选描述</li>
<li><code>-r</code>: 可选提醒（提前分钟数）</li></ul><p><strong>示例:</strong>
<pre><code>python scripts/mdcal.py add today 14:00 团队会议 :: 讨论项目进度 -r 15
python scripts/mdcal.py add 2026-04-01 10:00 "openclaw meeting"
</code></pre><h3>查看事件</h3>
<pre><code>python scripts/mdcal.py list [month] [-a]
</code></pre>
<ul><li><code>month</code>: 月份 (YYYY-MM 或 MM)，默认当月</li>
<li><code>-a</code>: 显示所有事件包括过去的</li></ul><p><strong>示例:</strong>
<pre><code>python scripts/mdcal.py list          # 当月事件
python scripts/mdcal.py list -a       # 显示所有
python scripts/mdcal.py list 2026-03  # 指定月
</code></pre><h3>日历视图</h3>
<pre><code>python scripts/mdcal.py view [year] [month]
</code></pre>
以日历格式显示本月或指定月份。</p><h3>今日事件</h3>
<pre><code>python scripts/mdcal.py today
</code></pre><h3>即将到来</h3>
<pre><code>python scripts/mdcal.py upcoming [-d days]
</code></pre>
默认显示未来7天事件。</p><h3>设置提醒</h3>
<pre><code>python scripts/mdcal.py remind [event_id] [minutes]
</code></pre>
查看或设置事件提醒。</p><h3>删除事件</h3>
<pre><code>python scripts/mdcal.py delete <event_id>
</code></pre>
事件ID为5位UUID，列出会显示在事件后面。</p><h2>数据存储</h2><ul><li><strong>日历文件</strong>: <code>~/.openclaw/workspace/calendar/YYYY-MM.md</code></li>
<li><strong>提醒文件</strong>: <code>~/.openclaw/workspace/calendar/reminders.json</code></li></ul><p>事件格式：
<pre><code>- [ ] 2026-03-22 14:00 会议标题 :: 描述 #abc12
</code></pre><h2>常用场景</h2><ul><li><strong>查看今天有啥安排</strong>: <code>python scripts/mdcal.py today</code></li>
<li><strong>查看本月日程</strong>: <code>python scripts/mdcal.py list</code></li>
<li><strong>添加会议</strong>: <code>python scripts/mdcal.py add tomorrow 15:00 会议 :: 讨论Q1目标 -r 10</code></li>
<li><strong>添加提醒</strong>: <code>python scripts/mdcal.py remind <event_id> 15</code></li>
</ul></div></div>
<div style="text-align:center;padding:var(--spacing-4);font-size:12px;color:var(--color-gray-400)">数据来源：<a href="https://clawhub.ai/goog/cal-candy" target="_blank" style="color:var(--color-gray-400)">ClawHub ↗</a> · 中文优化：龙虾技能库</div>
</section>
<section class="cta-card" aria-label="定制服务">
  <div style="display:flex;align-items:center;gap:16px;flex-wrap:wrap">
    <div style="flex:1;min-width:280px">
      <div style="font-size:var(--font-size-md);font-weight:700;color:var(--color-text);margin-bottom:6px"><svg width="1em" height="1em" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="vertical-align:-0.125em"><path d="M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.77-3.77a6 6 0 0 1-7.94 7.94l-6.91 6.91a2.12 2.12 0 0 1-3-3l6.91-6.91a6 6 0 0 1 7.94-7.94l-3.76 3.76z"/></svg> OpenClaw 技能定制 / 插件定制 / 私有工作流定制</div>
      <p style="font-size:var(--font-size-sm);color:var(--color-warning);margin-bottom:0;line-height:1.5"><svg width="1em" height="1em" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="vertical-align:-0.125em"><path d="M10.29 3.86 1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z"/><line x1="12" y1="9" x2="12" y2="13"/><line x1="12" y1="17" x2="12.01" y2="17"/></svg> 免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制</p>
    </div>
    <a href="/custom" class="btn-cta">了解定制服务</a>
  </div>
</section>
</article>
<script>
function switchLang(lang){
  document.querySelectorAll('.i18n').forEach(function(el){
    var v=el.getAttribute('data-'+lang);
    if(v)el.innerHTML=v;
  });
  document.querySelectorAll('.lang-cn').forEach(function(el){el.style.display=lang==='cn'?'block':'none'});
  document.querySelectorAll('.lang-en').forEach(function(el){el.style.display=lang==='en'?'block':'none'});
  document.querySelectorAll('.sk-lgb').forEach(function(b){b.classList.remove('sk-lga')});
  var btn=document.getElementById('lang-'+lang);if(btn)btn.classList.add('sk-lga');
}
</script>
<style>
.sk-hero{border:1px solid var(--color-border);border-radius:12px;padding:22px;background:var(--color-bg-card);margin-bottom:16px;box-shadow:0 4px 12px rgba(0,0,0,.08)}
.sk-hero-main{display:flex;gap:24px}.sk-hero-left{flex:1;min-width:0}.sk-hero-right{width:200px;flex-shrink:0;display:flex;flex-direction:column;gap:10px}
.sk-tr{display:flex;align-items:center;gap:10px;flex-wrap:wrap;margin-bottom:4px}.sk-t{font-size:20px;font-weight:700;margin:0;line-height:1.3}
.sk-d{font-size:14px;color:var(--color-text-secondary);line-height:1.6;margin:8px 0 12px}
.sk-sr{display:flex;align-items:center;gap:8px;flex-wrap:wrap;font-size:13px;color:var(--color-text-secondary)}.sk-dot{color:var(--color-gray-400);opacity:.5}
.sk-au{font-size:13px;color:var(--color-text-muted);margin-top:4px}.sk-au a{color:var(--color-primary)}
.sk-lbox{font-size:13px;color:var(--color-text-secondary)}.sk-lbl2{font-size:11px;font-weight:600;color:var(--color-text-muted);margin-bottom:2px}
.sk-bdl{display:block;text-align:center;min-height:48px;line-height:20px;border-radius:12px;font-size:1.05rem;font-weight:600;padding:0.75rem 2rem;transition:background 0.2s}
.sk-bdl:hover{text-decoration:none;color:#fff;background:#333}
.btn--dark.sk-bdl{background:#1a1a1a;color:#fff;border:none}
.btn--dark.sk-bdl:hover{background:#333;color:#fff;transform:translateY(-1px);box-shadow:0 4px 12px rgba(0,0,0,0.15)}
.btn--dark.sk-bdl:active{transform:translateY(0);box-shadow:none}
[data-theme="dark"] .btn--dark.sk-bdl{background:#e0e0e0;color:#1a1a1a}
[data-theme="dark"] .btn--dark.sk-bdl:hover{background:#ccc;color:#1a1a1a;box-shadow:0 4px 12px rgba(255,255,255,0.08)}
[data-theme="dark"] .btn--dark.sk-bdl:active{background:#bbb;box-shadow:none}
.sk-sc{border:1px solid var(--color-border);border-radius:12px;padding:16px;margin-bottom:16px;background:var(--color-bg-card)}
.sk-sc--safe{border-left:4px solid #67C23A}
.sk-sc--suspicious{border-left:4px solid #E6A23C}
.sk-sc--dangerous{border-left:4px solid #F56C6C}
.sk-sch{font-size:15px;font-weight:700;margin-bottom:12px}
.sk-scr{display:flex;align-items:center;gap:12px;padding:8px 12px;background:var(--color-gray-100);border-radius:8px;margin-bottom:8px}
.sk-scw{font-size:13px;font-weight:600;min-width:120px}.sk-scs{font-size:13px;font-weight:700}.sk-scl{font-size:12px;color:var(--color-primary);margin-left:auto}
.sk-scsm{font-size:13px;color:var(--color-text-secondary);line-height:1.6;padding:8px 12px;background:var(--color-gray-100);border-radius:8px;margin-bottom:8px}
.sk-scd{margin-top:4px}.sk-scd summary{cursor:pointer;color:var(--color-primary);font-size:13px;font-weight:600;padding:4px 0}
.sk-dm{padding:8px 12px;background:var(--color-gray-100);border-radius:8px;font-size:13px;margin-bottom:4px}
.sk-adv{margin-top:8px;padding:12px;background:#FDF6EC;border:1px solid #FFEEBA;border-radius:8px}.sk-adv ol{margin:4px 0 0 16px;font-size:12px;color:var(--color-text-secondary);line-height:1.8}
.sk-ig{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:12px;margin-bottom:16px}
.sk-ib{border:1px solid var(--color-border);border-radius:12px;padding:16px;background:var(--color-bg-card)}.sk-ib h3{font-size:14px;font-weight:700;margin:0 0 12px}
.sk-lic-desc{font-size:12px;color:var(--color-text-secondary);line-height:1.5;margin:8px 0 0}
.sk-ii{font-size:13px;margin-bottom:4px;display:flex;align-items:center;gap:8px}.sk-il{color:var(--color-text-muted);min-width:50px;flex-shrink:0;font-size:12px}
.sk-ii code{background:var(--color-gray-100);padding:1px 6px;border-radius:4px;font-size:12px}
.sk-cm{font-family:monospace;font-size:13px;padding:12px;background:var(--color-gray-100);border:1px solid var(--color-border);border-radius:8px;margin-bottom:8px;cursor:pointer;word-break:break-all;transition:border-color 300ms}
.sk-cm:hover{border-color:var(--color-primary)}.sk-cl{font-size:11px;font-weight:600;color:var(--color-text-muted);display:block;margin-bottom:2px}
.sk-cma{background:var(--color-primary-light);border-color:var(--color-primary);color:var(--color-primary)}
.sk-cnn{background:#FDF6EC;border:1px solid #FFEEBA;border-radius:12px;padding:16px;margin-bottom:16px}.sk-cnn h3{font-size:15px;margin:0 0 8px}.sk-cnn p{font-size:14px;line-height:1.6;margin:0}
.sk-lgb{padding:4px 14px;border-radius:9999px;border:1px solid var(--color-border);background:var(--color-bg-card);color:var(--color-text-secondary);cursor:pointer;font-size:13px;transition:all .15s}
.sk-lgb:hover{border-color:var(--color-primary);color:var(--color-primary)}
.sk-lgb:active{transform:scale(0.96)}
.sk-lga{background:#1a1a1a;color:#fff;border-color:#1a1a1a}
[data-theme="dark"] .sk-lga{background:#555;color:#fff;border-color:#555}
.skill-content h2{font-size:20px;margin:24px 0 12px;padding-bottom:8px;border-bottom:1px solid var(--color-border)}
.skill-content h3{font-size:17px;margin:20px 0 8px}.skill-content p{margin-bottom:12px;line-height:1.8}
.skill-content ul,.skill-content ol{margin:8px 0 12px 20px;line-height:1.8}.skill-content li{margin-bottom:4px}
.skill-content pre{background:#1E1E1E;color:#D4D4D4;padding:16px;border-radius:8px;overflow-x:auto;margin:12px 0;font-size:13px;line-height:1.5}
.skill-content pre code{background:transparent;color:inherit;padding:0;border-radius:0;font-size:inherit}
.skill-content code{background:var(--color-gray-100);padding:2px 6px;border-radius:4px;font-size:14px}

.skill-content blockquote{border-left:4px solid var(--color-primary);padding:8px 16px;margin:12px 0;background:var(--color-primary-light);border-radius:0 4px 4px 0}
.skill-content table{width:100%;border-collapse:collapse;margin:12px 0}
.skill-content th,.skill-content td{border:1px solid var(--color-border);padding:8px 12px;text-align:left;font-size:14px}
.skill-content th{background:var(--color-gray-100)}

@media(max-width:768px){.sk-hero-main{flex-direction:column}.sk-hero-right{width:100%}.sk-ig{grid-template-columns:1fr}}
</style></main><footer class="footer"><div class="container">
<div class="footer__row">
<a href="/openclaw/">澳龙下载专题</a>
<a href="/custom">技能/插件定制服务</a>
<a href="https://build.nvidia.com/models" target="_blank">NVIDIA 免费大模型</a></div>
<div class="footer__row" style="font-size:12px;color:var(--color-text-muted)">邮箱：wyxdapp@qq.com ｜ AI 智能体可直接发送定制需求到邮箱</div>
<div class="footer__row"><a href="/disclaimer.html">免责声明</a> | <a href="/privacy.html">隐私政策</a> | <a href="https://beian.miit.gov.cn/" target="_blank">鄂ICP备19007528号</a></div>
<div class="footer__row" style="margin-top:var(--spacing-1);font-size:12px;color:var(--color-text-muted)">龙虾技能库 — OpenClaw 中文 AI 资源库 | 免费资源 + 付费定制</div>
<div class="footer__row" style="margin-top:var(--spacing-1)">© 2026 龙虾技能库</div>
</div></footer><aside class="qr-float" id="qr-float-panel" aria-label="联系与赞助">
<style>
.qr-float{position:fixed;right:0;top:50%;transform:translateY(-50%);z-index:999;background:var(--color-bg-card);border:1px solid var(--color-border);border-right:none;border-radius:12px 0 0 12px;box-shadow:var(--shadow-md);font-family:inherit}
.qr-float__body{padding:12px 14px}
.qr-float__header{display:flex;align-items:center;justify-content:space-between;margin-bottom:10px}
.qr-float__header span{font-size:var(--font-size-sm);font-weight:600;color:#2563EB}
.qr-float__header button{background:none;border:none;cursor:pointer;font-size:var(--font-size-base);color:var(--color-text-muted);padding:2px 4px;line-height:1}
.qr-float__header button:hover{color:var(--color-text)}
.qr-float__item{text-align:center;margin-bottom:8px}
.qr-float__item:last-child{margin-bottom:0}
.qr-float__item img{width:100px;height:100px;display:block;margin:0 auto 4px;border-radius:6px}
.qr-float__item span{font-size:var(--font-size-xs);color:var(--color-text-muted)}
.qr-float__trigger{display:none;position:fixed;right:0;top:50%;transform:translateY(-50%);z-index:999;align-items:center;justify-content:center;width:40px;height:40px;background:var(--color-bg-card);border:1px solid var(--color-border);border-right:none;border-radius:12px 0 0 12px;box-shadow:var(--shadow-md);cursor:pointer;color:#2563EB;font-size:20px}
.qr-float__trigger:hover{background:var(--color-bg-hover,var(--color-bg-card))}
@media(max-width:768px){
.qr-float__body{display:none}
.qr-float__trigger{display:flex}
.qr-float__item img{width:80px;height:80px}
}
</style>
<div class="qr-float__body" id="qr-float-body">
<div class="qr-float__header">
<span>联系 & 赞助</span>
<button onclick="document.getElementById('qr-float-body').style.display='none';document.getElementById('qr-float-trigger').style.display='flex'" aria-label="收起面板">✕</button>
</div>
<div class="qr-float__item"><img src="/image/erweima.png" alt="站长微信二维码" loading="lazy"><span>关注站长微信</span></div>
<div class="qr-float__item"><img src="/image/weixinpay.png" alt="微信赞助收款码" loading="lazy"><span>微信赞助</span></div>
<div class="qr-float__item"><img src="/image/alipay.png" alt="支付宝赞助收款码" loading="lazy"><span>支付宝赞助</span></div>
</div>
<button class="qr-float__trigger" id="qr-float-trigger" onclick="document.getElementById('qr-float-body').style.display='block';document.getElementById('qr-float-trigger').style.display='none'" aria-label="展开联系与赞助面板"><svg width="1em" height="1em" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="vertical-align:-0.125em"><path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"/></svg></button>
</aside></body></html>

License

运行时依赖

版本

安装命令 点击复制

技能文档

快速开始

添加事件

安装命令点击复制