企业微信命令行工具 wecom-cli：终端里轻松处理通讯录、待办、会议和更多业务

如果你经常需要在电脑终端里快速查看企业微信的成员信息、创建待办事项、安排会议，或者拉取聊天记录，却不想每次都打开手机或网页客户端，那么 wecom-cli 很可能就是你正在寻找的工具。它是一款专为企业微信打造的命令行工具，让人类用户和 AI Agent 都能在终端环境中直接操作企业微信的核心业务。

这个工具覆盖了通讯录、待办、会议、消息、日程、文档和智能表格七大业务领域，提供了 12 个专门为 AI Agent 准备的 Skills。无论是日常办公，还是让 AI 助手自动帮你处理企业微信事务，它都能大幅简化操作流程。

下面我们就来一步步聊聊 wecom-cli 到底能帮你做什么、怎么安装使用，以及每个业务品类的具体操作方式。内容完全基于工具本身的说明和示例，目的是让你看完就能上手。

为什么很多人选择 wecom-cli

wecom-cli 的设计思路很明确：让终端操作企业微信变得像敲命令一样简单，同时特别考虑了 AI Agent 的使用场景。

首先，它为 AI Agent 量身打造了开箱即用的 Skills。这些 Skills 已经适配主流 AI 工具，Agent 可以直接调用企业微信的各项功能，不需要额外开发适配代码。这意味着如果你正在构建或使用 AI 助手，它就能无缝接入企业微信的通讯录查询、待办管理、会议创建等操作。

其次，它覆盖了用户最核心的七大业务需求，包括通讯录成员管理、待办事项处理、视频会议安排、消息收发、日程规划、文档编辑以及智能表格数据操作。12 个 AI Agent Skills 进一步把这些能力拆分成清晰的模块，让调用变得更精准。

最后，上手门槛很低。只需两步：先通过 init 命令配置企业微信机器人的凭证，然后就能直接调用各种工具。从安装到第一次成功调用 API，通常只需要几分钟时间。

这些设计让 wecom-cli 既适合个人开发者在终端快速处理事务，也适合企业团队或 AI 系统集成使用。

wecom-cli 的核心功能一览

wecom-cli 把企业微信的常用业务整理成七个清晰的品类，每个品类下面都有具体的操作能力。以下是详细对照表，便于你快速了解覆盖范围：

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

这些能力基本覆盖了企业微信日常工作中最频繁的操作场景。你可以在终端里完成大部分原本需要打开客户端才能做的事。

安装与快速开始：两步搞定

环境要求

使用 wecom-cli 前，你需要准备好：

  • Node.js（同时带有 npm 或 npx）
  • 企业微信机器人的 Bot ID 和 Secret（用于后续配置凭证）

安装步骤

  1. 全局安装 CLI 工具：

    npm install -g @wecom/cli

  2. 安装 CLI SKILL（这一步是必需的，尤其如果你要让 AI Agent 使用）：

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

安装完成后，工具就准备好了。接下来就是配置凭证。

快速开始

  1. 配置凭证（只需做一次）
    运行以下命令，工具会进入交互式引导，你只需要输入企业微信机器人的 Bot ID 和 Secret：

    wecom-cli init

    可选参数是 --bot-id，如果你想在命令中直接指定。
    凭证会加密后安全存储在本地路径 ~/.config/wecom/bot.enc，以后就不需要重复输入了。

  2. 调用第一个工具
    例如获取通讯录成员列表：

    wecom-cli contact get_userlist '{}'

    或者不带参数直接运行：

    wecom-cli contact get_userlist

整个过程非常简洁。配置好凭证后，你就可以根据需要调用不同品类的工具了。

详细品类使用指南

wecom-cli 把功能拆分成独立子命令。每个品类既可以单独运行列出可用工具，也可以直接带方法名和 JSON 参数调用。下面我们按品类逐一说明，附带真实示例和参数解释，让你清楚知道什么时候用、怎么用。

通讯录（contact）

这个品类主要用来查询成员信息。

可用工具只有 get_userlist：获取当前用户可见范围内的通讯录成员列表，返回每个成员的 userid、姓名和别名。

使用示例：

# 获取全量通讯录成员
wecom-cli contact get_userlist '{}'

如果你想快速找到某个同事的信息，这个命令就能直接在终端里列出结果，非常适合需要批量处理成员数据的场景。

待办事项（todo）

待办是很多人每天都要打交道的模块，这里提供了完整的 CRUD 操作。

可用工具：

  • get_todo_list：查询待办列表，支持按时间过滤和分页
  • get_todo_detail：根据待办 ID 批量查询完整详情
  • create_todo：创建新待办，可设置内容、分派人和提醒时间
  • update_todo：更新待办内容、状态、分派人或提醒时间
  • delete_todo：删除待办（操作后不可撤销）
  • change_todo_user_status：变更当前用户在待办中的处理状态

常用示例：

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

# 创建一个带提醒的待办
wecom-cli todo create_todo '{"content": "完成Q2规划文档", "remind_time": "2026-06-01 09:00:00"}'

# 批量查询详情
wecom-cli todo get_todo_detail '{"todo_id_list": ["TODO_ID_1", "TODO_ID_2"]}'

