企业微信 CLI (wecom-cli)

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

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

安装

bash
# 安装 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 | 智能表格记录增删改查 |

使用示例

bash
# 获取通讯录可见范围内的成员列表
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 安装配置脚本。

bash
python3 scripts/setup.py

scripts/wecom_quick.py

企微常用操作快捷脚本。

bash
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