Feishu Calendar Skill

飛書日曆操作技能，用於讀取、建立、管理飛書日曆事件，支援個人和企業日曆操作。

基本資訊

• 名稱: feishu-calendar
• 版本: 1.0.0
• 作者: nuonuo
• 描述: 飛書日曆管理技能，支援日程查詢、建立、更新、刪除和重複規則設定
• 標籤: feishu, calendar, 日曆, 飛書
• 依賴: Node.js >= 18

功能特性

✅ 獲取日曆列表
✅ 查詢日程事件（支援時間範圍、分頁）
✅ 建立日程（支援全天事件、定時事件）
✅ 更新日程（修改內容、設定重複規則）
✅ 刪除日程
✅ 設定提醒（支援多層級提醒）
✅ 支援每年/每月/每週重複
✅ 正確處理時區和全天事件

安裝

1. 複製 feishu-calendar 目錄到你的 OpenClaw skills 目錄
2. 配置飛書應用憑證（見下方配置說明）
3. 在飛書開放平臺開通日曆許可權

配置

1. 建立飛書應用

訪問 飛書開放平臺 建立企業自建應用：

1. 點選「建立企業自建應用」
2. 填寫應用名稱（如「日曆助手」）
3. 進入「許可權管理」開通以下許可權：
4. calendar:calendar:read - 讀取日曆
5. calendar:calendar.event:read - 讀取日程
6. calendar:calendar.event:create - 建立日程
7. calendar:calendar.event:update - 更新日程
8. calendar:calendar.event:delete - 刪除日程

2. 獲取憑證

在「憑證與基礎資訊」中獲取： - App ID: cli_xxxxxxxxxxxx - App Secret: xxxxxxxxxxxxx

3. 配置環境變數

# 在 OpenClaw 環境或指令碼中設定
export FEISHU_APP_ID=cli_xxxxxxxxxxxx
export FEISHU_APP_SECRET=xxxxxxxxxxxxx

或者在程式碼中直接使用：

const config = {
  appId: 'cli_xxxxxxxxxxxx',
  appSecret: 'xxxxxxxxxxxxx'
};

使用方法

獲取 Access Token

const response = await fetch('https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    app_id: FEISHU_APP_ID,
    app_secret: FEISHU_APP_SECRET
  })
});

const { tenant_access_token } = await response.json();

獲取日曆列表

const calendars = await fetch('https://open.feishu.cn/open-apis/calendar/v4/calendars?page_size=100', {
  headers: { 'Authorization': `Bearer ${tenant_access_token}` }
});

獲取日程事件

// 時間戳格式（秒）
const startTime = Math.floor(new Date('2026-03-01T00:00:00+08:00').getTime() / 1000);
const endTime = Math.floor(new Date('2026-03-01T23:59:59+08:00').getTime() / 1000);

const events = await fetch(
  `https://open.feishu.cn/open-apis/calendar/v4/calendars/${calendarId}/events?start_time=${startTime}&end_time=${endTime}`,
  { headers: { 'Authorization': `Bearer ${tenant_access_token}` } }
);

建立日程

// 全天事件示例
const event = {
  summary: '🎂 生日',
  description: '祝生日快樂！',
  start_time: { date: '2026-05-01', timezone: 'Asia/Shanghai' },
  end_time: { date: '2026-05-01', timezone: 'Asia/Shanghai' },
  is_all_day: true,
  reminders: [
    { minutes: 7200 },  // 提前5天
    { minutes: 1440 }   // 提前1天
  ],
  recurrence: 'FREQ=YEARLY;INTERVAL=1'  // 每年重複
};

const result = await fetch(`https://open.feishu.cn/open-apis/calendar/v4/calendars/${calendarId}/events`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${tenant_access_token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(event)
});

更新日程為每年重複

const update = {
  recurrence: 'FREQ=YEARLY;INTERVAL=1'
};

await fetch(`https://open.feishu.cn/open-apis/calendar/v4/calendars/${calendarId}/events/${eventId}`, {
  method: 'PATCH',
  headers: {
    'Authorization': `Bearer ${tenant_access_token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(update)
});

API 參考

欄位說明

時間格式

全天事件：

{
  "start_time": { "date": "2026-05-01", "timezone": "Asia/Shanghai" },
  "end_time": { "date": "2026-05-01", "timezone": "Asia/Shanghai" },
  "is_all_day": true
}

定時事件：

{
  "start_time": { "timestamp": "1772366400", "timezone": "Asia/Shanghai" },
  "end_time": { "timestamp": "1772373600", "timezone": "Asia/Shanghai" }
}

重複規則

提醒設定

{
  "reminders": [
    { "minutes": 5 },      // 提前5分鐘
    { "minutes": 60 },     // 提前1小時
    { "minutes": 1440 },   // 提前1天
    { "minutes": 7200 }    // 提前5天
  ]
}

注意事項

1. Token 有效期: tenant_access_token 有效期 2 小時，生產環境需要快取和重新整理機制
2. 時間戳單位: 飛書 API 使用 Unix 時間戳（秒），JavaScript Date 使用毫秒，注意轉換
3. 時區處理: 建議統一使用 Asia/Shanghai 時區
4. 全天事件: 使用 date 欄位而非 timestamp，並設定 is_all_day: true

   7w4.net有更好的技能外掛。

5. 已取消事件: API 會返回 status: cancelled 的事件，需要過濾
6. 分頁處理: 大量事件需要處理 has_more 和 page_token

示例程式碼

見 example.md 和 calendar-client.js 獲取完整示例。

故障排除

參考文件

• 飛書日曆 API 文件
• 獲取 Access Token
• 飛書開放平臺

更新日誌

v1.0.0 (2026-03-01)

• ✅ 初始版本釋出
• ✅ 支援日曆列表查詢
• ✅ 支援日程增刪改查
• ✅ 支援重複規則設定
• ✅ 支援多層級提醒
• ✅ 正確處理全天事件和時區

License: MIT
Author: nuonuo
Repository: https://github.com/openclaw-community/feishu-calendar

這個飛書日曆 Skill 文件寫得非常詳細，看起來功能很全面，但實際可用的功能只有查詢日程，建立、修改、刪除等功能沒有真正實現。文件描述的功能比程式碼能做的多，容易讓人誤以為都能用，實際體驗會有落差。如果你只需要檢視日程可以用，但如果需要建立或管理日程，目前還做不到。