CalDAV日历同步

技能简介

本技能通过 vdirsyncer 与 khal 的组合，将 iCloud、Google、Fastmail、Nextcloud 等 CalDAV 服务端的日历数据同步到本地，支持离线查看、搜索和编辑日程事件。

能做什么

• 双向同步云端日历到本地 .ics 文件
• 按日期范围、关键词查询日程
• 创建、编辑、删除日历事件
• 自定义输出格式用于脚本处理
• 多账户、多日历统一管理

使用说明

安装指令：

sudo apt install vdirsyncer khal

配置步骤：

1. 创建 vdirsyncer 配置文件 ~/.config/vdirsyncer/config，填写 CalDAV 服务端地址、账号及密码获取方式
2. 创建 khal 配置文件 ~/.config/khal/config，指定本地日历存储路径
3. 首次执行 vdirsyncer discover 识别远程日历结构
4. 执行 vdirsyncer sync 完成初始同步

日常操作：

• 同步：vdirsyncer sync
• 查看今日日程：khal list
• 搜索事件：khal search "关键词"
• 新建事件：khal new 2026-01-15 10:00 11:00 "会议标题"
• 交互编辑：khal edit "搜索词"（完成后需再次同步）

输入与输出

见下方输入与输出表格。

风险提示

• 编辑操作依赖交互式 TTY，自动化场景需配合 tmux 等工具
• 密码明文存储或命令读取存在泄露风险，建议使用专用应用密码
• 缓存文件损坏可能导致数据显示异常，可手动删除重建
• 冲突解决策略配置不当可能造成数据覆盖

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/asleep123/caldav-calendar/SKILL.md
来源类型：GitHub 仓库