企业微信 CLI 工具：让 AI Agent 直接操作消息、文档、日程和通讯录
企业微信最近开源了一套 CLI 工具。它的定位不是给普通员工用的命令行，而是给 AI Agent 提供一条直接操作企业微信的官方通道。
装上之后，Agent 可以发消息、查文档、建日程、约会议、翻通讯录、上传微盘文件。整个过程不需要写集成代码，也不需要配回调接口。
这篇文章按实际操作顺序拆解：能做什么、怎么装、怎么用、权限怎么管。
一、CLI 覆盖了哪些业务能力
官方把这套工具定义为“覆盖消息、邮件、文档、待办、日程、会议、微盘、通讯录等业务功能”。具体到每个模块，能力边界是这样的：
消息：向机器人最近对话过的单聊或群聊主动推送消息，支持 Markdown、图片、文件、语音、视频消息。
邮件：发送、回复、转发邮件，搜索邮件，获取邮件内容详情。
文档：新建在线文档、导入、读取内容、追加与覆盖写入。支持多种文档类型的搜索，以及重命名、成员权限与加入规则管理。
在线表格：新建表格、CSV/Excel 导入、内容读取与修改、追加行、子表管理。
智能表格：创建智能表格，管理子表、字段、记录、视图、图表，修改行列样式。
智能文档：创建智能文档、获取页面内容、编辑内容、获取内置数据表信息。
待办：创建、读取、更新、删除待办，分派参与人，完成待办。
日程：增删改查日程、管理参与人、查询多成员闲忙、查询和预订会议室。
会议：创建预约会议、取消会议、更新参会人、查询列表与详情、读取会议纪要与转写原文。
微盘：搜索微盘文件、读取基础信息、上传、下载。
通讯录：按姓名、拼音、别名搜索成员，获取成员基本信息，用于会议、日程等多人的场景。
这套能力覆盖了企业微信里最常用的几类操作。说几个具体的使用场景。
官方示例里有一个是“把生成的报告文档发送到产品四组群里”。Agent 执行完后返回了发送结果：目标群、文档名称、发出时间。消息从生成到送达，一条指令完成。
文档这块，Agent 可以“创建文档、检索文档、读取文档内容、编辑机器人创建的文档”。注意一个限制：编辑权限只针对机器人自己创建的那份文档，不是所有文档都能改。
表格和智能表格的逻辑类似——创建、检索、读取、编辑机器人创建的表格。官方截图里有个实际场景：给 Agent 一个表格链接，说“查一下里面所有‘逾期’的记录，汇总成摘要发出来”，Agent 真的去读了表格，按条件筛选后返回了结构化结果。
日程这块有个功能比较实用：查闲忙。Agent 可以查多个成员的日历空闲情况，然后直接创建日程。官方示例是“预约一个企微日程，查一下我、幸梓、吴有因、劳栋杰下周的闲忙，找一个大家都空的晚上，约一小时的评审会”。从查闲忙到创建日程，一次对话闭环。
通讯录的用法类似：说“帮我在通讯录里找一下叫陈子豪的同事，并预约会议”。Agent 返回匹配的成员信息，接着创建会议。
二、安装方式：四种路径，选最适合你的
官方提供了四种安装方式。
方式一：和 Agent 对话完成安装
把下面这句直接发给智能体：
帮我安装 npx skills add WecomTeam/wecom-unified -y -g
Agent 会自动下载并安装 CLI 工具，然后触发扫码流程。拿企业微信扫一下，就完成了机器人的创建和授权。这是最省事的方式，不需要手动配任何凭证。
方式二：在系统终端内安装
前置条件：Node.js 版本 >= 18，以及企业微信账号。如果要使用长连接方式，还需要创建并获取机器人的 Bot ID 和 Secret。
第一步，安装 CLI：
npm install -g @wecom/cli
第二步，安装 CLI Skill（这一步是必须的，不能跳）：
npx skills add WeComTeam/wecom-cli -y -g
第三步，配置凭证。交互式配置，只需要跑一次：
wecom-cli auth init
默认走扫码流程。如果需要手动输入凭证，加 --manual 参数。
查看授权状态用这个：
wecom-cli auth show
方式三：在智能体平台技能市场安装
目前国内主流智能体平台已经逐步接入了企业微信 CLI 工具。以 WorkBuddy 为例，它内置了企业微信 CLI 的 Skill，路径是 WorkBuddy -> 连接器 -> 添加企业微信，扫码创建并授权机器人，之后就能在对话里直接用了。
方式四：在企业微信应用内复制 MCP 配置
如果智能体支持 MCP 协议，可以用这种方式。
前提：已经在企业微信创建过 API 模式的机器人。入口是「工作台」->「智能机器人」->「管理」，找到对应机器人点击编辑。在编辑页点击「可使用权限」->「去授权」，按需勾选权限。然后点击权限位右上角的箭头进入详情页，复制 MCP 配置——支持 MCP URL 或 MCP JSON Config 两种格式。
三、实际使用：从指令到结果
装好之后，使用方式是在 Agent 对话里发指令。CLI 负责把自然语言转成实际的企业微信操作。
以“创建文档”为例，官方流程是这样的：Agent 收到“生成一个企微文档，2027年度财务预算，罗列报告大纲”的指令后，创建在线文档，返回链接。从指令到拿到链接，中间没有额外的确认步骤。
表格查询的场景刚才提过：给 Agent 一个表格链接，说“查一下这个企业微信表格里所有「逾期」的记录，汇总成摘要发出来”。Agent 读取表格内容，按条件筛选，返回结构化的汇总结果。这意味着你可以在对话里直接查询业务数据，不用自己打开表格翻。
日程创建的场景：Agent 查多个成员的闲忙状态，找到共同空闲的时间段，创建日程，然后返回日程详情。参与人、时间、主题一次性搞定。
通讯录搜索加会议预约：Agent 先搜索通讯录匹配成员，然后直接用返回的成员信息创建会议。从找人到建会，一条指令完成。
微盘上传：把本地文件上传到微盘的指定空间，Agent 返回上传时间、文件大小、具体位置。
这些示例有一个共同点：每个操作都包含具体的参数——文档有标题和大纲、表格有筛选条件、日程有参与人和时间、会议有主题和链接。指令越具体，结果越可用。
四、权限：哪些操作要审批，怎么免审
CLI 的权限分两类。
写操作：创建文档、新建日程、发消息这类，授权机器人之后就能直接用。
读操作：搜索与获取邮件内容、搜索与获取文档内容、搜索与获取会议信息、搜索与获取微盘文件内容、搜索企业成员——这几项涉及数据读取，默认需要走审批流程。
第一次让机器人去“搜索文档内容”或者“查通讯录里的某人”时，机器人会发起一个审批申请。管理员在后台批了之后才能继续。
如果希望跳过审批，企业可以在管理后台配置免审。
路径是：管理后台 -> 安全与管理 -> 管理工具 -> 智能机器人 -> 管理。
这里有两个独立的设置项：
-
在「以下成员创建的机器人，获取数据访问权限无需审批」添加免审名单。被加入的成员创建的机器人，在授权文档、邮件、会议、微盘这几类数据访问权限时免审。
-
在「以下成员创建的机器人，检索企业成员时无需审批」添加免审名单。被加入的成员创建的机器人，在授权搜索企业成员权限时免审。
如果想让全企业都免审，直接把企业根目录设为免审就行。
这组设置把“数据读取”和“成员搜索”拆成了两个独立开关，可以精细控制。比如有的企业允许机器人读文档但不允许搜通讯录，就可以只开第一个、不开第二个。
五、一个需要注意的点
CLI 的典型用法是装在 Agent 里，让大模型把自然语言指令翻译成 CLI 调用。所以 Skill 的定义质量很关键——它决定了 Agent 能不能正确地把“帮我约个会”翻译成正确的日程创建命令。
官方维护的这套 Skill 覆盖了上述十几个模块的常用操作，日常办公场景够用了。
但官方也做了风险提示：AI Agent 调用 CLI 操作企业微信内部应用，可能受模型幻觉影响，存在数据泄露、越权等风险。建议先在测试企业里跑通了再上生产环境。
操作速览
安装（最简方式） ：把 帮我安装 npx skills add WecomTeam/wecom-unified -y -g 发给智能体，扫码授权。
终端安装：
npm install -g @wecom/cli
npx skills add WeComTeam/wecom-cli -y -g
wecom-cli auth init
支持平台：macOS (x64/arm64)、Linux (x64/arm64)、Windows (x64)
Node.js 版本要求：>= 18
读操作默认需审批：搜索邮件/文档/会议/微盘内容、搜索企业成员
免审配置路径：管理后台 -> 安全与管理 -> 管理工具 -> 智能机器人 -> 管理
FAQ
CLI 和 MCP 是什么关系？
CLI 是命令行工具本身，MCP 是另一种接入方式。CLI 能力同步提供了 MCP 接入，适用于需要使用 MCP 协议的智能体。两者的底层能力是一样的，接入方式不同。
Skill 必须装吗？
必须装。npx skills add WeComTeam/wecom-cli -y -g 这一步不能跳。没有 Skill，CLI 本身无法被 Agent 正确调用。
机器人只能编辑自己创建的文档吗？
是的。文档、表格、智能表格、智能文档的编辑权限都限定在“机器人创建的”范围内。不是所有文档都能让机器人改。
哪些操作需要管理员审批？
搜索与获取邮件内容、搜索与获取文档内容、搜索与获取会议信息、搜索与获取微盘文件内容、搜索企业成员。创建、发送类操作不需要审批。
免审怎么配置？
管理后台 -> 安全与管理 -> 管理工具 -> 智能机器人 -> 管理。数据读取免审和成员搜索免审是两个独立开关，可以分别配置。
能在 Windows 上用吗？
支持 Windows x64。
CLI 开源吗？
是的，MIT 许可证。GitHub 地址：https://github.com/WecomTeam/wecom-cli
