企业官网建设流程全解析

wecom-cli日程与会议完全指南：终端搞定排期、预订会议与纪要获取

【免费下载链接】wecom-cli企业微信开放平台命令行工具 — 让人类和 AI Agent 都能在终端中操作企业微信项目地址: https://gitcode.com/gh_mirrors/we/wecom-cli

wecom-cli 是企业微信开放平台的命令行工具，让人类和 AI Agent 都能在终端中直接操作企业微信。本指南带你用 wecom-cli 快速完成日程预约、会议室预订、忙闲查询、创建在线会议并获取会议纪要，无需反复打开网页端。

一、先搞懂：「日程」和「会议」有什么区别？

这是使用 wecom-cli 日程与会议功能的第一步，也是唯一容易混淆的概念：

💡 简单记忆：要入会链接、要远程参会 → 会议；只是约个时间、订个房间 → 日程。

如果你只说了句"帮我约个会"，AI Agent 会先问你："需要创建日程还是会议？"——这是官方定义的消歧流程，避免建错类型。

详细规则可参考 wecomcli-calendar 技能说明 和 wecomcli-meeting 技能说明。

二、快速上手：安装 wecom-cli 并授权

只需两步即可开始使用，整个过程不到一分钟：

1. 安装 CLI

npm install -g @wecom/cli

2. 企业微信扫码授权（仅首次）

wecom-cli auth init

命令会展示授权链接和二维码，用企业微信扫码即可，授权一次长期有效。可用wecom-cli auth show --status检查授权状态。

完整的安装与授权前置检查流程定义在 wecomcli-shared 公共技能。

三、预约日程：终端一步完成排期

创建日程的核心命令是wecom-cli calendar schedules create，参数以 JSON 传入，例如把"产品评审"约在明天 14:00：

wecom-cli calendar schedules create --json '{ "subject": "产品评审", "begin_time": "2026-09-29 14:00:00", "end_time": "2026-09-29 15:00:00", "attendees": [{"userid": "woxxxa"}, {"userid": "woxxxb"}] }'

几个实用要点：

• 时长不填默认 1 小时，按开始时间向后推算结束时间，不用纠结
• 全天日程（如休假）传is_all_day: true，时间写当天00:00:00 ~ 23:59:59
• 参与人只认 userid（wo前缀）。对 AI Agent 说姓名即可，它会自动经通讯录解析并帮你确认同名候选人
• 创建成功后返回schedule_id，可用于后续的更新、取消操作

⚠️ 注意：目前不支持创建周期/重复日程（每周、每天重复），这类安排需在企业微信客户端手动操作。

完整的预约工作流（信息补全 → 参与人解析 → 忙闲检查 → 创建）见 calendar-create 参考文档。

四、预订会议室：先查空、再占用，避免撞车

wecom-cli 把"查会议室"和"占会议室"拆成了两步，保证你不会把会议室名写进日程却实际没占到房间：

第 1 步：查空——用rooms search查询目标时段的会议室可订性：

wecom-cli meeting rooms search --json '{ "begin_time": "2026-09-29 14:00:00", "end_time": "2026-09-29 15:00:00", "room_keyword": "1605", "min_capacity": 4 }'

返回中target[].status为bookable表示可订；查不到时，接口会按"同楼层优先、容量恰好够用"返回recommendations候选列表，还可以用buildings list查你有权访问的办公楼清单。

第 2 步：占用——创建日程或会议时把查到的meeting_room_id传入create参数，后端会执行"建日程 + 占会议室"的原子操作，房间不会被别人抢走。

💡 如果查询通过后、创建前房间恰好被占（meeting_room_taken），工具会明确提示你换会议室或换时间，不会静默失败。

参数与边界细节见 calendar-meeting-room 参考文档。

五、查忙闲：多人约时间不再"石头剪刀布"

约多人最难的是找共同空闲。wecom-cli 的free list命令直接返回推荐时段，例如查张三李四明天工作时间的共同空闲：

wecom-cli calendar schedules free list --json '{ "userids": [{"userid": "woxxxa"}, {"userid": "woxxxb"}], "begin_time": "2026-09-29 09:00:00", "end_time": "2026-09-29 18:00:00", "min_duration_minutes": 60, "limit": 5 }'

返回的slots已经过服务端合并与筛选，直接告诉你每个时段"谁能参加、谁冲突"：

• 全员空闲→ 挑一个时段直接创建日程
• 部分人冲突→ 会列出冲突人，让你决定按降级时段安排还是换时间
• 完全无空→ 提示你扩大时间窗口或减少参与人

单次查询窗口不超过 24 小时，跨天需求由 Agent 自动分段查询再拼接。更多策略说明见 calendar-freebusy 参考文档。

六、创建在线会议：一步拿到入会链接

创建会议与创建日程几乎同构，只是换成meeting create，且创建时会自动同时生成对应日程，无需重复建：

wecom-cli meeting create --json '{ "subject": "产品需求评审", "begin_time": "2026-09-29 14:00:00", "end_time": "2026-09-29 15:00:00", "attendees": [{"userid": "woxxxa"}, {"userid": "woxxxb"}] }'

创建成功返回meeting_id、meeting_link（入会链接）和 9 位meeting_code（会议号），可直接分享给参会人。

关键约束速览：

对 AI Agent 说"帮我开个会"即可，它会自动完成参会人解析、忙闲检查、会议室预订后创建。完整流程见 meeting-create 参考文档。

七、获取会议纪要与转写原文：会后不靠回忆

会议结束后的两大刚需，wecom-cli 都有对应命令：

1. 智能纪要与待办—— 用meeting get查询详情，返回中的notes字段包含 AI 总结的纪要（note_content）和待办（todo_content）：

wecom-cli meeting get --json '{"meeting_ids": [{"meeting_id": "mtxxxxx"}]}'

2. 转写原文—— 需要"会上到底怎么说的"逐字记录时，用meeting original get：

wecom-cli meeting original get --json '{"meeting_id": "mtxxxxx", "limit": 100}'

返回的original_data是带时间戳和说话人的逐行发言记录；长会议自动翻页拼接完整内容。

💡 一个容易踩的坑：转写原文 ≠ 智能纪要。前者是逐句原始发言，后者是 AI 总结的成品，两者不可互相替代。转写能力的前置条件（如开启会议转写）与分页策略详见 meeting-original-get 参考文档。

八、常见限制与最佳实践

✅新手最佳实践：

1. 把"约人"交给 AI Agent——说清主题、大致时间、人名即可，忙闲检查与冲突协商它会自动完成
2. 只给时间范围（"明天下午"）而不给主题关键词时用列表浏览；带关键词（"项目评审是什么时候"）时用搜索
3. 会议号（9 位数字）是给人入会用的，meeting_id（mt前缀长字符串）才是命令参数，别传混

写在最后

wecom-cli 把企业微信的日程排期、会议室预订、在线会议和纪要获取全部搬进了终端：一条命令约会议、订房间、查忙闲，AI Agent 则能把整套流程编排成"一句话办事"的体验。从今天起，排期不用再切窗口，终端就是效率的入口 🚀

更多命令速查可浏览 wecom-cli 文档 与 项目开发说明。

【免费下载链接】wecom-cli企业微信开放平台命令行工具 — 让人类和 AI Agent 都能在终端中操作企业微信项目地址: https://gitcode.com/gh_mirrors/we/wecom-cli