企业微信 CLI (wecom-cli)

企业微信开放平台官方命令行工具 — 让人类和 AI Agent 都能在终端中操作企业微信。

官方 GitHub: https://github.com/WecomTeam/wecom-cli 官方帮助: https://open.work.weixin.qq.com/help2/pc/21676

安装

# 安装 CLI
npm install -g @wecom/cli

# 安装 CLI Skill（必需）
npx skills add WeComTeam/wecom-cli -y -g

# 配置凭证（交互式，仅需一次）
wecom-cli init

前置条件

• 支持平台：macOS (x64/arm64)、Linux (x64/arm64) 及 Windows (x64)
• Node.js >= 18
• 企业微信账号（目前仅对 ≤ 10 人企业开放使用）
• （可选）智能机器人 Bot ID 和 Secret

功能范围

覆盖企业微信核心业务品类：

品类	能力
👤 通讯录	获取可见范围成员列表、按姓名/别名搜索等
✅ 待办	创建/读取/更新/删除待办，变更用户处理状态等
🎥 会议	创建预约会议、取消会议、更新受邀成员、查询列表与详情等
💬 消息	会话列表查询、消息记录拉取（文本/图片/文件/语音/视频）、多媒体下载、发送文本等
📅 日程	日程增删改查、参与人管理、多成员闲忙查询等
📄 文档	文档创建/读取/编辑等
📊 智能表格	智能表格创建、子表与字段管理、记录增删改查等

Agent Skills

安装 CLI Skill 后，AI Agent 工具（Cursor、Claude Code 等）即可通过自然语言操作企业微信。

Skill 列表

Skill ID	功能
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	日程 CRUD、参与人管理、闲忙查询
wecomcli-manage-doc	文档创建/读取/编辑
wecomcli-manage-smartsheet-schema	智能表格创建、字段管理
wecomcli-manage-smartsheet-data	智能表格记录增删改查

使用示例

# 获取通讯录可见范围内的成员列表
wecom-cli contact get_userlist '{}'

# 创建待办
wecom-cli todo create '{"title": "周报", "due_date": "2026-04-10"}'

# 查看会议列表
wecom-cli meeting list '{}'

限制

当前仅对 ≤ 10 人企业 开放使用。

安全规则

• 写入/删除操作前确认用户意图
• 不输出密钥到终端明文
• 配置凭证通过交互式初始化完成，安全存储

预置脚本

scripts/setup.py

企微 wecom-cli 安装配置脚本。

python3 scripts/setup.py

scripts/wecom_quick.py

企微常用操作快捷脚本。

python3 scripts/wecom_quick.py send-msg --to xxx --content "Hello"
python3 scripts/wecom_quick.py contacts
python3 scripts/wecom_quick.py create-doc --title "新文档"
python3 scripts/wecom_quick.py schedule