MUFI Calendar

Google Calendar 与 Naver Calendar 集成管理技能，面向韩国中小型企业（SMB）客户。

功能

• ✅ 支持 Google Calendar 集成（查询 / 添加 / 修改 / 删除）
• ✅ 支持韩语自然语言解析（例如：“明天下午3点开会” → 自动创建日程）
• ✅ 支持日程提醒（通过 cron 触发）
• 🚧 正在开发 Naver Calendar 集成（浏览器自动化方式 或 iCal 订阅方式）

配置

1. Google Calendar API 配置

在 Google Cloud Console 中创建 OAuth 2.0 客户端 ID：

1. https://console.cloud.google.com/apis/credentials
2. 创建“OAuth 2.0 客户端 ID” → 选择“桌面应用”
3. 下载生成的 JSON 文件 → 保存至 ~/.secrets/google-calendar-credentials.json

2. 初始认证

node /Users/mupeng/.openclaw/workspace/skills/mufi-calendar/scripts/auth.js

系统将自动打开浏览器，引导完成 Google 账户登录认证 → 成功后生成 ~/.secrets/google-calendar-token.json

3. 环境变量（可选）

export GOOGLE_CALENDAR_ID="primary"  # 默认日历 ID（primary = 主日历）

使用方法

日程查询

# 查询今日日程
node scripts/list.js

# 查询明日日程
node scripts/list.js --date tomorrow

# 查询指定日期日程
node scripts/list.js --date 2026-02-20

# 查询未来7天日程
node scripts/list.js --days 7

# 以 JSON 格式输出
node scripts/list.js --json

添加日程（支持韩语自然语言）

# 使用韩语自然语言解析
node scripts/add.js "明天下午3点开会"
node scripts/add.js "2026-02-20 10:00 开发团队会议"
node scripts/add.js "下周星期一2点牙科预约"

# 显式指定参数
node scripts/add.js 
  --title "开发团队会议" 
  --start "2026-02-20T10:00:00+09:00" 
  --end "2026-02-20T11:00:00+09:00" 
  --location "总部会议室 A" 
  --description "Q1 Sprint 回顾"

修改日程

# 通过事件 ID 修改
node scripts/update.js EVENT_ID 
  --title "新标题" 
  --start "2026-02-20T15:00:00+09:00"

删除日程

node scripts/delete.js EVENT_ID

设置提醒

# 添加 cron 任务（每日上午9点推送当日日程提醒）
crontab -e
# 在 crontab 中新增以下行：
0 9 * * * node /Users/mupeng/.openclaw/workspace/skills/mufi-calendar/scripts/remind.js

韩语自然语言解析规则

scripts/parse-korean.js 支持识别以下模式：

• 日期：今天、明天、后天、下周星期一、2月20日、2026-02-20
• 时间：上午9点、下午3点、15:00、3点30分
• 持续时长：1小时、30分钟（自动推算结束时间）

示例：

"明天下午3点开会" 
→ 2026-02-18 15:00 ~ 16:00（默认时长为1小时）

"2月20日10点开发团队会议2小时"
→ 2026-02-20 10:00 ~ 12:00

"下周星期一2点牙科预约"
→ 2026-02-24 14:00 ~ 15:00

Naver Calendar 集成（实验性）

Naver Calendar 官方未提供公开 API，因此当前支持两种变通方案：

方案 1：iCal 订阅（只读）

1. 进入 Naver Calendar → 设置 → 复制 iCal 地址
2. 将该地址粘贴保存至 ~/.secrets/naver-calendar-ical-url.txt
3. 运行 node scripts/sync-naver.js → 将日程同步至 Google Calendar

方案 2：浏览器自动化（读写均可）

通过 OpenClaw 浏览器自动化操作 Naver Calendar：

# 添加日程
node scripts/naver-add.js "2026-02-20 10:00 会议"

# 查询日程（快照截图 + OCR 识别）
node scripts/naver-list.js

限制说明：需保持登录状态；若 Naver 页面 UI 发生变更，脚本需相应调整。

输出格式

文本格式（默认）

📅 2026-02-20 (Thu)
  10:00-11:00  开发团队会议
  15:00-16:00  会议

📅 2026-02-21 (Fri)
  全天  法定节假日

JSON 格式

{
  "events": [
    {
      "id": "abc123",
      "summary": "开发团队会议",
      "start": "2026-02-20T10:00:00+09:00",
      "end": "2026-02-20T11:00:00+09:00",
      "location": "总部会议室 A",
      "description": "Q1 Sprint 回顾"
    }
  ]
}

Discord 提醒

将日程提醒推送至 Discord：

# 将今日日程发送至“형님 DM”频道
node scripts/remind.js --channel 1468204132920725535

与 openclaw CLI 的 message 技能集成。

故障排查

参考信息

• Google Calendar API 文档：https://developers.google.com/calendar/api/v3/reference
• 自然语言解析：基于 chrono-node 库，并额外扩展了韩语匹配规则
• Naver Calendar 无官方 API → 当前仅支持上述绕过方案