feishu-calendar

Q: How do I install feishu-calendar?

Run npx skills add https://github.com/larksuite/openclaw-lark --skill feishu-calendar in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/feishu-calendar/ (personal) or .claude/skills/feishu-calendar/ (project).

by larksuiteProductivity & Automation

飞书日历与日程管理工具集。包含日历管理、日程管理、参会人管理、忙闲查询。

Installs: 251
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/larksuite/openclaw-lark --skill feishu-calendar

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads feishu-calendar automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

飞书日历管理 (feishu-calendar)

🚨 执行前必读

✅ 时区固定：Asia/Shanghai（UTC+8）
✅ 时间格式：ISO 8601 / RFC 3339（带时区），例如 2026-02-25T14:00:00+08:00
✅ create 最小必填：summary, start_time, end_time
✅ user_open_id 强烈建议：从 SenderId 获取（ou_xxx），确保用户能看到日程
✅ ID 格式约定：用户 ou_...，群 oc_...，会议室 omm_...，邮箱 email@...

📋 快速索引：意图 → 工具 → 必填参数

用户意图	工具	action	必填参数	强烈建议	常用可选
创建会议	feishu_calendar_event	create	summary, start_time, end_time	user_open_id	attendees, description, location
查某时间段日程	feishu_calendar_event	list	start_time, end_time	-	-
改日程时间	feishu_calendar_event	patch	event_id, start_time/end_time	-	summary, description
搜关键词找会	feishu_calendar_event	search	query	-	-
回复邀请	feishu_calendar_event	reply	event_id, rsvp_status	-	-
查重复日程实例	feishu_calendar_event	instances	event_id, start_time, end_time	-	-
查忙闲	feishu_calendar_freebusy	list	time_min, time_max, user_ids[]	-	-
邀请参会人	feishu_calendar_event_attendee	create	calendar_id, event_id, attendees[]	-	-

🎯 核心约束（Schema 未透露的知识）

1. user_open_id 为什么必填？

工具使用用户身份：日程创建在用户主日历上，用户本人能看到。

但为什么还要传 user_open_id：将发起人也添加为参会人，确保：

✅ 发起人会收到日程通知
✅ 发起人可以回复 RSVP 状态（接受/拒绝/待定）
✅ 发起人出现在参会人列表中
✅ 其他参会人能看到发起人

如果不传：

⚠️ 用户能看到日程，但不会作为参会人
⚠️ 如果只有其他参会人，发起人不在列表中（不符合常规逻辑）

2. 参会人权限（attendee_ability）

工具已默认设置 attendee_ability: "can_modify_event"，参会人可以编辑日程和管理参与者。

权限值	能力
`none`	无权限
`can_see_others`	可查看参与人列表
`can_invite_others`	可邀请他人
`can_modify_event`	可编辑日程（推荐）

3. 统一使用 open_id（ou_...格式）

✅ 创建日程：user_open_id = SenderId
✅ 邀请参会人：attendees[].id = "ou_xxx"

⚠️ ID 格式区分：

ou_xxx：用户的 open_id（你应该使用的）
user_xxx：日程内部的 attendee_id（list 接口返回，仅用于内部记录）

4. 会议室预约是异步流程

添加会议室类型参会人后，会议室进入异步预约流程：

API 返回成功 → rsvp_status: "needs_action"（预约中）
后台异步处理
最终状态：accept（成功）或 decline（失败）

查询预约结果：使用 feishu_calendar_event_attendee.list 查看 rsvp_status。

5. instances action 仅对重复日程有效

⚠️ 重要：instances action 仅对重复日程有效，必须满足：

event_id 必须是重复日程的 ID（该日程具有 recurrence 字段）
如果对普通日程调用，会返回错误

如何判断：

先用 get action 获取日程详情
检查返回值中是否有 recurrence 字段且不为空
如果有，则可以调用 instances 获取实例列表

📌 使用场景示例

场景 1: 创建会议并邀请参会人

{
  "action": "create",
  "summary": "项目复盘会议",
  "description": "讨论 Q1 项目进展",
  "start_time": "2026-02-25 14:00:00",
  "end_time": "2026-02-25 15:30:00",
  "user_open_id": "ou_aaa",
  "attendees": [
    {"type": "user", "id": "ou_bbb"},
    {"type": "user", "id": "ou_ccc"},
    {"type": "resource", "id": "omm_xxx"}
  ]
}

场景 2: 查询用户未来一周的日程

{
  "action": "list",
  "start_time": "2026-02-25 00:00:00",
  "end_time": "2026-03-03 23:59:00"
}

场景 3: 查看多个用户的忙闲时间

{
  "action": "list",
  "time_min": "2026-02-25 09:00:00",
  "time_max": "2026-02-25 18:00:00",
  "user_ids": ["ou_aaa", "ou_bbb", "ou_ccc"]
}

