微软365命令行工具

技能简介

mog（Microsoft Ops Gadget）是一款面向Microsoft 365的命令行工具，支持通过终端直接操作邮件、日历、OneDrive、联系人、任务及Office文档（Word、PowerPoint、Excel、OneNote）。该工具采用8字符短码替代微软长GUID，简化资源引用。

业务背景

将Microsoft 365全套办公能力集成到命令行环境，让技术人员无需打开浏览器或Office客户端即可完成邮件处理、日程协调、文件管理等高频操作。8字符短码大幅简化资源定位，提升脚本自动化和批量处理效率。

落地案例：运维工程师通过mog search '服务器告警' –since yesterday快速筛选紧急邮件并附件下载；项目经理执行mog calendar create '项目评审会' –attendees x3f9a2b1直接发送会议邀请；开发人员编写脚本定时执行mog onedrive upload /backup/ –to 7d8e4c2a实现日志自动归档。所有操作均可嵌入CI/CD流水线或定时任务，实现办公流程自动化。

能做什么

• 搜索、发送、管理邮件及附件
• 创建、更新、查询日历事件与忙闲状态
• 浏览、上传、下载、管理OneDrive文件
• 维护联系人列表与企业目录查询
• 管理待办任务清单
• 读取、导出、复制Word/PowerPoint/Excel/OneNote内容
• 执行Excel单元格读写、表格追加、工作表操作

使用说明

安装步骤

1. 确保系统已安装Python 3.8+环境
2. 克隆仓库：git clone https://github.com/openclaw/skills.git
3. 进入目录：cd skills/visionik/mogcli
4. 安装依赖：pip install -e .
5. 首次运行执行 mog --ai-help 查看完整配置指引
6. 按提示完成Microsoft OAuth应用注册与授权

基础用法示例

# 搜索最近10封邮件
mog mail search "from:boss@company.com" --max 10

# 创建日历会议
mog calendar create --summary "项目评审" --from 2025-01-20T14:00:00 --to 2025-01-20T15:30:00

# 列出OneDrive根目录
mog drive ls

# 添加待办任务
mog tasks add "提交周报" --due friday

# 读取Excel指定区域
mog excel get a3f2c891 Sheet1 A1:D10

输入与输出

见下方输入与输出表格。

见下方输入输出表格。

风险提示

• OAuth令牌以明文JSON存储于本地，需确保~/.config/mog/目录权限为0600
• 短码系统存在哈希碰撞概率，关键操作建议加--verbose核对完整ID
• 企业环境需预先申请Microsoft Graph API权限，个人租户可能受限
• 批量删除操作（如mog tasks clear）无二次确认，执行前请备份

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/visionik/mogcli/SKILL.md
来源类型：GitHub开源项目