一句话搞定日程与待办:openclaw-lark 日历管理、忙闲查询与任务清单实战
【免费下载链接】openclaw-lark飞书官方出品的 OpenClaw 飞书/Lark Channel 插件项目地址: https://gitcode.com/gh_mirrors/op/openclaw-lark
还在手动翻日历、对时间、建待办吗?openclaw-lark是飞书官方出品的 OpenClaw 飞书/Lark Channel 插件,让你只需一句话,就能完成飞书日历管理、忙闲查询、日程创建与任务清单(Task)管理。本文用最少步骤带你上手这个「日程与待办神器」。
一、认识 openclaw-lark:为什么值得装
openclaw-lark 由飞书开放平台团队开发维护,将 OpenClaw Agent 无缝接入飞书工作区。对时间管理相关能力,它内置了一整套官方工具(OAPI 工具注册入口):
| 能力 | 工具名 | 能做什么 |
|---|---|---|
| 日历管理 | feishu_calendar_calendar | 查询日历列表、获取日历详情、主日历 |
| 日程管理 | feishu_calendar_event | 创建/查询/修改/删除/搜索日程、回复邀请 |
| 参会人管理 | feishu_calendar_event_attendee | 邀请参会人、查看回复状态 |
| 忙闲查询 | feishu_calendar_freebusy | 批量查询 1-10 人的忙闲状态 |
| 任务管理 | feishu_task_task | 创建/查询/更新/完成任务、添加成员 |
| 清单管理 | feishu_task_tasklist | 创建清单、查看清单内任务 |
对新手最大的价值:你不需要打开任何后台页面,直接在对话框里用自然语言说话,Agent 会替你调用这些工具并返回结果。
二、快速上手:三步完成安装
- 准备环境:Node.js
v22+,OpenClaw 版本 ≥2026.2.26(可用openclaw -v查看,详细要求见 README.zh.md) - 安装插件:OpenClaw 通过 npm 安装
@larksuite/openclaw-lark(package.json),安装后插件会自动注册 Channel 与全部工具 - 授权飞书身份:按插件引导完成飞书授权(支持用户身份
user与租户身份tenant),之后所有日程/任务操作都以你的身份执行
💡 安装后建议优先把机器人作为私人对话助手使用,避免拉入群聊,防止权限被滥用。
三、日历管理实战:一句话创建日程
核心工具源码在 event.ts,对应技能说明在 skills/feishu-calendar/SKILL.md。常用意图一句话速查:
- 「下周三下午2点开项目复盘会,邀请张三和李四」→ 创建日程 + 添加参会人(自动附带飞书视频会议)
- 「我未来一周有哪些日程」→ 按时间范围
list查询 - 「搜索包含"项目复盘"的日程」→ 按关键词
search - 「把这个会改到明天15点」→
patch修改时间 - 「接受这个会议邀请」→
reply回复 RSVP
创建日程的完整能力包括:标题、描述、开始/结束时间(ISO 8601 带时区,未指定时长默认 1 小时)、参会人(用户ou_xxx/ 群oc_xxx/ 会议室omm_xxx/ 外部邮箱)、地点、忙闲状态、公开范围等。
四、忙闲查询:约会不再"时间撞车"
freebusy.ts 实现了批量忙闲查询:给定时间段,一次查询 1-10 个用户的主日历忙闲信息。
典型用法:「查一下明天上午 9 点到 18 点,小明、小红和小王谁有空」,Agent 返回每个人的忙闲区间后,你可以一句话锁定共同空闲时段并直接创建日程——这就是"找时间 → 约会 → 建日程"的完整闭环。
⚠️ 小贴士:
- 时间必须带时区,例如
2026-03-05T09:00:00+08:00 - 会议室忙闲暂不支持,用户忙闲已覆盖绝大多数场景
- 参会人上限 3000 人/日程,会议室预约是异步流程(先"预约中",稍后查看
rsvp_status)
五、任务清单实战:待办事项全自动化
任务能力源码位于 task.ts 与 tasklist.ts,技能说明见 skills/feishu-task/SKILL.md:
| 你说 | 它做 |
|---|---|
| 「建个待办:周五前提交周报,截止今天17:30」 | create创建任务并设置截止时间 |
| 「把这条待办指派给小李,抄送小王」 | create/add_members设置负责人(assignee)与关注人(follower) |
| 「查一下我还没完成的任务」 | list+completed=false |
| 「把这条任务标记完成」 | patch+completed_at |
| 「建一个叫"产品迭代v2.0"的清单,把这条任务放进去」 | tasklist create+ 任务加入清单 |
| 「创建一个每周一14:00的重复任务」 | create+ RRULE 重复规则 |
任务体系结构为:任务清单 → 自定义分组(Section)→ 任务 → 子任务/附件/评论,另有 子任务工具、评论工具、附件工具 支持细节管理。
六、避坑指南:新手常见的 5 个问题
- 创建日程后自己看不到?传
user_open_id(即消息的 SenderId),把自己加为参会人,日程才会出现在你的日历并收到通知 - 时间显示不对?务必使用 ISO 8601 带时区格式,不要用 Unix 时间戳
- 任务创建后无法编辑?创建时把自己加为成员(
current_user_id会自动补为 follower,别跳过) - 反完成(撤销勾选)怎么写?
completed_at传字符串"0" - 权限报错?确认授权身份:
user身份只能操作自己是成员的任务;需要更宽权限时用tenant(任务 Agent 注册仅支持tenant)
更多细节可参考技能文档中的「常见错误与排查」表格:feishu-calendar、feishu-task。
七、总结
openclaw-lark 把飞书的日历管理、忙闲查询、参会人管理、任务与清单能力全部封装成"一句话可调用"的工具:
- 约会排期:忙闲查询 → 锁定空闲 → 创建日程,三步一气呵成
- 待办管理:创建、指派、完成、重复任务全由自然语言驱动
- 官方出品:MIT 协议、工具注册集中在 src/tools/oapi/,可审计、可维护
装上 openclaw-lark,让 AI 帮你把日程和待办一句话搞定——省下的时间,用来做真正重要的事。
【免费下载链接】openclaw-lark飞书官方出品的 OpenClaw 飞书/Lark Channel 插件项目地址: https://gitcode.com/gh_mirrors/op/openclaw-lark
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考