注意：user_ids 是数组，支持 1-10 个用户。当前不支持会议室忙闲查询。

场景 4: 修改日程时间

{
  "action": "patch",
  "event_id": "xxx_0",
  "start_time": "2026-02-25 15:00:00",
  "end_time": "2026-02-25 16:00:00"
}

场景 5: 搜索日程（按关键词）

{
  "action": "search",
  "query": "项目复盘"
}

场景 6: 回复日程邀请

{
  "action": "reply",
  "event_id": "xxx_0",
  "rsvp_status": "accept"
}

🔍 常见错误与排查

错误现象	根本原因	解决方案
发起人不在参会人列表中	未传 `user_open_id`	强烈建议传 `user_open_id = SenderId`
参会人看不到其他参会人	`attendee_ability` 权限不足	工具已默认设置 `can_modify_event`
时间不对	使用了 Unix 时间戳	改用 ISO 8601 格式（带时区）：`2024-01-01T00:00:00+08:00`
会议室显示"预约中"	会议室预约是异步的	等待几秒后用 `list` 查询 `rsvp_status`
修改日程报权限错误	当前用户不是组织者，且日程未设置可编辑权限	确保日程创建时设置了 `attendee_ability: "can_modify_event"`
无法查看参会人列表	当前用户无查看权限	确保是组织者或日程设置了 `can_see_others` 以上权限

📚 附录：背景知识

A. 日历架构模型

飞书日历采用 三层架构：

日历（Calendar）
  └── 日程（Event）
       └── 参会人（Attendee）

关键理解：

用户主日历：日程创建在发起用户的主日历上，用户本人能看到
参会人机制：通过添加参会人（attendee），让其他人的日历中也显示此日程
权限模型：日程的 attendee_ability 参数控制参会人能否编辑日程、邀请他人、查看参与人列表

B. 参会人类型

type: "user" + id: "ou_xxx" — 飞书用户（使用 open_id）
type: "chat" + id: "oc_xxx" — 飞书群组
type: "resource" + id: "omm_xxx" — 会议室
type: "third_party" + id: "email@example.com" — 外部邮箱

C. 日程的生命周期

创建：在用户主日历上创建日程（工具使用用户身份）
邀请参会人：通过 attendee API 将日程分享给其他参会人
参会人回复：参会人可以 accept/decline/tentative
修改：组织者或有权限的参会人可以修改
删除：删除后状态变为 cancelled

D. 日历类型说明

类型	说明	能否删除	能否修改
`primary`	主日历（每个用户/应用一个）	❌ 否	✅ 是
`shared`	共享日历（用户创建并共享）	✅ 是	✅ 是
`resource`	会议室日历	❌ 否	❌ 否
`google`	绑定的 Google 日历	❌ 否	❌ 否
`exchange`	绑定的 Exchange 日历	❌ 否	❌ 否

E. 回复状态（rsvp_status）说明

状态	含义（用户）	含义（会议室）
`needs_action`	未回复	预约中
`accept`	已接受	预约成功
`tentative`	待定	-
`decline`	拒绝	预约失败
`removed`	已被移除	已被移除

F. 使用限制（来自飞书 OAPI 文档）

每个日程最多 3000 名参会人
单次添加参会人上限：
- 用户类参会人：1000 人
- 会议室：100 个
主日历不可删除（type 为 primary 的日历）
会议室预约可能失败：
- 时间冲突
- 无预约权限
- 会议室配置限制

FAQ

What does the feishu-calendar skill do?

飞书日历与日程管理工具集。包含日历管理、日程管理、参会人管理、忙闲查询。

How do I install feishu-calendar?

Run npx skills add https://github.com/larksuite/openclaw-lark --skill feishu-calendar in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/feishu-calendar/ (personal) or .claude/skills/feishu-calendar/ (project).

Which AI agents can use feishu-calendar?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is feishu-calendar safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains feishu-calendar?

It is published by larksuite in larksuite/openclaw-lark. It has 251 recorded installs.

More from larksuite/openclaw-lark

View all →

feishu-bitable

larksuite/openclaw-lark

飞书多维表格（Bitable）的创建、查询、编辑和管理工具。包含 27 种字段类型支持、高级筛选、批量操作和视图管理。当以下情况时使用此 Skill： (1) 需要创建或管理飞书多维表格 App (2) 需要在多维表格中新增、查询、修改、删除记录（行数据） (3) 需要管理字段（列）、视图、数据表 (4) 用户提到"多维表格"、"bitable"、"数据表"、"记录"、"字段" (5) 需要批量导入数据或批量更新多维表格

Productivity & Automation580 installs

feishu-create-doc

larksuite/openclaw-lark

创建飞书云文档。从 Lark-flavored Markdown 内容创建新的飞书云文档，支持指定创建位置（文件夹/知识库/知识空间）。

