OfficeCLI 安装与适配全记录

OfficeCLI 是 iOfficeAI 开发的、专为 AI Agent 设计的 Office 文档处理 CLI 工具。它是一个单二进制文件（35MB）、零依赖的命令行工具，支持 Word、Excel、PowerPoint 三种格式的完整读写、编辑、创建、格式检查、预览、批量处理。

• GitHub：https://github.com/iOfficeAI/OfficeCLI^[1]
• 星标：26,174 ⭐
• 许可：Apache 2.0（完全免费开源）
• 语言：C#
• 首次发布：2026-03-15（不到5个月）
• 当前版本：v1.0.143（2026-07-28）

我们原有的文档技能基于 Python 库，只能做基础文本读写，企业级功能全部缺失：公式计算、数据透视表、图表、动画、模板合并、批注、修订追踪、实时预览、文档截图等。

一条命令安装完毕：

curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash

安装结果：

• 二进制：~/.local/bin/officecli（35MB ELF 64位可执行文件）
• Skill：~/.openclaw/skills/officecli/SKILL.md
• 版本：v1.0.143

验证通过：officecli --version → 1.0.143

快速测试：

officecli create test.docx
officecli add test.docx /body --type paragraph --prop text="Hello 虾妹!"
officecli view test.docx text

输出：[/body/p[@paraId=00100000]] Hello 虾妹!

OpenClaw 技能加载优先级（从高到低）：

1. workspace/skills（我们自己放的技能）
2. workspace/.agents/skills
3. ~/.agents/skills
4. ~/.openclaw/skills（第三方工具自动安装，OfficeCLI 在此）
5. bundled skills（内置技能）

原因分析：

1. 职责分离：workspace/skills/ 放我们自己维护的技能，~/.openclaw/skills/ 放第三方工具自动安装的技能
2. 自动更新兼容：OfficeCLI 安装脚本检测到 OpenClaw 后自动放这里，未来升级时也会自动更新此目录。如果搬到 workspace/skills/ 会挡住自动更新
3. 不影响使用：无论放哪里 OpenClaw 都会加载，skill name 不会重复

自动更新（默认开启）

每次运行 officecli 命令时，后台静默检查 GitHub 最新版本，有新版自动下载替换。全程静默不弹提醒。

# 查看配置
cat ~/.officecli/config.json
# 关闭自动更新
officecli config autoUpdate false
# 单次跳过
OFFICECLI_SKIP_UPDATE=1 officecli ...
# 查看当前版本
officecli --version
# 查看最新版本
cat ~/.officecli/config.json | grep latestVersion

每月提醒：每月1号 09:00 自动提醒检查版本（由虾妹设置于 2026-08-07，下次执行 2026-09-01）

更新了以下技能文件：

1. word-docx SKILL.md → 标记 OfficeCLI 优先用于复杂文档操作
2. document-pro SKILL.md → 同上
3. office-document-specialist-suite SKILL.md → 同上
4. TOOLS.md → 新增 OfficeCLI 配置信息

使用分层策略：

OfficeCLI 是目前最优秀的 AI Agent 专用 Office 文档处理工具，单二进制、零依赖、功能全面，且完全免费开源。安装后与现有 Python 技能互补，复杂文档用 OfficeCLI，简单读写仍可用 Python 工具，互不冲突。

引用链接