← All skills
Tencent SkillHub · Productivity

feishu-calendar-event

飞书日历管理技能,支持获取日历列表、查询、创建、更新、删除日程事件及设置重复和多级提醒。

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

飞书日历管理技能,支持获取日历列表、查询、创建、更新、删除日程事件及设置重复和多级提醒。

⬇ 0 downloads ★ 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
calendar-client.js, example.md, package.json, SKILL.md

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.0.0

Documentation

ClawHub primary doc Primary doc: SKILL.md 21 sections Open source page

Feishu Calendar Skill

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

基本信息

名称: feishu-calendar 版本: 1.0.0 作者: nuonuo 描述: 飞书日历管理技能,支持日程查询、创建、更新、删除和重复规则设置 标签: feishu, calendar, 日历, 飞书 依赖: Node.js >= 18

功能特性

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

安装

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

1. 创建飞书应用

访问 飞书开放平台 创建企业自建应用: 点击「创建企业自建应用」 填写应用名称(如「日历助手」) 进入「权限管理」开通以下权限: calendar:calendar:read - 读取日历 calendar:calendar.event:read - 读取日程 calendar:calendar.event:create - 创建日程 calendar:calendar.event:update - 更新日程 calendar:calendar.event:delete - 删除日程

2. 获取凭证

在「凭证与基础信息」中获取: App ID: cli_xxxxxxxxxxxx App Secret: xxxxxxxxxxxxx

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 路径获取 TokenPOST/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天 ] }

注意事项

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

示例代码

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

故障排除

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

参考文档

飞书日历 API 文档 获取 Access Token 飞书开放平台

v1.0.0 (2026-03-01)

✅ 初始版本发布 ✅ 支持日历列表查询 ✅ 支持日程增删改查 ✅ 支持重复规则设置 ✅ 支持多层级提醒 ✅ 正确处理全天事件和时区 License: MIT Author: nuonuo Repository: https://github.com/openclaw-community/feishu-calendar

Category context

Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
2 Docs1 Scripts1 Config
  • SKILL.md Primary doc
  • example.md Docs
  • calendar-client.js Scripts
  • package.json Config