Wecom Calendar

# 📅 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. 环境变量

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

## 📖 使用示例

### 创建一次性日程

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

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

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

## ✅ 功能特性

- ✅ 创建日程（一次性/重复/全天）
- ✅ 查询日程列表和详情
- ✅ 更新日程信息
- ✅ 取消日程
- ✅ 添加/删除参与者
- ✅ 重复日程（每日/每周/每月/每年）
- ✅ 提醒设置（多个提醒时间）
- ✅ 时区支持

## 🚀 快速开始

### 1. 安装依赖

```bash
cd /root/.openclaw/workspace/skills/wecom-calendar
npm install
```

### 2. 配置环境变量

创建 `.env` 文件：

```bash
WECOM_CORP_ID=ww6dddd750e5f1d37a
WECOM_AGENT_ID=1000004
WECOM_AGENT_SECRET=xxx
```

### 3. 企业微信后台配置

1. 登录 https://work.weixin.qq.com/
2. 协作 → 日程 → 可调用接口的应用 → 添加你的应用
3. 应用管理 → 你的应用 → 企业可信 IP → 添加服务器 IP

### 4. 使用示例

```bash
# 创建日程
node calendar.mjs add --summary "会议" --start 1773462000 --end 1773471600

# 创建重复日程（每周六）
node calendar.mjs add --summary "英语课" --start 1773462000 --end 1773471600 --repeat 1 --repeat-type 1 --repeat-day-of-week 6

# 获取日程列表
node calendar.mjs list --cal_id "wcH5NrPwAA..."

# 更新日程（添加参与者）
node calendar.mjs update --schedule_id "xxx" --attendees "user1,user2"

# 取消日程
node calendar.mjs cancel --schedule_id "xxx"
```

## 📖 完整文档

查看 [SKILL.md](./SKILL.md) 获取完整使用说明和 API 文档。

## 🎯 实际案例

### 创建团队周例会

```bash
node calendar.mjs add \
  --summary "团队周例会" \
  --start 1773462000 \
  --end 1773471600 \
  --repeat 1 \
  --repeat-type 1 \
  --repeat-day-of-week 1 \
  --remind 1 \
  --remind-before 900
```

### 创建月度汇报

```bash
node calendar.mjs add \
  --summary "月度汇报" \
  --start 1775376000 \
  --end 1775383200 \
  --repeat 1 \
  --repeat-type 2 \
  --repeat-day-of-month 1
```

## 📦 文件结构

```
wecom-calendar/
├── calendar.mjs      # 主程序
├── package.json      # 依赖配置
├── SKILL.md          # 完整文档
├── README.md         # 快速入门
├── .env.example      # 配置示例
└── clawhub.yaml      # ClawHub 配置
```

## 🔗 相关链接

- [GitHub](https://github.com/davinwang/we...