Productivity & Automation362 installs

feishu-im-read

larksuite/openclaw-lark

飞书 IM 消息读取工具使用指南，覆盖会话消息获取、话题回复读取、跨会话消息搜索、图片/文件资源下载。当以下情况时使用此 Skill: (1) 需要获取群聊或单聊的历史消息 (2) 需要读取话题（thread）内的回复消息 (3) 需要跨会话搜索消息（按关键词、发送者、时间等条件） (4) 消息中包含图片、文件、音频、视频，需要下载 (5) 用户提到"聊天记录"、"消息"、"群里说了什么"、"话题回复"、"搜索消息"、"图片"、"文件下载" (6) 需要按时间范围过滤消息、分页获取更多消息

Productivity & Automation283 installs

feishu-fetch-doc

larksuite/openclaw-lark

获取飞书云文档内容。返回文档的 Markdown 内容，支持处理文档中的图片、文件和画板（需配合 feishudocmedia 工具）。

Productivity & Automation227 installs

feishu-update-doc

larksuite/openclaw-lark

更新飞书云文档。支持 7 种更新模式：追加、覆盖、定位替换、全文替换、前/后插入、删除。

Productivity & Automation189 installs

feishu-task

larksuite/openclaw-lark

飞书任务管理工具,用于创建、查询、更新任务和清单。当以下情况时使用此 Skill: (1) 需要创建、查询、更新任务 (2) 需要创建、管理任务清单 (3) 需要查看任务列表或清单内的任务 (4) 用户提到"任务"、"待办"、"to-do"、"清单"、"task" (5) 需要设置任务负责人、关注人、截止时间、添加成员 (6) 需要追加任务步骤记录（Task 的 steps） (7) 需要上传任务附件（支持 task / taskdelivery） (8) 需要注册 Agent / 更新 Agent 信息（register / updateprofile）

Productivity & Automation159 installs

Popular productivity & automation skills

View category →

agent-browser

vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

OfficialProductivity & Automation1.3M installs

lark-doc

open.feishu.cn

飞书云文档（Docx / Wiki）内容操作：读取、创建、编辑文档，插入或下载图片附件，以及操作思维笔记。用户提供文档 URL/token（包括 doubao.com 的 /docx/、/wiki/）时使用；按 URL 路径/token 而非域名路由；/page/ 是妙搭应用，非飞书云文档。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive；随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。

Productivity & Automation815.7K installs

lark-base

open.feishu.cn

飞书多维表格（Base）操作：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式（BaseApp/AppMode 页面与组件）、Workspace 目录、workflow、角色权限、模板中心（多维表格模板分类/列表/搜索）；遇到 Base/多维表格/bitable、BaseApp/AppMode、/base/ 或 /app/ 链接时使用。BaseApp 不走 lark-apps；文件导入/导出转 lark-drive，认证/授权转 lark-shared。

Productivity & Automation815K installs

lark-drive

open.feishu.cn

飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、查询权限设置、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sheet/bitable/slides 时使用；doubao.com 云空间 URL/token 也按资源路径和 token 路由，不回退 WebFetch。不负责：文档内容编辑（走 lark-doc）、表格/Base 表内数据操作（走 lark-sheets/lark-base）、知识空间节点/成员管理（走 lark-wiki）、原生 Markdown 文件读写/patch/diff（走 lark-markdown）。

Productivity & Automation815K installs

lark-shared

open.feishu.cn

Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling notice JSON.

Productivity & Automation814.8K installs

lark-im

open.feishu.cn

飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片（Interactive Card）、监听卡片按钮回调（card.action.trigger）。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 Feed 置顶（添加/移除/查询置顶会话）、管理标签数据、处理卡片回调时使用。

Productivity & Automation814.1K installs

feishu-calendar

Install

Install

Describe the task

Review the result

SKILL.md

飞书日历管理 (feishu-calendar)

🚨 执行前必读

📋 快速索引：意图 → 工具 → 必填参数

🎯 核心约束（Schema 未透露的知识）

1. user_open_id 为什么必填？

2. 参会人权限（attendee_ability）

3. 统一使用 open_id（ou_...格式）

4. 会议室预约是异步流程

5. instances action 仅对重复日程有效

📌 使用场景示例

场景 1: 创建会议并邀请参会人

场景 2: 查询用户未来一周的日程

场景 3: 查看多个用户的忙闲时间

场景 4: 修改日程时间

场景 5: 搜索日程（按关键词）

场景 6: 回复日程邀请

🔍 常见错误与排查

📚 附录：背景知识

A. 日历架构模型

B. 参会人类型

C. 日程的生命周期

D. 日历类型说明

E. 回复状态（rsvp_status）说明

F. 使用限制（来自飞书 OAPI 文档）

FAQ

More from larksuite/openclaw-lark

Popular productivity & automation skills