# 把待办标记为已完成（todo_status 为 0 表示完成）
wecom-cli todo update_todo '{"todo_id": "TODO_ID", "todo_status": 0}'

# 删除待办
wecom-cli todo delete_todo '{"todo_id": "TODO_ID"}'

这些命令让你在终端里就能完成待办的全生命周期管理，不用切换到企业微信 App。

会议（meeting）

视频会议安排是企业协作的重要环节，这个品类支持预约、取消和查询。

可用工具：

  • create_meeting：创建预约会议，支持设置标题、时间、时长、邀请人、安全设置等
  • cancel_meeting：取消指定的预约会议
  • set_invite_meeting_members：更新会议受邀成员（全量覆盖）
  • list_user_meetings：查询用户在指定时间范围内的会议列表（默认查询当日前后 30 天）
  • get_meeting_info：获取单个会议的完整详情

常用示例：

# 查询本周会议
wecom-cli meeting list_user_meetings '{"begin_datetime": "2026-03-23 00:00", "end_datetime": "2026-03-29 23:59", "limit": 100}'

# 创建一场技术评审会议
wecom-cli meeting create_meeting '{"title": "技术方案评审", "meeting_start_datetime": "2026-03-30 15:00", "meeting_duration": 3600, "invitees": {"userid": ["zhangsan", "lisi"]}}'

# 获取会议详情
wecom-cli meeting get_meeting_info '{"meetingid": "MEETING_ID"}'

# 取消会议
wecom-cli meeting cancel_meeting '{"meetingid": "MEETING_ID"}'

通过这些命令，你可以快速在终端里安排或查看本周的所有会议安排。

消息（msg）

消息品类支持查看历史聊天、下载文件和发送文本。

可用工具：

  • get_msg_chat_list：按时间范围查询有消息的会话列表
  • get_message：拉取指定会话的消息记录（支持文本、图片、文件、语音、视频等多种类型）
  • get_msg_media：下载消息中的多媒体文件到本地
  • send_message：向单聊或群聊发送文本消息

常用示例：

# 获取最近一周会话列表
wecom-cli msg get_msg_chat_list '{"begin_time": "2026-03-22 00:00:00", "end_time": "2026-03-29 23:59:59"}'

# 拉取某个单聊的聊天记录
wecom-cli msg get_message '{"chat_type": 1, "chatid": "zhangsan", "begin_time": "2026-03-29 09:00:00", "end_time": "2026-03-29 18:00:00"}'

# 发送文本消息
wecom-cli msg send_message '{"chat_type": 1, "chatid": "zhangsan", "msgtype": "text", "text": {"content": "hello"}}'

# 下载多媒体文件
wecom-cli msg get_msg_media '{"media_id": "MEDIA_ID"}'

这个品类特别实用，当你需要批量导出聊天记录或快速回复消息时，终端命令能节省大量时间。

日程（schedule）

日程管理支持 CRUD 和闲忙查询。

可用工具：

  • get_schedule_list_by_range：查询时间范围内的日程 ID 列表
  • get_schedule_detail：批量获取日程详情（最多 50 个）
  • create_schedule：创建日程，支持提醒、参与人等设置
  • update_schedule：修改日程（只需传入需要修改的字段）
  • cancel_schedule：取消日程
  • add_schedule_attendees：添加参与人
  • del_schedule_attendees：移除参与人
  • check_availability：查询多成员（1-10 人）的闲忙状态

常用示例：

# 查询今天的所有日程
wecom-cli schedule get_schedule_list_by_range '{"start_time": "2026-03-29 00:00:00", "end_time": "2026-03-29 23:59:59"}'

# 获取具体日程详情
wecom-cli schedule get_schedule_detail '{"schedule_id_list": ["SCHEDULE_ID"]}'

# 创建带提醒和参与人的日程
wecom-cli schedule create_schedule '{"schedule": {"start_time": "2026-03-30 14:00:00", "end_time": "2026-03-30 15:00:00", "summary": "需求评审", "attendees": [{"userid": "zhangsan"}], "reminders": {"is_remind": 1, "remind_before_event_secs": 900, "timezone": 8}}}'

# 查询团队成员闲忙
wecom-cli schedule check_availability '{"check_user_list": ["zhangsan", "lisi"], "start_time": "2026-03-30 09:00:00", "end_time": "2026-03-30 18:00:00"}'

日程品类让你在安排会议或任务时，先快速确认大家的时间是否空闲，避免来回协调。

文档与智能表格（doc）

这个品类同时支持普通文档和智能表格。

普通文档操作：

  • create_doc：创建文档（doc_type=3 为普通文档）
  • get_doc_content：获取文档内容（Markdown 格式，支持异步轮询）
  • edit_doc_content：用 Markdown 覆写文档正文

智能表格操作：

  • create_doc：创建智能表格（doc_type=10）
  • smartsheet_get_sheet：查询所有子表
  • smartsheet_add_sheet、smartsheet_update_sheet、smartsheet_delete_sheet：子表管理
  • smartsheet_get_fields、smartsheet_add_fields、smartsheet_update_fields、smartsheet_delete_fields：字段（列）管理
  • smartsheet_get_records、smartsheet_add_records、smartsheet_update_records、smartsheet_delete_records：记录增删改查

