microsoft365

通过 Microsoft Graph API 与 Outlook、日历、联系人和 OneDrive 进行 Microsoft 365 集成。支持阅读/发送电子邮件、管理日历事件和访问文件。

# Microsoft 365 (Custom)

This skill provides a direct integration with Microsoft 365 services using the Device Code Flow.

## Usage

The skill is executed via `node index.js`. Use the `--account <name>` flag to specify which account to use (e.g., `--account personal`).

### Calendar
- **Fetch events**: `node index.js --account personal --calendar`
- **Create event**: Use interactive mode or automated scripts.

### Email
- **Read emails**: Interactive mode (option 1).
- **Send email**: Interactive mode (option 5).

### Contacts & OneDrive
- **Contacts**: Interactive mode (option 3).
- **OneDrive files**: Interactive mode (option 4).

## Configuration & Security

This skill uses centralized credential management to keep the skill directory clean and safe for sharing.

### File Locations
- **Tokens**: Saved in `~/.openclaw/credentials/ms365.tokens.<account>.json`.
- **Environment**: Automatically loads secrets from `~/.openclaw/credentials/ms365.env` if present.
- **Config**: Expects `config.<account>.json` in the skill directory (or environment variables).

### Setup
1. Register an application in Azure (Public Client Flow, Device Code enabled).
2. Set `MICROSOFT_CLIENT_ID` and `MICROSOFT_TENANT_ID` in your environment or `~/.openclaw/credentials/ms365.env`.
3. Run `node index.js --account <name>` and follow the device login instructions.

---

## 中文说明

# Microsoft 365 (Custom)

此技能使用设备代码流（Device Code Flow）提供与 Microsoft 365 服务的直接集成。

## 用法

该技能通过 `node index.js` 执行。使用 `--account <name>` 标志指定要使用的账户（例如 `--account personal`）。

### 日历
- **获取事件**：`node index.js --account personal --calendar`
- **创建事件**：使用交互模式或自动化脚本。

### 电子邮件
- **阅读邮件**：交互模式（选项 1）。
- **发送邮件**：交互模式（选项 5）。

### 联系人与 OneDrive
- **联系人**：交互模式（选项 3）。
- **OneDrive 文件**：交互模式（选项 4）。

## 配置与安全

此技能使用集中式凭据管理，以保持技能目录干净并可安全共享。

### 文件位置
- **令牌**：保存于 `~/.openclaw/credentials/ms365.tokens.<account>.json`。
- **环境变量**：如果存在，会自动从 `~/.openclaw/credentials/ms365.env` 加载机密信息。
- **配置**：期望在技能目录中存在 `config.<account>.json`（或使用环境变量）。

### 设置
1. 在 Azure 中注册一个应用程序（公共客户端流，启用设备代码）。
2. 在你的环境或 `~/.openclaw/credentials/ms365.env` 中设置 `MICROSOFT_CLIENT_ID` 和 `MICROSOFT_TENANT_ID`。
3. 运行 `node index.js --account <name>` 并按照设备登录说明操作。