OfficeCLI：让 AI Agent 操作 Word/Excel/PPT 的开源命令行工具教程

如果你需要让 AI Agent 自动操作 Office 文档（Word、Excel、PowerPoint），OfficeCLI 是目前最值得关注的开源工具。这个项目在 GitHub 上已经获得超过 4300 颗星，是第一个专门为 AI Agent 设计的 Office CLI 工具。

项目简介

• 项目地址：github.com/iOfficeAI/OfficeCLI
• 许可证：Apache 2.0
• 开发语言：C#
• GitHub Stars：4300+
• 支持平台：Windows、macOS、Linux

OfficeCLI 的核心理念是：让 AI Agent 通过命令行和 JSON 接口来操控 Office 文档，不需要启动 GUI 应用。这对于自动化办公流程、批量处理文档、以及让 AI 助手直接生成和编辑文件非常有用。

核心功能

1. 文档格式支持

支持主流 Office 格式：

• Word（.docx）：读取、编辑、创建文档
• Excel（.xlsx）：读写单元格、创建图表、数据处理
• PowerPoint（.pptx）：创建和编辑幻灯片

2. AI Agent 友好的接口

OfficeCLI 的所有操作都通过 CLI 命令 + JSON 输出完成：

# 读取 Word 文档结构
officecli doc read --file report.docx --format json

# 读取 Excel 特定 Sheet 的数据
officecli sheet read --file data.xlsx --sheet "Sheet1" --range "A1:D10"

# 创建新的 PowerPoint
officecli slide create --template blank --output presentation.pptx

所有输出都是结构化 JSON，AI Agent 可以直接解析和使用。

3. 内置渲染引擎

OfficeCLI 内置了文档渲染引擎，可以将 Office 文档转换为：

• HTML：在浏览器中查看文档内容
• PNG：生成文档截图

这意味着 AI Agent 可以「看到」文档的实际渲染效果，而不只是读取原始 XML 数据。

4. 模板合并

支持模板化文档生成——你可以定义一个模板，然后用 JSON 数据填充：

# 用模板和数据生成合同
officecli doc merge --template contract.docx --data contract_data.json --output final_contract.docx

5. MCP 集成

OfficeCLI 支持 Model Context Protocol（MCP），可以直接与支持 MCP 的 AI 工具（如 Claude Desktop）集成。配置后，AI 助手可以直接调用 OfficeCLI 的功能来操作文档。

6. 路径式元素访问

可以像访问文件系统一样访问文档内部元素：

# 访问 Word 文档中的特定段落
officecli doc element --file report.docx --path "body/paragraph[3]"

# 访问 Excel 的特定单元格
officecli sheet cell --file data.xlsx --path "Sheet1/B5"

安装方法

OfficeCLI 是零安装的单文件二进制工具：

方法一：直接下载

从 GitHub Releases 页面下载对应平台的二进制文件，解压后直接运行。

方法二：从源码编译

git clone https://github.com/iOfficeAI/OfficeCLI.git
cd OfficeCLI
dotnet build

使用场景

• 自动化报告生成：AI Agent 从数据源获取数据，自动生成 Excel 报表和 Word 总结
• 合同批量处理：用模板 + 数据的方式批量生成合同、发票等文档
• 文档内容分析：AI Agent 读取大量文档并提取关键信息
• 演示文稿自动化：根据会议纪要自动生成 PPT
• 与 Claude Code 集成：通过 MCP 让 Claude Code 直接操作 Office 文件

与传统方案对比

• vs LibreOffice CLI：OfficeCLI 的 JSON 接口更适合 AI Agent 使用，不需要理解 LibreOffice 复杂的 UNO API
• vs python-docx/openpyxl：OfficeCLI 是统一工具，一个命令处理三种格式；Python 库需要分别安装和学习
• vs Microsoft Office COM：OfficeCLI 跨平台、不需要安装 Office，适合服务器环境

注意事项

• 项目仍在积极开发中，部分高级功能可能还不完善
• 复杂的文档格式（如嵌套表格、SmartArt）支持程度有限
• 渲染引擎的输出效果可能与 Microsoft Office 有差异
• Apache 2.0 许可证允许商业使用，但需要保留版权声明

如果你的业务涉及大量文档自动化处理，或者想让 AI Agent 具备操作 Office 文件的能力，OfficeCLI 是一个值得尝试的工具。

来源：OfficeCLI GitHub 仓库