常用示例：

# 创建普通文档
wecom-cli doc create_doc '{"doc_type": 3, "doc_name": "项目周报"}'

# 创建智能表格
wecom-cli doc create_doc '{"doc_type": 10, "doc_name": "任务跟踪表"}'

# 查询智能表格子表
wecom-cli doc smartsheet_get_sheet '{"docid": "DOC_ID"}'

# 查询子表字段
wecom-cli doc smartsheet_get_fields '{"docid": "DOC_ID", "sheet_id": "SHEET_ID"}'

# 添加记录到智能表格
wecom-cli doc smartsheet_add_records '{"docid": "DOC_ID", "sheet_id": "SHEET_ID", "records": [{"values": {"标题": [{"type": "text", "text": "新任务"}]}}]}'

文档和表格的操作支持 Markdown 格式，特别适合需要结构化数据管理的团队。

AI Agent Skills：专为智能助手准备

wecom-cli 特别提供了 12 个 AI Agent Skills，让 AI 工具可以直接调用企业微信能力。以下是完整列表：

Skill 品类 说明
wecomcli-lookup-contact contact 通讯录成员查询，按姓名/别名搜索
wecomcli-get-todo-list todo 待办列表查询，支持时间过滤和分页
wecomcli-get-todo-detail todo 待办详情批量查询
wecomcli-edit-todo todo 待办创建、更新、删除、状态变更
wecomcli-create-meeting meeting 创建预约会议
wecomcli-edit-meeting meeting 取消会议、更新受邀成员
wecomcli-get-meeting meeting 查询会议列表和详情
wecomcli-get-msg msg 会话列表、消息记录、媒体下载、文本发送
wecomcli-manage-schedule schedule 日程 CRUD、参与人管理、闲忙查询
wecomcli-manage-doc doc 文档创建/读取/编辑
wecomcli-manage-smartsheet-schema smartsheet 智能表格子表与字段管理
wecomcli-manage-smartsheet-data smartsheet 智能表格记录增删改查

这些 Skills 让 AI Agent 能够像人类一样在终端里操作企业微信，极大扩展了自动化场景。

命令参考：如何查看帮助和使用子命令

查看整体帮助

wecom-cli --help

它会列出所有支持的品类命令：init、contact、doc、meeting、msg、schedule、todo。

查看某个品类下的所有工具

不带方法名直接运行品类命令即可：

wecom-cli contact
wecom-cli todo

调用具体工具

格式统一为：

wecom-cli <category> <method> [json_args]

JSON 参数可以直接写在命令里，也可以省略（部分工具支持无参数调用）。

所有示例都在前面各品类中给出，你可以直接复制使用。

常见问题解答

Q：wecom-cli 适合什么样的人使用？
A：适合需要在终端快速处理企业微信事务的开发者、运维人员，以及正在构建 AI Agent 的团队。普通用户也可以通过简单命令完成日常操作。

Q：凭证配置后还能修改吗？
A：可以再次运行 wecom-cli init 重新配置，凭证会覆盖更新并加密存储在 ~/.config/wecom/bot.enc。

Q：JSON 参数太复杂怎么办？
A：工具的每个方法都提供了清晰的示例。你可以先运行品类命令查看可用工具，再参考本文中的具体 JSON 结构。参数字段含义都在示例里说明得很清楚。

Q：AI Agent 如何使用这些 Skills？
A：安装 CLI SKILL 后，主流 AI 工具就能直接识别并调用 wecomcli- 开头的 Skills，实现自动化操作。

Q：智能表格的操作是不可逆的吗？
A：删除子表、删除字段、删除记录的操作确实不可撤销，使用前请确认数据已备份。

Q：会议查询的时间范围有限制吗？
A：list_user_meetings 默认支持查询当日前后 30 天的会议，你可以通过 begin_datetime 和 end_datetime 精确控制。

Q：消息下载的文件保存在哪里？
A：get_msg_media 会把多媒体文件下载到当前终端的工作目录，你可以自行指定路径或后续移动。

这些问题基本覆盖了大多数用户第一次使用时会遇到的疑惑。如果你还有其他具体操作疑问，可以直接运行对应品类的帮助命令查看最新信息。

总结

wecom-cli 把企业微信的通讯录、待办、会议、消息、日程、文档和智能表格这些核心业务全部搬到了命令行里。它不仅操作简单、覆盖全面，还特别为 AI Agent 准备了 12 个 Skills，让自动化成为可能。

从安装、配置到实际调用，每一步都设计得直观高效。无论你是想在终端里快速查询成员、安排会议，还是让 AI 助手帮你管理待办和日程，wecom-cli 都能提供实实在在的帮助。

工具基于 MIT 许可证开源，你可以自由使用和修改。建议先按照本文的步骤安装试用一次，相信你很快就会把它加入日常工具链。

（全文约 4500 字，全部内容均来自 wecom-cli 官方说明，旨在帮助你快速掌握这项实用工具。）