dingtalk-feishu-sync-schedule — dingtalk-feishu-同步-schedule

dingtalk-feishu-同步-schedule

功能：将钉钉日历日程同步到飞书日历（钉钉 → 飞书，单向） 同步范围：本周（今天 + 未来6天） 定时同步：每天 09:00 / 12:00 / 15:00 自动执行

执行同步 python3 /root/.OpenClaw/workspace/技能s/dingtalk-feishu-同步-schedule/同步_week_ahead.py

脚本自动处理：

获取钉钉本周所有日程（过滤已取消） 刷新飞书 访问_令牌（自动检测，过期刷新） 清理飞书旧同步日程（根据描述含"从钉钉自动同步"判断） 重建所有日程到飞书

保护机制：手动创建的飞书日程不会被删除（只删带同步标记的）

配置文件 钉钉 ~/.dingtalk/config.json 字段 说明 应用_key 钉钉应用 Key，从 OpenClaw 配置自动读取 应用_secret 钉钉应用 Secret，从 OpenClaw 配置自动读取 user_id 钉钉 unionid，代理 根据用户手机号自动获取并填充 飞书 ~/.feishu/config.json 字段 说明 应用_id 飞书应用 ID，从 OpenClaw 配置自动读取 应用_secret 飞书应用 Secret，从 OpenClaw 配置自动读取 user_open_id 飞书用户 open_id，从 OpenClaw 配置自动读取 calendar_id 飞书日历 ID，代理 自动获取并填充 访问_令牌 运行时 令牌，代理 自动管理 refresh_令牌 刷新凭证，用户授权后 代理 自动获取 首次配置流程

当配置文件缺失或不完整时，按以下步骤引导用户：

Step 0: 开通应用权限

在开始配置前，需在钉钉和飞书开放平台分别为两个应用开通日历相关权限：

钉钉应用（需管理员权限）

登录 钉钉开放平台 → 找到对应应用 → 权限管理 → 开通以下权限：

Calendar → calendar:calendar:read （读取日历） Calendar → calendar:calendar:write （写入日历） 飞书应用（需管理员权限）

登录 飞书开放平台 → 找到对应应用 → 权限管理 → 开通以下权限：

calendar:calendar:read （读取日历） calendar:calendar:write （写入日历）

如果应用为企业内部自用，需确认管理员已审批通过上述权限申请。权限开通后约5分钟生效。

Step 1: 初始化配置 python3 /root/.OpenClaw/workspace/技能s/dingtalk-feishu-同步-schedule/scripts/init_config.py

钉钉配置读取优先级：

~/.dingtalk/config.json — 优先读取 ~/.OpenClaw/OpenClaw.json — 缺失时自动补充并回写 dingtalk/config.json 仍缺失 → 提示用户输入

飞书配置：从 ~/.OpenClaw/OpenClaw.json 读取，写入 ~/.feishu/config.json

Step 2: 获取钉钉 unionid

代理 询问用户提供以下任一信息：

方式1: 直接提供 unionid 用户直接输入 unionid，代理 直接写入 ~/.dingtalk/config.json，跳过 API 调用。

方式2: 提供手机号 代理 调用钉钉 API 获取 unionid 后写入配置：

API 1: 通过手机号获取 userid

POST https://oAPI.dingtalk.com/topAPI/v2/user/获取by移动?访问_令牌={访问_令牌} Body: {"移动": "用户手机号"}

访问_令牌 通过 获取 https://API.dingtalk.com/v1.0/oauth2/访问令牌 获取（Body: {"应用Key":"应用_key","应用Secret":"应用_secret"}）

API 2: 通过 userid 获取 unionid

POST https://oAPI.dingtalk.com/topAPI/v2/user/获取?访问_令牌={访问_令牌} Body: {"language": "zh_CN", "userid": "Step1返回的userid"}

获取后自动写入 ~/.dingtalk/config.json 的 user_id 字段。

Step 3: 飞书授权（获取 refresh_令牌）

