安装
npx skills add WeComTeam/wecom-cli -y -g适合谁
你要在终端里操作企业微信,覆盖消息、邮件、文档、待办、日程、会议、微盘或通讯录,并且希望人类和 AI Agent 都能用同一套命令行时,用这份技能。它不是另一套网页后台,而是把开放平台能力接到终端,用来提升企业办公效率。官方仓库是:
https://github.com/wecomteam/wecom-cli
前置条件写得很明确:本机要有 Node.js >= 18,还要有企业微信账号;平台限于 macOS (x64/arm64)、Linux (x64/arm64) 及 Windows (x64)。没有账号、版本不够、或不在这些平台上,先不要装。只想在浏览器里点选企业微信、又不准备在本机留下全局命令的人,也不适合从这里起步。
源文把 CLI 安装和 CLI Skill 安装分成两步,并且写明 Skill 是必需的。先有命令行,再让 Agent 学会调用。不要发明未出现的安装器,也不要补写未点名的技能目录。源文没有把「人类和 AI Agent」写成某几个产品独占,不要自行收窄客户端名单。
3 分钟完成第一次尝试
先确认三件事:Node.js 已是 18 或更高;你有企业微信账号;当前系统在上述平台里。打开官方页面核对:
https://github.com/wecomteam/wecom-cli
主路径是先装 CLI,再装必需的 CLI Skill。装包会改本机全局命令,执行前确认你要在这台机器上留下 @wecom/cli:
npm install -g @wecom/cli
确认后,再执行源文给出的 Skill 安装(标注为必需):
npx skills add WeComTeam/wecom-cli -y -g
不要把这两步拆成两套并列主路径,也不要改参数。源文没有写技能落盘目录,不要自行补路径。
第一次在 Agent 里只做检查,不要新建文档、发邮件或改日程。若还没配过凭证,配置是副作用:默认扫码,也可用 --manual 手动输入。执行前确认这是你自己的企业微信账号,并且你准备完成这一次交互:
wecom-cli auth init
配完后,用只读命令查看授权状态:
wecom-cli auth show
成功信号:命令正常结束,并能看到当前授权状态。源文没有给出 show 的字段清单,不要编造输出格式。第一次不要做机器人通知、文档写入、会议预约或微盘上传。若 Agent 只能复述「先 init、再 show」,还没有真正跑通 show,也不要当作已经授权成功。
使用案例
案例一:只检查授权。已经装好 CLI 和必需 Skill 后,在终端或能调用同一套命令的 Agent 里运行 wecom-cli auth show。这是查看授权状态,适合确认凭证是否还在。执行前确认你不会顺便改配置;成功信号是看到授权状态。源文没有写未授权时的退出码,失败时停下,不要发明修复命令。也不要把这次检查扩展成发送邮件或读取通讯录,那些动作没有对应命令写法。
案例二:第一次配置凭证。源文写明配置凭证是交互式、仅需一次,默认扫码,--manual 可手动输入。命令是 wecom-cli auth init。执行前确认你要在本机留下企业微信凭证,并准备扫码或手动输入。配完后再跑 wecom-cli auth show 核对。源文没有写撤销或登出命令,不要编造卸载凭证步骤。消息、文档、待办、日程、会议、微盘、邮件、通讯录等业务能力只写到功能名称,例如新建与读取文档、文档搜索、新建与管理日程、预约与获取会议信息、新建与跟进待办、上传与获取微盘文件、发送与获取邮件、获取通讯录成员信息,以及机器人主动通知;需要那些操作时先回到官方仓库,不要自行补命令。
使用边界
平台、运行时和账号要求以源文为准:macOS (x64/arm64)、Linux (x64/arm64) 及 Windows (x64),Node.js >= 18,以及企业微信账号。人类和 AI Agent 都能在终端中操作,但源文没有点名具体 Agent 产品,不要写成某几个客户端独占。
安装顺序是 npm install -g @wecom/cli,然后必需的 npx skills add WeComTeam/wecom-cli -y -g。不要发明第二条市场或未出现的 skills add 变体。也不要把「必需 Skill」理解成可以跳过 CLI,两步都要按源文顺序做完。
凭证配置会写到本机,默认扫码,可用 --manual。源文没有写凭证文件路径、过期策略或如何吊销。业务功能覆盖消息、邮件、文档、待办、日程、会议、微盘、通讯录,包括机器人主动通知、文档搜索、预约会议、上传微盘等,但证据停在能力描述,没有给出这些子命令的写法;没有写到的参数、权限范围和计费,不要补全。第一次只验证授权,不要把未给出命令的办公动作当成已经可复制的步骤。证据没写到的卸载或更新路径,也不要自行补。