核心用法
Microsoft Excel Skill 通过 Microsoft Graph API 提供对 Excel 工作簿的完整编程访问,覆盖 OneDrive 和 SharePoint 存储的文件。核心能力包括:
数据操作:读取/写入单元格范围(A1 表示法)、批量更新数值与公式、清空或插入行列、合并单元格、排序数据
工作表管理:创建/删除/重命名工作表、保护工作表、获取已用数据区域
表格处理:创建结构化表格、增删行列、应用筛选与排序、表格与范围互转
图表生成:添加和更新图表(柱状图、折线图等)、配置图例与坐标轴
文件管理:搜索文件、创建新工作簿、上传外部文件、导出 PDF
所有操作通过 clawlink_call_tool 调用,参数采用 JSON 格式。读操作可直接执行,写操作需用户显式确认。
显著优点
- 官方 API 背书:基于 Microsoft Graph,数据模型与 Excel 桌面端一致,兼容性极高
- 托管认证:ClawLink 处理 OAuth 2.0 全流程,用户无需管理令牌或密钥
- 双存储支持:同时支持 OneDrive 个人文件和 SharePoint 企业文档库
- 会话机制:支持持久化会话(~5-7 分钟)用于批量写操作,减少 API 调用开销
- 细粒度权限:可按工作簿查看和修改共享权限
潜在缺点与局限性
- 格式仅 .xlsx:不支持 legacy .xls 格式
- 云存储依赖:必须将文件存入 OneDrive/SharePoint,本地文件需先上传
- 会话过期:长时间操作需管理会话生命周期,否则可能中断
- 特殊字符处理:工作表名含特殊字符时需 URL 编码,ClawLink 自动处理但增加复杂度
- 写操作延迟:每次写入需用户确认,交互式场景效率受限
适合人群
- 数据分析师:自动化报表生成、数据清洗与转换
- 财务人员:批量更新预算表、生成图表可视化
- 运营团队:基于 SharePoint 的企业级数据协作
- 开发者:构建与 Microsoft 365 生态集成的自动化工作流
常规风险
- 数据覆盖风险:
excel_update_range、excel_clear_range等操作不可逆,虽有确认机制但误操作仍可能导致数据丢失 - 权限扩散:
excel_add_workbook_permission可能意外扩大文件访问范围,需审慎使用 - 会话竞态:多并发会话操作同一工作簿可能产生锁定冲突
- 依赖第三方托管:ClawLink 作为 OAuth 代理,其服务可用性影响功能使用