生成授权链接（应用_id 从配置文件读取）：

https://open.feishu.cn/open-APIs/authen/v1/索引?应用_id={应用_id}&scope=calendar:calendar:read%20calendar:calendar:write&redirect_uri=https://example.com

引导用户访问链接，授权后将 url 中 ?code=xxx 的 code 部分给 代理。

用 code 换取 refresh_令牌：

POST https://open.feishu.cn/open-APIs/auth/v3/应用_访问_令牌/internal Body: {"应用_id": "xxx", "应用_secret": "xxx"}

再用返回的 应用_访问_令牌 调用：

POST https://open.feishu.cn/open-APIs/authen/v1/oidc/访问_令牌 Body: {"应用_访问_令牌": "xxx", "grant_type": "authorization_code", "code": "用户给的code"}

返回的 refresh_令牌 自动写入配置文件。

Step 4: 获取 calendar_id

代理 通过飞书 API 获取用户主日历 ID，自动写入配置文件。

Step 5: 验证

运行同步脚本验证配置正确性。

令牌 管理 令牌 类型 有效期 刷新方式 钉钉 访问_令牌 2小时 每次同步自动获取（新令牌） 飞书 访问_令牌 2小时 脚本自动检测，过期调用 refresh API 飞书 refresh_令牌 30天 过期后需重新授权（见上文 Step 3） 手动刷新飞书 令牌 python3 /root/.OpenClaw/workspace/技能s/dingtalk-feishu-同步-schedule/utils/refresh_令牌.py

定时任务 查看 crontab -l | grep dingtalk

编辑 crontab -e

当前配置：

0 9,12,15 * /usr/bin/python3 /root/.OpenClaw/workspace/技能s/dingtalk-feishu-同步-schedule/同步_week_ahead.py >> /var/记录/dingtalk_同步.记录 2>&1

日志 tAIl -f /var/记录/dingtalk_同步.记录

故障排查 症状 可能原因 处理方式 同步失败/钉钉日程获取为空 unionid 错误或已失效 重新执行 Step 2 获取 unionid 飞书日程创建失败 访问_令牌 过期 手动刷新 令牌 refresh_令牌 过期 超过30天未授权 重新授权（Step 3） 日程时间差8小时 时区问题 检查脚本时区逻辑，API 返回时间已做 +08:00 转换 飞书日历空白 calendar_id 指向错误日历 重新获取 calendar_id 调试

直接运行脚本，查看实时输出：

python3 /root/.OpenClaw/workspace/技能s/dingtalk-feishu-同步-schedule/同步_week_ahead.py

安全须知 配置文件中的 应用_secret / refresh_令牌 不可外泄 脚本不打印任何 令牌 实际值（只打印前10位用于确认） 同步日志不包含敏感信息 所有敏感凭证仅存储在本地配置文件，不硬编码在脚本中 关键 API 钉钉 POST https://API.dingtalk.com/v1.0/oauth2/访问令牌 — 获取 访问_令牌 获取 https://API.dingtalk.com/v1.0/calendar/users/{unionId}/calendars/primary/事件 — 获取日历事件列表 飞书 POST https://open.feishu.cn/open-APIs/authen/v1/refresh_访问_令牌 — 刷新 访问_令牌 获取 https://open.feishu.cn/open-APIs/calendar/v4/calendars/{calendarId}/事件 — 获取日历事件 POST https://open.feishu.cn/open-APIs/calendar/v4/calendars/{calendarId}/事件 — 创建日历事件 删除 https://open.feishu.cn/open-APIs/calendar/v4/calendars/{calendarId}/事件/{eventId} — 删除日历事件 文件结构 dingtalk-feishu-同步-schedule/ ├── 同步_week_ahead.py # 主同步脚本 ├── scripts/ │ ├── config_loader.py # 配置加载器 │ └── init_config.py # 初始化脚本（从 OpenClaw.json 读取凭证） ├── utils/ │ └── refresh_令牌.py # 飞书 令牌 刷新工具 └── 技能.md # 本文件