WeCom Calendar

Manage WeCom calendars and schedules with APIs to create, query, update, delete events, support repeats, reminders, attendees, and timezone settings.

Security Scan

The skill's code and docs implement a WeCom calendar client (which legitimately needs WeCom credentials), but the registry metadata does not declare the required secrets and there are minor inconsistencies—so review before installing.

Purpose & Capability

The name, README, SKILL.md and calendar.mjs all align: this is a WeCom (企业微信) calendar client using the official qyapi.weixin.qq.com endpoints. The code implements create/list/get/update/cancel calendar APIs as described. However, the registry metadata lists no required environment variables while the SKILL.md and code clearly expect WECOM_CORP_ID, WECOM_AGENT_ID and WECOM_AGENT_SECRET—an inconsistency between declared registry requirements and actual runtime needs.

Instruction Scope

SKILL.md and calendar.mjs limit behavior to calling WeCom API endpoints and local configuration (.env). Examples include a curl call to qyapi.weixin.qq.com and node invocations. The instructions do not direct the agent to read unrelated system files, exfiltrate data to third-party endpoints, or perform unrelated system actions.

Install Mechanism

There is no installer or remote download; this is instruction/code-only. Dependencies are standard npm packages (axios, dotenv) declared in package.json. No unusual or remote install URLs, archive extraction, or post-install scripts are present.

Credentials

The skill requires sensitive credentials (WECOM_CORP_ID, WECOM_AGENT_ID, WECOM_AGENT_SECRET) which are appropriate for a WeCom integration. The concern is that the registry metadata did not declare these required environment variables (it lists none), meaning an automated review or user might not be warned that the skill needs secrets. The code also loads a local .env and accesses process.env, so ensure secrets are supplied securely and intentionally.

Persistence & Privilege

The skill does not request always:true, does not alter other skills or global agent configuration, and only runs when invoked. It requires no privileged OS access beyond normal outbound HTTPS calls.

What to consider before installing

This skill appears to be a straightforward WeCom calendar client, but note these points before installing: (1) The SKILL.md and calendar.mjs expect three sensitive environment variables (WECOM_CORP_ID, WECOM_AGENT_ID, WECOM_AGENT_SECRET) even though the registry metadata doesn’t declare them—treat this as an omission and supply credentials only if you trust the author. (2) The code only calls qyapi.weixin.qq.com and uses axios/dotenv; review calendar.mjs yourself (it’s small) to confirm there are no hidden endpoints or logging of secrets. (3) Install and run in a controlled environment (or sandbox) and don’t store secrets in public places. (4) If you plan to allow autonomous invocation, be aware the skill can make API calls using your supplied credentials; only enable that if you trust the skill’s source. (5) If possible, confirm the upstream repository (the SKILL.md links a GitHub repo) and prefer installing a vetted release from there. If you want, I can point out the exact lines in calendar.mjs that read env vars and make API calls.

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

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

✅ 已验证功能

1. 日程管理

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

2. 日历管理

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

3. 高级功能

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

🔧 配置要求

1. 企业微信后台配置

必须配置：

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

可选配置：

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

2. 环境变量

WECOM_CORP_ID=ww6dddd750e5f1d37a          # 企业 ID
WECOM_AGENT_ID=1000004                     # 应用 ID
WECOM_AGENT_SECRET=xxx                     # 应用 Secret

📖 使用示例

创建一次性日程

node calendar.mjs add \
  --summary "项目启动会" \
  --description "讨论项目计划和分工" \
  --start 1741420800 \
  --end 1741424400 \
  --location "10 楼会议室"

创建重复日程（每周六）

node calendar.mjs add \
  --summary "王烙饼的英语课" \
  --start 1773462000 \
  --end 1773471600 \
  --repeat 1 \
  --repeat-type 1 \
  --repeat-day-of-week 6 \
  --repeat-until 1782835140 \
  --remind 1 \
  --remind-before 3600

获取日程列表

node calendar.mjs list \
  --cal_id "wcH5NrPwAAreot8LFnpjZyFZGJM1O5rA" \
  --offset 0 \
  --limit 100

更新日程（添加参与者）

node calendar.mjs update \
  --schedule_id "7424876b4743b9ef6dac5263e43378e2yvsdpisw" \
  --attendees "WangDong,WengWeng" \
  --summary "新标题"

取消日程

node calendar.mjs cancel \
  --schedule_id "7424876b4743b9ef6dac5263e43378e2yvsdpisw"

📊 参数说明

基本参数

参数	必填	说明	示例
--summary	否	日程标题	"会议"
--description	否	日程描述	"项目讨论"
--start	是	开始时间戳	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	无效的 access_token	检查 agentSecret
40058	参数错误	检查请求参数格式
48002	API 无权限	在企业微信后台添加 API 权限
60111	成员不存在	检查 userid 是否正确
60205	日程不存在	检查 schedule_id
60206	无权限操作	检查是否为日程管理员

🎯 实际案例

案例 1：创建团队周例会

node calendar.mjs add \
  --summary "团队周例会" \
  --description "每周团队工作同步" \
  --start 1773462000 \
  --end 1773471600 \
  --repeat 1 \
  --repeat-type 1 \
  --repeat-day-of-week 1 \
  --remind 1 \
  --remind-before 900 \
  --location "线上会议"

案例 2：创建月度汇报

node calendar.mjs add \
  --summary "月度工作汇报" \
  --start 1775376000 \
  --end 1775383200 \
  --repeat 1 \
  --repeat-type 2 \
  --repeat-day-of-month 1 \
  --repeat-until 1803916800 \
  --attendees "manager1,manager2"

案例 3：创建公司全员活动

# 1. 获取所有成员
curl -s "https://qyapi.weixin.qq.com/cgi-bin/user/list?access_token=XXX&department_id=1&fetch_child=1"

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

📝 注意事项

1. 时间戳 - 使用 Unix 时间戳（秒），北京时间需 +8 小时偏移
2. 参与者限制 - 最多 1000 人
3. 管理员限制 - 最多 3 人
4. 重复日程 - 时间跨度不能超过 1 年
5. 可信 IP - 必须在企业微信后台配置服务器 IP
6. 权限配置 - 日程 API 需要单独授权（协作 → 日程 → 可调用接口的应用）

🔗 相关文档

• 企业微信日程 API 文档
• 企业微信日历 API 文档
• GitHub 仓库

---

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