如何让「小龙虾」当你的私人助理,帮你管理飞书日历(完整实操版)
如果你每天都在飞书里安排会议、提醒待办、改时间、查冲突,最省时间的方式不是“更努力记”,而是把这些事交给一个稳定的助手自动做。
这篇文章讲清楚:
如何把小龙虾接入飞书日历,实现一句话建日程、改日程、删日程、到点提醒。
说明:本文所有配置示例都已脱敏,未包含任何真实密钥、用户ID、token。
一、最终效果
你可以直接说:
“今天 17:00 提醒我下班”
“明天 9:30 提醒我发周报”
“把今天 15:00 的会议改到 15:30”
“帮我看下今天还有几个日程”
然后小龙虾会给你创建和修改删除日历,你可以在飞书日历直接看到小龙虾创建的日程。
二、整体架构(别怕,其实很简单)
这套方案分 3 层:
飞书应用层(你在飞书开放平台配置权限)
身份凭证层(拿到 token,代表“应用身份”或“用户身份”)
日历执行层(调用日历 API 创建/修改/删除事件)
一句话总结:
先让飞书“同意你能操作日历”,再让小龙虾“用对身份去调用接口”。
三、前置准备
你需要:
1、一个飞书开放平台应用(已开启机器人能力)
2、在“事件与回调”中添加以下事件:
日历变更 v2.0(calendar.calendar.changed_v4)
日程变更 v2.0(calendar.calendar.event.changed_v4)
3、在权限管理添加以下权限:
calendar:calendar
calendar:calendar:readonly
calendar:calendar.event:read
calendar:calendar.event:create
calendar:calendar.event:update
calendar:calendar.event:delete
calendar:calendar:read
offline_access(这个是用户身份权限,不能省,在refresh token需要用到)
四、获取必要的访问凭证
1) tenant_access_token(应用身份)
凭证与基础信息的app id和secret(在openclaw configure接通飞书channel时用到过的);
2) user_access_token(用户身份)
需要这次授权获取,是本次配置的重点。
步骤 1:配置重定向 URL
在飞书开发者后台:
左侧菜单栏 → 安全设置 → 重定向 URL
填一个地址(告诉小龙虾:将实际发起 API 请求的服务端公网地址配置为重定向 URL)。
步骤 2:打开 OAuth 授权链接
添加后,让小龙虾给你授权链接,在浏览器打开,点击同意授权。
步骤 3:拿到 code
授权成功后,网页会返回一串代码,回调 URL 里会有 code,直接复制给小龙虾。
注意:code 有时效,且一次性使用。把code给小龙虾。
步骤 4:用 code 换 token(这步让小龙虾做就可以)
接口:
POST
请求头:Content-Type: application/json; charset=utf-8
关键参数:
{
"grant_type": "authorization_code",
"client_id": "cli_a5ca35a685b0x26e",
"client_secret": "baBqE5um9LbFGDy3X7LcfxQX1sqpXlwy",
"code": "a61hb967bd094dge949h79bbexd16dfe",
"redirect_uri": ""
}
成功响应示例:
{
"code": 0,
"access_token": "eyJhbGciOiJFUzI1NiIs...X6wrZHYKDxJkWwhdkrYg",
"expires_in": 7200,
"refresh_token": "eyJhbGciOiJFUzI1NiIs...XXOYOZz1mfgIYHwM8ZJA",
"refresh_token_expires_in": 604800,
"scope": "auth: offline_access",
"token_type": "Bearer"
}
步骤 5:保存并刷新(小龙虾做)
user_access_token 有效期较短(约2小时)
refresh_token 用于续期(约7天级别)
建议做法:
把 token 管理逻辑做成脚本,自动刷新,别手动维护。
以上,你可以把这个教程直接丢给小龙虾,让她参考。
恭喜你!离拥有24小时AI私人助理又进了一步。
另外,如果你的openclaw很会偷懒,跟你说行不通,可以问飞书开放平台的智能助手(AI开发)怎么操作,然后把回答贴给小龙虾。
顯示更多