据 AlphaMoat 统计,截至 2026-10,Office 365 Connector 累计下载 7,238 次、获 5 个星标,按累计下载量在本次参与排名的 10,914 个 AI 技能中排名第 3,877 位,在「AI 智能体」分类(1,632 个)中排名第 523 位。
列表默认按累计下载量排序,也可按星标排序;详情页排名按累计下载量计算。
| 平台 | 累计下载 | 星标 | 评论 |
|---|---|---|---|
| ClawHub ↗ | 4,999 | 5 | - |
| SkillHub ↗ | 7,238 | 5 | — |
各平台的计数口径不同,统计时间不一致。
通过 Microsoft Graph 与 OAuth 访问邮件、日历和联系人,支持读取与发送邮件、读写日历及联系人,也描述了多账户管理和令牌刷新。该连接可能获得广泛账户权限;执行发送、取消或删除等会影响真实账户的操作前,应核对账户、权限与目标并取得确认。 需要完成文档中的Azure应用注册和逐账号OAuth配置;避免输出原始令牌或在记录日志的shell中输入密钥,核对账号名称并采用最小权限。
资料发布于 2026-10-27
以下是根据技能文档生成的示例,不代表实际运行结果。
2026-09 起统计方法调整:同名技能按作者分别统计,并覆盖全部技能。图中虚线为调整前的月份,与之后的数据不直接比较,也不计算跨越调整的增长。 该技能有同名的其他版本,调整前的数据归属当前下载量最大的这一个。
| 月份 | 累计下载 | 环比 | 星标 |
|---|---|---|---|
| 2026-10 | 7,238 | — | 5 |
| 2026-09 | 5,221 | — | 5 |
| 2026-08 | 4,718 | +6.0% | 5 |
| 2026-07 | 4,452 | +11.6% | 5 |
| 2026-06 | 3,989 | +6.0% | 4 |
| 2026-05 | 3,762 | — | 4 |
| 2026-03 | 2,273 | — | 2 |
以下是作者发布的原始文件,按纯文本显示,本站未做修改或审核;其中的链接不可点击,命令请核实后再运行。抓取于 2026-10-23。
--- name: office365-connector description: Office 365 / Outlook connector for email (read/send), calendar (read/write), and contacts (read/write) using resilient OAuth authentication. NOW WITH MULTI-ACCOUNT SUPPORT! Manage multiple Microsoft 365 identities from a single skill. Solves the difficulty connecting to Office 365 email, calendar, and contacts. Uses Microsoft Graph API with comprehensive Azure App Registration setup guide. Perfect for accessing your Microsoft 365/Outlook data from OpenClaw. --- # Office 365 Connector (Multi-Account Enhanced) ## Overview This skill provides resilient, production-ready connection to **Office 365 / Outlook** services including email, calendar, and contacts. **Now with multi-account support** (v2.0.0), you can manage multiple Microsoft 365 identities (work, personal, consulting, etc.) from a single skill installation.
It solves the common challenge of connecting to Office 365 from automation tools by providing OAuth authentication, automatic token refresh, per-account isolation, and comprehensive Azure App Registration setup guidance. **Perfect for:** - Managing multiple work identities across organizations - Separating personal and professional email/calendar - Accessing shared mailboxes and delegated calendars - Consultants and freelancers working across multiple clients **New in v2.0.0:** Multi-account support! See [MULTI-ACCOUNT.md](MULTI-ACCOUNT.md) for complete usage guide. **Attribution:** Enhanced by **Matthew Gordon** ([[email protected]](mailto:[email protected])) - See [CREDITS.md](CREDITS.md) for full attribution. ## What's New in v2.0.0 **Major Enhancements by Matthew Gordon:** - ✨ **Multi-Account Management** - Handle multiple Microsoft 365 identities from one skill - 🔐 **Per-Account Token Isolation** - Separate, secure token storage for each account - 🔄 **Easy Account Switching** - Use `--account=name` flag across all operations - ⚙️ **Default Account Selection** - Set your preferred account for convenience - 📦 **Legacy Import Tool** - Migrate existing single-account setups seamlessly - 🎯 **Account Management CLI** - Simple add/remove/list/default commands - ✅ **Full Backward Compatibility** - Existing single-account setups work unchanged See [CHANGELOG.md](CHANGELOG.md) for complete version history. ## Capabilities ### Email Operations - Read emails (inbox, sent items, folders) - Send emails (with attachments, HTML formatting) - Search emails by sender, subject, date range - Manage folders and move messages - Mark as read/unread, flag messages - Delete messages ### Calendar Operations - Read calendar events - Create/update/delete events - Check availability - Manage meeting invitations - Support for recurring events - Time zone handling ### Contact Operations - Read contacts and contact folders - Create/update/delete contacts - Search contacts by name, email, company - Manage contact groups - Sync contact information ## Quick Start - Multi-Account ### Add Your First Account ```bash cd skills/office365-connector # Add account node accounts.js add work <tenant-id> <client-id> <client-secret> [email protected] "Work account" # Authenticate node auth.js login --account=work ``` ### Add More Accounts ```bash # Add personal account node accounts.js add personal <tenant> <client> <secret> [email protected] "Personal" # Add consulting account node accounts.js add consulting <tenant> <client> <secret> [email protected] "Consulting" # Set default node accounts.js default work # List all accounts node accounts.js list ``` ### Use Your Accounts ```bash # Check work calendar node calendar.js today --account=work # Read personal emails node email.js recent 10 --account=personal # Send from consulting account node send-email.js send [email protected] "Subject" "Body" --account=consulting ``` ### Migrate from Single-Account Setup Already using v1.0.0? No problem! ```bash # Import your existing setup node accounts.js import-legacy # Continue using without changes (environment variables still work) # OR add additional accounts node accounts.js add secondary <tenant> <client> <secret> ``` ## Prerequisites Before using this skill, you **must** complete the Azure App Registration setup to obtain: 1. **Tenant ID** - Your Azure AD tenant identifier 2. **Client ID** - Your application (client) ID 3. **Client Secret** - Your application secret value **Setup time: ~10-15 minutes per account** See [Setup Guide](references/setup-guide.md) for complete step-by-step instructions. ## Permission Validation This skill requires the following **delegated permissions** (user consent required): ### Email Permissions - `Mail.Read` - Read user email - `Mail.ReadWrite` - Read and write access to user email - `Mail.Send` - Send email as the user ### Calendar Permissions - `Calendars.Read` - Read user calendars - `Calendars.ReadWrite` - Read and write access to user calendars ### Contact Permissions - `Contacts.Read` - Read user contacts - `Contacts.ReadWrite` - Read and write access to user contacts ### Profile Permissions (required for authentication) - `User.Read` - Sign in and read user profile - `offline_access` - Maintain access to data (refresh tokens) **IMPORTANT:** Before proceeding with setup, confirm that you understand and approve these permissions. Each permission grants specific access to your Microsoft 365 data. See [Permissions Reference](references/permissions.md) for detailed information about what each permission allows. ## Configuration ### Multi-Account Configuration (v2.0.0+) Accounts are stored in `~/.openclaw/auth/office365-accounts.json` with tokens in `~/.openclaw/auth/office365/`. Use the `accounts.js` CLI to manage: ```bash node accounts.js list # List all accounts node accounts.js add <name> ... # Add account node accounts.js remove <name> # Remove account node accounts.js default <name> # Set default ``` ### Legacy Single-Account (Backward Compatible) Environment variables still work for single-account use: ```bash export AZURE_TENANT_ID="your-tenant-id" export AZURE_CLIENT_ID="your-client-id" export AZURE_CLIENT_SECRET="your-client-secret" ``` Or in OpenClaw config: ```json { "env": { "vars": { "AZURE_TENANT_ID": "your-tenant-id", "AZURE_CLIENT_ID": "your-client-id", "AZURE_CLIENT_SECRET": "your-client-secret" } } } ``` ## Authentication Flow This skill uses **OAuth 2.0 Device Code Flow** for resilient authentication: 1. Request device code from Microsoft 2. Display user code and verification URL 3. User visits URL and enters code 4. Poll for token completion 5. Store access + refresh tokens (per-account) 6. Automatically refresh tokens when expired **Token storage:** Tokens are securely stored in `~/.openclaw/auth/office365/<account-name>.json` with mode 0600 (owner read/write only). ## Usage Examples ### Multi-Account Email Operations ```bash # Read from default account node email.js recent 10 # Read from specific account node email.js recent 10 --account=work # Search in consulting account node email.js search "proposal" --account=consulting # Send from appropriate identity node send-email.js send [email protected] "Update" "..." --account=consulting ``` ### Multi-Account Calendar Operations ```bash # Check work calendar node calendar.js today --account=work # Check personal calendar node calendar.js week --account=personal ``` ### Account Management ```bash # List all configured accounts node accounts.js list # Check authentication status node auth.js status --account=work # Re-authenticate if needed node auth.js login --account=work ``` ## Real-World Use Cases ### Multiple Work Identities Perfect when working across multiple organizations: ```bash # Morning: Check all calendars node calendar.js today --account=work node calendar.js today --account=consulting node calendar.js today --account=startup # Process emails by identity node email.js recent --account=work node email.js recent --account=consulting # Send from appropriate account node send-email.js send [email protected] "Proposal" "..." --account=work ``` ### Personal + Professional Separation ```bash # Work hours: Work account node calendar.js today --account=work node email.js recent --account=work # After hours: Personal account node email.js recent --account=personal ``` ## Error Handling The skill includes robust error handling for: - **Token expiration** - Automatic refresh with exponential backoff - **Rate limiting** - Retry logic with appropriate delays - **Network errors** - Connection timeout handling - **Permission errors** - Clear messages about missing scopes - **API errors** - Detailed error messages from Microsoft Graph - **Account not found** - Helpful error messages with suggestions ## Rate Limits Microsoft Graph API has rate limits: - **Per-app limit**: 130,000 requests per hour - **Per-user limit**: Variable based on workload - **Throttling**: 429 status code triggers automatic retry The skill automatically handles throttling with exponential backoff. ## Security Considerations 1. **Token Security**: Tokens stored with restricted file permissions (0600) 2. **Per-Account Isolation**: Each account has separate token storage 3. **Scope Limitation**: Request only the minimum required permissions 4. **Refresh Tokens**: Rotated automatically, old tokens invalidated 5. **Client Secret**: Never logged or exposed; stored with mode 0600 6. **Multi-tenant**: This setup is single-tenant (your organization only) ## Troubleshooting ### Multi-Account Issues **"No account specified and no default account set"** ```bash # Set a default account node accounts.js default work # Or always specify --account= node calendar.js today --account=work ``` **"Account not found"** ```bash # List available accounts node accounts.js list # Add the missing account node accounts.js add <name> <tenant> <client> <secret> ``` **Authentication expired** ```bash # Check status node auth.js status --account=work # Re-authenticate node auth.js login --account=work ``` ### Common Issues **"AADSTS700016: Application not found in directory"** - Verify Tenant ID matches your Azure AD tenant - Ensure app registration wasn't deleted **"AADSTS65001: User did not consent"** - Complete the device code flow authentication - Check Admin Consent if required by organization **"AADSTS700082: Expired refresh token"** - Re-authenticate using device code flow - Check token storage file permissions **"403 Forbidden"** - Verify API permissions are granted in Azure - Check if admin consent is required See [Setup Guide](references/setup-guide.md) and [MULTI-ACCOUNT.md](MULTI-ACCOUNT.md) for detailed troubleshooting. ## Limitations - **Attachment size**: Max 4MB per attachment (API limit) - **Email recipients**: Max 500 recipients per email - **Calendar events**: Limited to 1,095 days in the future - **Batch operations**: Max 20 requests per batch ## Command Reference ### Account Management ```bash node accounts.js list # List all accounts node accounts.js add <name> <tenant> <client> <secret> [email] [desc] node accounts.js remove <name> # Remove account node accounts.js default <name> # Set default node accounts.js import-legacy # Import v1.0.0 setup ``` ### Authentication ```bash node auth.js login [--account=name] # Authenticate node auth.js status [--account=name] # Check status node auth.js token [--account=name] # Get access token ``` ### Email ```bash node email.js recent [count] [--account=name] node email.js search "query" [--account=name] node email.js from email@domain [--account=name] node email.js read <id> [--account=name] ``` ### Calendar ```bash node calendar.js today [--account=name] node calendar.js week [--account=name] ``` ### Send & Manage ```bash node send-email.js send <to> <subject> <body> [--account=name] node send-email.js reply <message-id> <body> [--account=name] node cancel-event.js <event-id> [comment] [--account=name] ``` ## Resources ### Documentation Files - [MULTI-ACCOUNT.md](MULTI-ACCOUNT.md) - Complete multi-account usage guide - [CHANGELOG.md](CHANGELOG.md) - Version history and changes - [CREDITS.md](CREDITS.md) - Attribution and acknowledgments - [references/setup-guide.md](references/setup-guide.md) - Azure App Registration walkthrough - [references/permissions.md](references/permissions.md) - Security and permissions reference ### Microsoft Resources - **Microsoft Graph API Documentation**: https://learn.microsoft.com/en-us/graph/api/overview - **Delegated vs Application Permissions**: https://learn.microsoft.com/en-us/graph/auth/auth-concepts - **Rate Limiting**: https://learn.microsoft.com/en-us/graph/throttling ## Credits **Original Skill:** office365-connector v1.0.0 from ClawHub Community **Multi-Account Enhancement (v2.0.0):** Matthew Gordon ([[email protected]](mailto:[email protected])) Thank you to Matthew Gordon for contributing the multi-account enhancement that makes this skill significantly more useful for consultants, freelancers, and anyone managing multiple work identities! See [CREDITS.md](CREDITS.md) for complete attribution. ## License Maintains compatibility with the original skill's licensing. See [CREDITS.md](CREDITS.md) for details.
把开发过程中的经验、错误与纠正记录为 Markdown 文件,供后续复用并晋升为工作区记忆。
用自然语言描述需求,在本地与远程技能市场里找技能并给出推荐的技能。
给 AI agent 用的浏览器自动化命令行技能。
把用户纠正与自我复盘沉淀成分层记忆、并按使用情况升降级的技能。
一份为 AI 代理规划主动跟进、工作记忆与复盘流程的工作区配置指南。
指导如何创建与更新有效 Claude 技能的写作指南。
在安装第三方技能之前,按清单审查来源、权限与危险模式的技能。
把盛唐诗人李白的诗学观、意象系统与口吻,蒸馏成 AI 可调用的角色包。
数据月份:2026-10 · 下载/星标数聚合自公开技能注册库(ClawHub、SkillHub),按月更新。口径说明见数据方法。