WeCom Calendar

📅 WeCom Calendar - 企业微信日历管理

企业微信日程管理完整工具，支持创建、查询、更新、删除日程，以及日历管理。

✅ 已验证功能

• 日程管理

功能 状态 API 说明 创建日程 ✅ 已验证 /oa/schedule/添加 支持一次性/重复/全天事件 获取日程详情 ✅ 已验证 /oa/schedule/获取 批量获取日程详细信息 获取日程列表 ✅ 已验证 /oa/schedule/获取_by_cal_id 按日历 ID 获取日程列表 更新日程 ✅ 已验证 /oa/schedule/更新 修改日程信息、添加参与者 取消日程 ⚠️ 待测试 /oa/schedule/cancel 取消已创建的日程

• 日历管理

功能 状态 API 说明 创建日历 ⚠️ 待测试 /oa/cal/添加 创建共享日历 获取日历列表 ⚠️ 待测试 /oa/cal/获取 获取企业日历列表 更新日历 ⚠️ 待测试 /oa/cal/更新 修改日历信息 删除日历 ⚠️ 待测试 /oa/cal/删除 删除日历

• 高级功能

功能 状态 说明 重复日程 ✅ 已验证 支持每日/每周/每月/每年/工作日重复 提醒设置 ✅ 已验证 支持多个提醒时间（提前 5 分钟/15 分钟/1 小时/1 天等） 参与者管理 ✅ 已验证 最多支持 1000 名参与者，可跟踪参与状态 管理员设置 ⚠️ 待测试 最多 3 名管理员 时区支持 ✅ 已验证 支持 UTC 偏移量设置 (-12 ~ +12) 全天事件 ⚠️ 待测试 支持全天日程标记 🔧 配置要求

• 企业微信后台配置

必须配置：

✅ 应用凭证（corpId, 代理Id, 代理Secret） ✅ 企业可信 IP（添加服务器 IP 到白名单） ✅ 日程管理 API 权限（协作 → 日程 → 可调用接口的应用）

可选配置：

📋 通讯录管理权限（读取成员列表） 📋 日历管理权限（管理共享日历）

• 环境变量

WECOM_CORP_ID=ww6dddd750e5f1d37a # 企业 ID WECOM_代理_ID=1000004 # 应用 ID WECOM_代理_SECRET=xxx # 应用 Secret

📖 使用示例 创建一次性日程 node calendar.mjs 添加 \ --summary "项目启动会" \ --description "讨论项目计划和分工" \ --启动 1741420800 \ --end 1741424400 \ --location "10 楼会议室"

创建重复日程（每周六） node calendar.mjs 添加 \ --summary "王烙饼的英语课" \ --启动 1773462000 \ --end 1773471600 \ --repeat 1 \ --repeat-type 1 \ --repeat-day-of-week 6 \ --repeat-until 1782835140 \ --remind 1 \ --remind-before 3600

获取日程列表 node calendar.mjs 列出 \ --cal_id "wcH5NrPwAAreot8LFnpjZyFZGJM1O5rA" \ --off设置 0 \ --limit 100

更新日程（添加参与者） node calendar.mjs 更新 \ --schedule_id "7424876b4743b9ef6dac5263e43378e2yvsdpisw" \ --attendees "WangDong,WengWeng" \ --summary "新标题"

取消日程 node calendar.mjs cancel \ --schedule_id "7424876b4743b9ef6dac5263e43378e2yvsdpisw"

📊 参数说明 基本参数 参数 必填 说明 示例 --summary 否 日程标题 "会议" --description 否 日程描述 "项目讨论" --启动 是 开始时间戳 1773462000 --end 是 结束时间戳 1773471600 --location 否 地点 "10 楼会议室" --attendees 否 参与者 (逗号分隔) "user1,user2" --cal_id 否 日历 ID "wcH5NrPwAA..." 重复参数 参数 默认值 说明 --repeat 0 是否重复 (0/1) --repeat-type 0 类型：0=每日，1=每周，2=每月，5=每年，7=工作日 --repeat-interval 1 重复间隔 --repeat-until 0 结束时间戳 (0=一直重复) --repeat-day-of-week - 每周周几 (1-7，逗号分隔) --repeat-day-of-month - 每月哪天 (1-31，逗号分隔) --timezone 8 时区 (-12 ~ +12) 提醒参数 参数 默认值 说明 --remind 0 是否提醒 (0/1) --remind-before 300 提前多少秒提醒 --remind-times - 多个提醒时间 (逗号分隔)

支持的提醒时间：

0 - 事件开始时 300 - 提前 5 分钟 900 - 提前 15 分钟 3600 - 提前 1 小时 86400 - 提前 1 天 ⚠️ 错误码说明 错误码 说明 解决方案 0 成功 - 40003 无效的企业 ID 检查 corpId 配置 40014 无效的 访问_令牌 检查 代理Secret 40058 参数错误 检查请求参数格式 48002 API 无权限 在企业微信后台添加 API 权限 60111 成员不存在 检查 userid 是否正确 60205 日程不存在 检查 schedule_id 60206 无权限操作 检查是否为日程管理员 🎯 实际案例 案例 1：创建团队周例会 node calendar.mjs 添加 \ --summary "团队周例会" \ --description "每周团队工作同步" \ --启动 1773462000 \ --end 1773471600 \ --repeat 1 \ --repeat-type 1 \ --repeat-day-of-week 1 \ --remind 1 \ --remind-before 900 \ --location "线上会议"

案例 2：创建月度汇报 node calendar.mjs 添加 \ --summary "月度工作汇报" \ --启动 1775376000 \ --end 1775383200 \ --repeat 1 \ --repeat-type 2 \ --repeat-day-of-month 1 \ --repeat-until 1803916800 \ --attendees "管理器1,管理器2"

案例 3：创建公司全员活动 # 1. 获取所有成员 curl -s "https://qyAPI.weixin.qq.com/cgi-bin/user/列出?访问_令牌=XXX&department_id=1&fetch_child=1"

# 2. 创建日程并添加所有成员 node calendar.mjs 添加 \ --summary "公司年会" \ --启动 1798704000 \ --end 1798732800 \ --attendees "user1,user2,user3,..." \ --location "酒店宴会厅"

📝 注意事项 时间戳 - 使用 Unix 时间戳（秒），北京时间需 +8 小时偏移 参与者限制 - 最多 1000 人 管理员限制 - 最多 3 人 重复日程 - 时间跨度不能超过 1 年 可信 IP - 必须在企业微信后台配置服务器 IP 权限配置 - 日程 API 需要单独授权（协作 → 日程 → 可调用接口的应用） 🔗 相关文档 企业微信日程 API 文档 企业微信日历 API 文档 GitHub 仓库

版本: 1.0.0 作者: OpenClaw Workspace 许可: MIT 最后更新: 2026-03-07