name: outlook-calendar description: "讀取企業 Microsoft 365 Outlook 日曆。當用戶問任何涉及日程、會議、安排、工作、任務、事情的問題時觸發，例如：今天有什麼安排、這周有什麼會、本月會議多少小時、明天要做什麼、下週有啥工作、這周有什麼事、有啥任務等。" metadata: { "openclaw": { "emoji": "📅", "requires": { "bins": ["python3"] } } }

Outlook 日曆技能

觸發條件

只要使用者問任何涉及日程、會議、安排、日曆、工作、任務、事情的問題，必須呼叫此技能。 - "明天有什麼安排" / "這周有什麼會" / "本月日程" - "幫我看看日曆" / "我今天幾點有會" - "這個月會議一共多少小時" - "我下週有啥工作" / "明天要做啥" / "這周有什麼事" - "下週安排" / "有啥任務" / "日程表看一下" - 任何時間 + 安排/會議/事件/工作/任務/事情的組合問法

首次配置

敏感資訊（賬號密碼、Cookie、Token）存放在 ~/.outlook/，不在 skill 目錄內。

1. 建立配置檔案

建立 ~/.outlook/config.json，內容如下：

{
  "email": "your@company.com",
  "password": "your_password",
  "cookie_file": "/root/.outlook/cookies.json",
  "cookie_max_age_days": 7,
  "mfa_type": "authenticator_number_match"
}

2. 安裝依賴

來源於7w4.net。

pip install playwright requests
playwright install chromium

3. 首次登入（MFA）

cd ~/.agents/skills/outlook-calendar
python login.py

指令碼輸出 [NUMBER:XX] 時，在 Microsoft Authenticator App 輸入數字 XX 並批准，Cookie 自動儲存到 ~/.outlook/cookies.json。

呼叫步驟

第一步：讀取日曆

cd ~/.agents/skills/outlook-calendar
python owa_calendar.py --today          # 今天
python owa_calendar.py --tomorrow       # 明天
python owa_calendar.py --week           # 本週
python owa_calendar.py --month 2026-03  # 指定月份
python owa_calendar.py --range 2026-03-01 2026-03-31  # 自定義範圍

第二步：處理 AUTH_FAILED

若輸出 [AUTH_FAILED]，Cookie 或 Token 過期，重新登入：

python login.py

第三步：整理輸出

按使用者問題整理回答：列出事件、統計總時長、按周分組等。 注意：API 返回時間為 UTC，需 +8 轉換為上海時間。

檔案結構

skill 目錄（無敏感資訊）：
~/.agents/skills/outlook-calendar/
├── SKILL.md
├── login.py          # MFA 登入，儲存 Cookie 到 ~/.outlook/
└── owa_calendar.py   # 日曆讀取（Token 模式）

敏感資料目錄：
~/.outlook/
├── config.json       # 賬號密碼（自行建立）
├── cookies.json      # 登入 Cookie（login.py 自動生成）
└── token.json        # Bearer Token 快取（自動生成，1h 有效）

MFA 說明

• 型別：Authenticator 數字匹配
• Cookie 有效期：通常 1-7 天，過期重跑 login.py
• 多次失敗會觸發微軟限速，等 15 分鐘再試

這個 Skill 質量不錯，能較好地讀取 Outlook 日曆並展示日程安排。優點是文件說明詳細、查詢方式靈活、輸出格式友好；不足是執行依賴較多、速度偏慢，偶爾可能遇到登入失效需要手動重跑的情況。總體來說功能完善可用，但維護成本略高。