MS Teams 会议

技能名称：ms-teams-meetings

概览

• 使用该技能，可通过 Microsoft Graph API 创建和管理 Microsoft Teams 会议。
• 功能包括：
  • 创建 Teams 在线会议并发送日历邀请
  • 列出即将召开的 Teams 会议
  • 取消/删除已有会议（同时向与会者发送取消通知）

适用场景

• 需与商务联系人安排通话，且会议必须以 Microsoft Teams 形式创建，并归属您的 Microsoft 365 账户。
• 管理已启用 Teams 的 Outlook/Exchange 日历事件。

前提条件

1. 一个具备 Outlook/Exchange Online 权限的 Microsoft Entra ID（Azure AD）账户（例如：Microsoft 365 工作或学校账户，或已关联 Outlook 的个人 Microsoft 账户）。
2. 在 Microsoft Entra ID（Azure AD）中完成应用注册：需注册为“公共客户端（移动和桌面）”类型的应用，重定向 URI 设置为 http://localhost:53682，并配置以下 Microsoft Graph 委派权限：
   • User.Read
   • Calendars.ReadWrite
   • OnlineMeetings.ReadWrite
     这些委派权限在大多数租户中通常无需管理员同意，但部分组织可能要求管理员审批。
3. OAuth token 将存储于：~/.openclaw/integrations/microsoft/tokens.json（权限：600）；配置文件位于：~/.openclaw/integrations/microsoft/config.json。

认证（仅需执行一次）

• 运行 scripts/setup.py 脚本，按引导完成 OAuth 流程。该脚本将：
  • 提示您输入 Client ID（应用程序 ID）及 Tenant（可选值：common / organizations / consumers，或您的具体租户 ID）
  • 在 http://localhost:53682 启动本地重定向监听服务
  • 在浏览器中打开 Microsoft 登录与授权页面（采用 PKCE 协议）
  • 安全地存储访问令牌，并在需要时自动刷新

创建 Teams 会议

• 脚本路径：scripts/create_meeting.py
• 输入参数：
  • --title "Project Sync"
  • --attendees：以英文逗号分隔的邮箱列表（例如：a@ex.com,b@ex.com）
  • --start-time "2026-02-25 10:00"（默认为本地时间；若指定 --timezone 则按该时区解析），或直接提供 ISO 8601 格式时间字符串
  • --duration-minutes 45
  • --timezone "Asia/Singapore"（IANA 时区标识符；若未提供，则默认使用系统时区）
• 输出内容：
  • Teams 加入链接及所创建日历事件的 Event ID

列出即将召开的 Teams 会议

• 脚本路径：scripts/list_meetings.py
• 显示指定时间窗口内接下来的 N 场在线会议。

取消会议

• 脚本路径：scripts/cancel_meeting.py
• 取消对应日历事件，并向所有与会者发送取消邮件。

安装

• 要求 Python 3.10 或更高版本
• 首次运行时将自动安装依赖包：msal、requests、python-dateutil、tzlocal

使用示例

1. 一次性认证配置 python3 scripts/setup.py --client-id YOUR_APP_ID --tenant common

2. 创建会议（新加坡时间下午 3 点开始，持续 45 分钟） python3 scripts/create_meeting.py
  --title "BD call with Acme"
  --attendees "alice@acme.com,bob@acme.com"
  --start-time "2026-02-26 15:00"
  --duration-minutes 45
  --timezone "Asia/Singapore"

3. 列出下周所有 Teams 会议（最多 20 条） python3 scripts/list_meetings.py --days 7 --limit 20

4. 取消某场会议 python3 scripts/cancel_meeting.py --event-id EVENT_ID_FROM_CREATE

注意事项

• 默认租户为 common。若您所在组织禁用多租户访问，请改用您的专属租户 ID 作为 --tenant 参数值。
• 时间解析支持 "YYYY-MM-DD HH:MM" 格式或 ISO 8601 字符串；若存在时区歧义，请务必显式指定 --timezone。
• 邀请函发送：当创建含参会人员的日历事件后，Outlook 将自动发送会议邀请。