告别频繁切窗口！用命令行玩转企业微信-cli的七大核心功能

告别频繁切窗口！用命令行玩转企业微信的七大核心功能

本文介绍企业微信官方命令行工具 wecom-cli 的功能与使用方式，帮助开发者在终端中高效操作企业微信，并支持 AI Agent 集成。

前言

作为开发者，你是否有过这样的体验------

正在终端里专注写代码，突然需要切到企业微信查个联系人、看一下待办、或者安排个会议，等切回来的时候思路已经断了。

如果企业微信的这些操作能直接在终端里完成，是不是就不用来回切换了？

wecom-cli 就是为此而生的。它是企业微信开放平台的命令行工具，覆盖通讯录、待办、会议、消息、日历、文档、智能表格七大核心业务，同时内置 12 个 AI Agent Skill，可以直接对接主流 AI Agent 框架。

🔗 项目地址：github.com/WecomTeam/w...

功能全景

wecom-cli 将企业微信的核心能力抽象为七个模块，每个模块提供对应的子命令：

模块	能力	典型操作
通讯录	花名册查询、姓名/别名搜索	查同事工号、手机号
待办	增删改查 + 状态管理	创建待办、标记完成
会议	创建/取消/改人/查详情	一键约会议室
消息	会话列表、消息记录、媒体下载、发消息	查聊天记录、群发通知
日历	日程 CRUD、空闲时间查询	查看大家什么时候有空
文档	Markdown 格式读写	创建/编辑在线文档
智能表格	表格/工作表/字段/记录管理	创建项目跟踪表

安装与配置

环境要求

Node.js（npm / npx）
企业微信机器人凭证（Bot ID + Secret）

两步搞定

第一步：安装

bash 复制代码

# 全局安装
npm install -g @wecom/cli

# （可选）安装 AI Agent Skills
npx skills add WeComTeam/wecom-cli -y -g

第二步：初始化凭证

bash 复制代码

wecom-cli init

交互式引导你输入 Bot ID 和 Secret，凭证加密存储在 ~/.config/wecom/bot.enc，一次配置，长期使用。

上手指南

命令格式

bash 复制代码

wecom-cli <模块> <方法> [JSON参数]

直接输入模块名可以查看该模块下所有可用方法：

bash 复制代码

wecom-cli contact    # 查看通讯录模块的所有方法
wecom-cli todo       # 查看待办模块的所有方法
wecom-cli meeting    # 查看会议模块的所有方法

通讯录：查人不求人

bash 复制代码

# 获取可见花名册
wecom-cli contact get_userlist '{}'

再也不用打开企业微信翻通讯录了。

待办：终端里管理任务

bash 复制代码

# 查看待办列表
wecom-cli todo get_todo_list '{}'

# 创建一条待办
wecom-cli todo create_todo '{"content": "完成季度报告"}'

配合 cron 或 CI/CD，可以实现自动创建待办提醒。

会议：一行命令约会议

bash 复制代码

# 创建会议
wecom-cli meeting create_meeting '{
  "title": "项目周会",
  "start_time": 1711958400,
  "end_time": 1711962000
}'

# 查询会议详情
wecom-cli meeting get_meeting '{"meeting_id": "xxx"}'

消息：不切窗口收发消息

bash 复制代码

# 获取会话列表
wecom-cli msg get_chat_list '{}'

# 发送消息
wecom-cli msg send_message '{"chat_id": "xxx", "content": "构建完成，请验收"}'

特别适合在 CI/CD 流程中自动发送构建通知。

日历：快速查空闲时间

bash 复制代码

wecom-cli calendar get_schedule '{
  "start_time": 1711900000,
  "end_time": 1712000000
}'

约会议前先查下大家什么时候有空，避免反复协调。

文档：Markdown 原生支持

bash 复制代码

# 创建文档
wecom-cli doc create_doc '{"title": "会议纪要", "content": "# 会议纪要\n\n## 待办项\n- ..."}'

智能表格：结构化数据管理

bash 复制代码

# 创建智能表格
wecom-cli smartsheet create_smartsheet '{"title": "项目跟踪表"}'

AI Agent 集成

wecom-cli 的一大亮点是内置了 12 个 AI Agent Skill，安装后可直接被 AI Agent 调用：

Skill	用途
`wecomcli-lookup-contact`	查找联系人
`wecomcli-get-todo-list`	获取待办列表
`wecomcli-get-todo-detail`	获取待办详情
`wecomcli-edit-todo`	编辑待办事项
`wecomcli-create-meeting`	创建会议
`wecomcli-edit-meeting`	编辑会议
`wecomcli-get-meeting`	查询会议
`wecomcli-get-msg`	获取消息
`wecomcli-manage-schedule`	管理日程
`wecomcli-manage-doc`	管理文档
`wecomcli-manage-smartsheet-schema`	管理表格结构
`wecomcli-manage-smartsheet-data`	管理表格数据

安装方式：

bash 复制代码

npx skills add WeComTeam/wecom-cli -y -g

安装后，你的 AI Agent 就可以通过自然语言操作企业微信了。比如：

"帮我查一下张三的手机号"
"明天下午 3 点约个半小时的会，拉上产品组的人"
"把今天群里的聊天记录整理一下"

适用场景

场景一：终端党日常办公

全程不离开终端，查消息、排会议、管任务一气呵成。

场景二：CI/CD 自动通知

在构建脚本中加一行 wecom-cli msg send_message，构建结果自动推送到群聊。

场景三：AI Agent 智能办公

结合 Claude Code、OpenCode 等 AI Agent 框架，让 Agent 直接操作企业微信，实现真正的智能助手。

场景四：批量自动化

通过 Shell 脚本批量创建待办、发送通知、整理文档，释放重复劳动。

总结

wecom-cli 把企业微信的七大核心模块搬进了终端，命令格式统一、上手门槛低，同时原生支持 AI Agent 集成。无论你是想提升个人开发效率，还是想在自动化流程中接入企业微信能力，都值得一试。

🔗 项目地址：github.com/WecomTeam/w...

如果觉得有用，欢迎 Star 支持！有问题也可以在评论区交流。

ps:最后注意一点，目前cli只支持10以下的企业进行使用，可能未来才会开放。