📅 OpenClaw 日历集成教程

导读：让AI Agent管理你的日程！OpenClaw支持飞书日历、Google Calendar等主流日历服务，可以自动创建会议、检查空闲时间、发送提醒、生成日程报告。

🎯 日历集成场景

• 自动创建会议 - 自然语言创建日程："明天下午3点和张三开会"
• 空闲时间查询 - "这周什么时候有空？"
• 日程冲突检测 - 自动检测并提醒时间冲突
• 会议纪要 - 会后自动生成会议纪要
• 日程报告 - 每日/每周日程汇总

🔧 飞书日历集成

内置工具

# OpenClaw内置飞书日历工具，无需额外配置

# 1. 查询日历列表
feishu_calendar_calendar --action list

# 2. 创建日程
feishu_calendar_event --action create \
  --summary "产品评审会议" \
  --start_time "2026-06-18T15:00:00+08:00" \
  --end_time "2026-06-18T16:00:00+08:00" \
  --description "讨论Q3产品规划" \
  --attendees '[{"type":"user","id":"ou_xxx"}]'

# 3. 查询日程
feishu_calendar_event --action list \
  --start_time "2026-06-17T00:00:00+08:00" \
  --end_time "2026-06-17T23:59:59+08:00"

# 4. 搜索日程
feishu_calendar_event --action search --query "产品评审"

# 5. 查询忙闲状态
feishu_calendar_freebusy --action list \
  --user_ids '["ou_xxx","ou_yyy"]' \
  --time_min "2026-06-18T09:00:00+08:00" \
  --time_max "2026-06-18T18:00:00+08:00"

自动创建会议

# 自然语言创建会议
用户: "帮我和张三约明天下午3点的产品评审，1小时"

# AI Agent自动执行：
1. search_user("张三") → 获取open_id
2. calendar_freebusy(张三, 明天15:00-16:00) → 检查空闲
3. calendar_event_create(
     summary="产品评审会议",
     start="2026-06-18T15:00:00+08:00",
     end="2026-06-18T16:00:00+08:00",
     attendees=[张三]
   )
4. 通知: "已创建会议，明天下午3点，已邀请张三"

🔧 Google Calendar集成

# 使用Google Calendar API

from google.oauth2.credentials import Credentials
from googleapiclient.discovery import build

creds = Credentials.from_authorized_user_file('token.json')
service = build('calendar', 'v3', credentials=creds)

# 列出今日日程
events = service.events().list(
    calendarId='primary',
    timeMin=today_start,
    timeMax=today_end,
    singleEvents=True
).execute()

# 创建日程
event = {
    'summary': 'AI产品评审',
    'start': {'dateTime': '2026-06-18T15:00:00+08:00'},
    'end': {'dateTime': '2026-06-18T16:00:00+08:00'},
    'attendees': [{'email': 'zhang@example.com'}]
}
service.events().insert(calendarId='primary', body=event).execute()

🚀 实战案例

案例1：每日日程播报

# 每天早上8:30播报今日日程
cron add --job '{
  "name": "daily-schedule-briefing",
  "schedule": {"kind": "cron", "expr": "30 8 * * *", "tz": "Asia/Shanghai"},
  "payload": {
    "kind": "agentTurn",
    "message": "查询今日所有日程，生成简洁的日报：列出时间、主题、参会人。如有冲突请标注。通过飞书发送。",
    "timeoutSeconds": 120
  },
  "sessionTarget": "isolated"
}'

案例2：会议冲突检测

# 每次创建新会议前自动检测冲突

任务：创建会议前的冲突检测
1. 获取目标时间段的所有日程
2. 检查是否有时间重叠
3. 如有冲突：
   - 提示用户冲突详情
   - 建议替代时间
4. 如无冲突：
   - 创建会议
   - 发送邀请

案例3：周报生成

# 每周五下午生成本周日程总结

任务：生成本周日程周报
1. 获取本周所有日程
2. 按类型分类：会议/任务/其他
3. 统计数据：
   - 会议总时长
   - 最繁忙的一天
   - 未完成的待办
4. 生成格式化周报
5. 保存并通知

📊 日历工具速查

操作	飞书工具	说明
列出日历	feishu_calendar_calendar list	获取日历列表
查询日程	feishu_calendar_event list	按时间范围查询
创建日程	feishu_calendar_event create	创建新日程
修改日程	feishu_calendar_event patch	更新日程信息
删除日程	feishu_calendar_event delete	删除日程
搜索日程	feishu_calendar_event search	关键词搜索
查忙闲	feishu_calendar_freebusy list	查询用户忙闲
添加参会人	feishu_calendar_event_attendee create	邀请参会人

🔗 相关资源