# Send feishu-calendar-event to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text 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 ```text 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. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "feishu-calendar-event", "name": "feishu-calendar-event", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/TEweitao/feishu-calendar-event", "canonicalUrl": "https://clawhub.ai/TEweitao/feishu-calendar-event", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/feishu-calendar-event", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-calendar-event", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "calendar-client.js", "example.md", "package.json", "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/feishu-calendar-event" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/feishu-calendar-event", "downloadUrl": "https://openagent3.xyz/downloads/feishu-calendar-event", "agentUrl": "https://openagent3.xyz/skills/feishu-calendar-event/agent", "manifestUrl": "https://openagent3.xyz/skills/feishu-calendar-event/agent.json", "briefUrl": "https://openagent3.xyz/skills/feishu-calendar-event/agent.md" } } ``` ## Documentation ### 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 ## Trust - Source: tencent - Verification: Indexed source record - Publisher: TEweitao - Version: 1.0.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/feishu-calendar-event) - [Send to Agent page](https://openagent3.xyz/skills/feishu-calendar-event/agent) - [JSON manifest](https://openagent3.xyz/skills/feishu-calendar-event/agent.json) - [Markdown brief](https://openagent3.xyz/skills/feishu-calendar-event/agent.md) - [Download page](https://openagent3.xyz/downloads/feishu-calendar-event)