飞书日历管理：自动化会议与排程 - Openclaw Skills

什么是 飞书日历管理？

飞书日历管理技能是一项专门设计的工具，旨在赋予 AI 智能体直接与飞书（Lark）生态系统交互的能力。它通过允许智能体以编程方式创建日历、管理事件和查询团队成员的忙闲状态，从而实现无缝排程。通过将此功能整合到您的 Openclaw Skills 库中，您可以构建能够处理复杂组织物流的自主智能体。

该技能对于希望桥接 AI 驱动的任务管理与企业调度之间鸿沟的开发者尤为宝贵。它处理了飞书日历 v4 API 的细节，包括多步骤参与者邀请和特定的时间戳格式，确保在高要求的业务环境中实现可靠的集成。

下载入口:https://github.com/openclaw/skills/tree/main/skills/sunnyyao2222-eng/feishu-calender

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install feishu-calender

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 feishu-calender。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

飞书日历管理 应用场景

• 根据所有利益相关者的空闲情况自动安排项目启动会议。
• 创建专用项目日历，以跟踪跨部门的里程碑和共享截止日期。
• 监控主管日历，以触发针对即将到来会议的自动提醒或准备任务。
• 将外部任务管理系统与飞书同步，保持团队日程实时更新。

飞书日历管理 工作原理

1. 该技能通过 Authorization 标头使用租户访问令牌（tenant access token）向飞书开放平台进行身份验证。
2. 创建事件时，智能体首先初始化基本事件元数据，如摘要、描述和时间范围。
3. 调用第二个关键 API 以向生成的事件 ID 添加参与者，确保参与者正确收到邀请。
4. 对于智能排程，该技能利用忙闲终点在特定时间窗内扫描用户可用性，防止排程冲突。
5. 该技能可以订阅日历变更，使智能体能够通过 Webhook 回调对用户进行的手动修改做出反应。

飞书日历管理 配置指南

要在您的 Openclaw Skills 环境中部署此技能，请确保您的飞书应用已启用以下权限：

• calendar:calendar（管理日历）
• calendar:calendar.free_busy:read（读取忙闲状态）
• calendar:calendar:subscribe（订阅日历事件）

环境配置

# 设置您的飞书租户访问令牌
export FEISHU_ACCESS_TOKEN="your_tenant_access_token"
# 基础 API 地址
# https://open.feishu.cn/open-apis/calendar/v4

飞书日历管理 数据架构与分类体系

该技能使用以下结构组织日历数据和事件元数据，以确保与飞书 API 的兼容性：

参数	类型	描述
calendar_id	字符串	目标日历的唯一标识符。
event_id	字符串	特定会议或事件的唯一标识符。
start_time	对象	包含表示开始时间（以秒为单位）的 timestamp 字符串。
end_time	对象	包含表示结束时间（以秒为单位）的 timestamp 字符串。
attendees	数组	包含 user_id 和 type 的用户对象列表。
time_min/max	字符串	用于忙闲状态查询的 ISO 8601 格式字符串。

name: feishu-calendar
description: 飞书日历日程管理 Skill。创建日历/日程、查询空闲忙状态、订阅日历变更。当需要自动安排会议、查询时间冲突或监控日程变动时使用此 Skill。
required_permissions:
  - calendar:calendar
  - calendar:calendar.free_busy:read
  - calendar:calendar:subscribe

飞书日历日程管理

你是飞书日历自动化专家，负责通过 Calendar v4 API 实现日程创建、空闲查询和日历订阅。

---

一、API 基础信息

---

二、日历操作

1. 创建日历

POST /open-apis/calendar/v4/calendars

{ "summary": "项目日历" }

实测心法：创建后可添加协作者，适合为特定项目创建共享日历。

---

三、日程操作

2. 创建日程

创建日程分为两步：

第一步：创建日程基本信息

POST /open-apis/calendar/v4/calendars/:calendar_id/events

{
  "summary": "需求对齐会",
  "description": "讨论 Q2 产品规划",
  "start_time": { "timestamp": "1770641576" },
  "end_time": { "timestamp": "1770645176" }
}

第二步：添加参与人 (关键)

创建成功获取 event_id 后，必须调用此接口才能邀请他人：

POST /open-apis/calendar/v4/calendars/:calendar_id/events/:event_id/attendees?user_id_type=open_id

{
  "attendees": [
    { "type": "user", "user_id": "ou_xxx" }
  ]
}

实测心法：

• 创建日程接口不支持直接传参会人，必须分两步走。
• 时间戳必须为秒级字符串（不是毫秒，不是数字）。
• 必须带上 user_id_type=open_id 参数，否则无法识别 ou_ 开头的 ID。
• 添加 reminders 确保参会人收到提醒。

3. 更新日程

PATCH /open-apis/calendar/v4/calendars/:calendar_id/events/:event_id

4. 删除日程

DELETE /open-apis/calendar/v4/calendars/:calendar_id/events/:event_id

---

四、智能排期

5. 批量查询空闲忙状态

POST /open-apis/calendar/v4/freebusy/list

{
  "time_min": "2026-02-10T09:00:00+08:00",
  "time_max": "2026-02-10T18:00:00+08:00",
  "user_id": "ou_xxx"
}

实测心法：安排跨部门会议的利器。先查空闲再创建日程，避免时间冲突。

---

五、日历订阅

6. 订阅日历变更

POST /open-apis/calendar/v4/calendars/:calendar_id/subscribe

实测心法：实时感知关键人员的日程变动并调整后续任务。需要配置事件回调（Webhook）。

---

六、最佳实践

1. 先查后建：创建日程前先用 freebusy 查询空闲时段
2. 秒级字符串：时间戳格式是最常踩的坑，必须是秒级字符串
3. 提醒设置：始终添加 reminders，否则参会人容易错过
4. 订阅监控：对关键日历开启订阅，实现日程变更的实时感知