feishu-calendar-event

Feishu Calendar Skill

飞书日历操作技能，用于读取、创建、管理飞书日历事件，支持个人和企业日历操作。

基本信息

功能特性

✅ 获取日历列表 ✅ 查询日程事件（支持时间范围、分页） ✅ 创建日程（支持全天事件、定时事件） ✅ 更新日程（修改内容、设置重复规则） ✅ 删除日程 ✅ 设置提醒（支持多层级提醒） ✅ 支持每年/每月/每周重复 ✅ 正确处理时区和全天事件

安装

1. 复制 feishu-calendar 目录到你的 OpenClaw skills 目录 2. 配置飞书应用凭证（见下方配置说明） 3. 在飞书开放平台开通日历权限

配置

1. 创建飞书应用

访问 飞书开放平台 创建企业自建应用：

1. 点击「创建企业自建应用」 2. 填写应用名称（如「日历助手」） 3. 进入「权限管理」开通以下权限： - calendar:calendar:read - 读取日历 - calendar:calendar.event:read - 读取日程 - calendar:calendar.event:create - 创建日程 - calendar:calendar.event:update - 更新日程 - calendar:calendar.event:delete - 删除日程

2. 获取凭证

在「凭证与基础信息」中获取：

3. 配置环境变量

# 在 OpenClaw 环境或脚本中设置
export FEISHU_APP_ID=cli_xxxxxxxxxxxx
export FEISHU_APP_SECRET=xxxxxxxxxxxxx

或者在代码中直接使用：

const config = {
  appId: 'cli_xxxxxxxxxxxx',
  appSecret: 'xxxxxxxxxxxxx'
};

使用方法

获取 Access Token

const response = await fetch('https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    app_id: FEISHU_APP_ID,
    app_secret: FEISHU_APP_SECRET
  })
});
const { tenant_access_token } = await response.json();

获取日历列表

const calendars = await fetch('https://open.feishu.cn/open-apis/calendar/v4/calendars?page_size=100', {
  headers: { 'Authorization': Bearer ${tenant_access_token} }
});

获取日程事件

// 时间戳格式（秒）
const startTime = Math.floor(new Date('2026-03-01T00:00:00+08:00').getTime() / 1000);
const endTime = Math.floor(new Date('2026-03-01T23:59:59+08:00').getTime() / 1000);
const events = await fetch(
  https://open.feishu.cn/open-apis/calendar/v4/calendars/${calendarId}/events?start_time=${startTime}&end_time=${endTime},
  { headers: { 'Authorization': Bearer ${tenant_access_token} } }
);

创建日程

// 全天事件示例
const event = {
  summary: '🎂 生日',
  description: '祝生日快乐！',
  start_time: { date: '2026-05-01', timezone: 'Asia/Shanghai' },
  end_time: { date: '2026-05-01', timezone: 'Asia/Shanghai' },
  is_all_day: true,
  reminders: [
    { minutes: 7200 },  // 提前5天
    { minutes: 1440 }   // 提前1天
  ],
  recurrence: 'FREQ=YEARLY;INTERVAL=1'  // 每年重复
};
const result = await fetch(https://open.feishu.cn/open-apis/calendar/v4/calendars/${calendarId}/events, {
  method: 'POST',
  headers: {
    'Authorization': Bearer ${tenant_access_token},
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(event)
});

更新日程为每年重复

const update = {
  recurrence: 'FREQ=YEARLY;INTERVAL=1'
};
await fetch(https://open.feishu.cn/open-apis/calendar/v4/calendars/${calendarId}/events/${eventId}, {
  method: 'PATCH',
  headers: {
    'Authorization': Bearer ${tenant_access_token},
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(update)
});

API 参考

| 功能 | 方法 | API 路径 | |------|------|----------| | 获取 Token | POST | /auth/v3/tenant_access_token/internal | | 获取日历列表 | GET | /calendar/v4/calendars | | 获取日程 | GET | /calendar/v4/calendars/{calendar_id}/events | | 创建日程 | POST | /calendar/v4/calendars/{calendar_id}/events | | 更新日程 | PATCH | /calendar/v4/calendars/{calendar_id}/events/{event_id} | | 删除日程 | DELETE | /calendar/v4/calendars/{calendar_id}/events/{event_id} |

字段说明

时间格式

全天事件：

{
  "start_time": { "date": "2026-05-01", "timezone": "Asia/Shanghai" },
  "end_time": { "date": "2026-05-01", "timezone": "Asia/Shanghai" },
  "is_all_day": true
}

定时事件：

{
  "start_time": { "timestamp": "1772366400", "timezone": "Asia/Shanghai" },
  "end_time": { "timestamp": "1772373600", "timezone": "Asia/Shanghai" }
}

重复规则

| 规则 | 说明 | |------|------| | FREQ=DAILY;INTERVAL=1 | 每天重复 | | FREQ=WEEKLY;INTERVAL=1 | 每周重复 | | FREQ=MONTHLY;INTERVAL=1 | 每月重复 | | FREQ=YEARLY;INTERVAL=1 | 每年重复 |

提醒设置

{
  "reminders": [
    { "minutes": 5 },      // 提前5分钟
    { "minutes": 60 },     // 提前1小时
    { "minutes": 1440 },   // 提前1天
    { "minutes": 7200 }    // 提前5天
  ]
}

注意事项

1. Token 有效期: tenant_access_token 有效期 2 小时，生产环境需要缓存和刷新机制 2. 时间戳单位: 飞书 API 使用 Unix 时间戳（秒），JavaScript Date 使用毫秒，注意转换 3. 时区处理: 建议统一使用 Asia/Shanghai 时区 4. 全天事件: 使用 date 字段而非 timestamp，并设置 is_all_day: true 5. 已取消事件: API 会返回 status: cancelled 的事件，需要过滤 6. 分页处理: 大量事件需要处理 has_more 和 page_token

示例代码

见 example.md 和 calendar-client.js 获取完整示例。

故障排除

| 问题 | 解决方案 | |------|----------| | 99991661 - Missing access token | 检查 token 是否正确传递 | | 403 - 权限不足 | 在飞书后台开通相应权限 | | 事件查询不到 | 扩大时间范围，检查是否已取消 | | 创建失败 | 检查必填字段（summary, start_time, end_time）|

参考文档

更新日志

v1.0.0 (2026-03-01)

License: MIT Author: nuonuo Repository: https://github.com/openclaw-community/feishu-calendar