Feishu Calendar Advanced
Manage your Feishu (Lark) calendar using the feishu-agent CLI tool.
Dependencies
| Dependency | Required | Description |
|---|
| INLINECODE0 | Yes | Bun runtime (for running bunx commands) |
| INLINECODE1 |
Yes | Installed automatically via bunx |
Check Dependencies
CODEBLOCK0
Setup
First Time Setup
- 1. Install and configure feishu-agent:
CODEBLOCK1
- 2. OAuth Authorization:
CODEBLOCK2
- 3. Verify setup:
CODEBLOCK3
Usage
CODEBLOCK4
Commands
| Command | Description |
|---|
| INLINECODE2 | List all calendars (primary, subscribed) |
| INLINECODE3 |
List events in primary calendar |
|
create --summary "Meeting" --start "2026-03-05 14:00" --end "2026-03-05 15:00" | Create a new event |
|
create --summary "Meeting" --start "..." --end "..." --attendee user_id | Create event with attendees |
|
delete --event-id <event_id> | Delete an event by ID |
Options
| Option | Description |
|---|
| INLINECODE7 | Event title/summary (required for create) |
| INLINECODE8 |
Start time in format "YYYY-MM-DD HH:MM" (required for create) |
|
--end | End time in format "YYYY-MM-DD HH:MM" (required for create) |
|
--attendee | Add attendee by user_id (can be used multiple times) |
|
--event-id | Event ID (required for delete) |
Examples
CODEBLOCK5
Troubleshooting
"User authorization required"
- - Run
bunx @teamclaw/feishu-agent auth to authorize
"Token expired"
- - Run
bunx @teamclaw/feishu-agent auth again to refresh
"Time conflict detected"
- - The requested time slot is already busy
- Choose a different time or check your calendar with INLINECODE14
"Permission denied"
- - Check app permissions in Feishu Developer Console
- Required:
calendar:calendar, INLINECODE16
飞书日历高级版
使用 feishu-agent CLI 工具管理您的飞书日历。
依赖项
| 依赖项 | 必需 | 描述 |
|---|
| bun | 是 | Bun 运行时（用于运行 bunx 命令） |
| @teamclaw/feishu-agent |
是 | 通过 bunx 自动安装 |
检查依赖项
bash
检查 bun 是否可用
bun --version
设置
首次设置
- 1. 安装并配置 feishu-agent：
bash
交互式设置向导（推荐）
bunx @teamclaw/feishu-agent setup
或手动配置
bunx @teamclaw/feishu-agent config set appId
appid>
bunx @teamclaw/feishu-agent config set appSecret appsecret>
- 2. OAuth 授权：
bash
bunx @teamclaw/feishu-agent auth
- 3. 验证设置：
bash
bunx @teamclaw/feishu-agent whoami
使用方法
bash
/feishu-calendar-advanced [命令] [选项]
命令
| 命令 | 描述 |
|---|
| calendars | 列出所有日历（主日历、已订阅日历） |
| events |
列出主日历中的事件 |
| create --summary 会议 --start 2026-03-05 14:00 --end 2026-03-05 15:00 | 创建新事件 |
| create --summary 会议 --start ... --end ... --attendee user_id | 创建带参与者的活动 |
| delete --event-id <事件ID> | 按 ID 删除事件 |
选项
| 选项 | 描述 |
|---|
| --summary | 事件标题/摘要（创建时必需） |
| --start |
开始时间，格式为 YYYY-MM-DD HH:MM（创建时必需） |
| --end | 结束时间，格式为 YYYY-MM-DD HH:MM（创建时必需） |
| --attendee | 按 user_id 添加参与者（可多次使用） |
| --event-id | 事件 ID（删除时必需） |
示例
bash
列出所有日历
/feishu-calendar-advanced calendars
列出主日历中的事件
/feishu-calendar-advanced events
创建简单事件
/feishu-calendar-advanced create --summary 团队站会 --start 2026-03-05 10:00 --end 2026-03-05 10:30
创建带参与者的活动
/feishu-calendar-advanced create --summary 项目评审 --start 2026-03-05 14:00 --end 2026-03-05 15:00 --attendee userid1 --attendee userid2
删除事件
/feishu-calendar-advanced delete --event-id evt_xxxxxxxxxxxxx
故障排除
需要用户授权
- - 运行 bunx @teamclaw/feishu-agent auth 进行授权
令牌已过期
- - 再次运行 bunx @teamclaw/feishu-agent auth 刷新令牌
检测到时间冲突
- - 请求的时间段已被占用
- 选择其他时间，或使用 bunx @teamclaw/feishu-agent calendar events 检查您的日历
权限被拒绝
- - 在飞书开发者控制台中检查应用权限
- 必需权限：calendar:calendar、calendar:event
