dingtalk-calendar

name	dingtalk-calendar
description	当用户提到'日历'、'日程'、'会议'、'约会'、'日报'、'周报'、'待办'、'任务'、'todo'，或要求生成工作汇报、查看本周安排时使用此技能。管理钉钉日历事件和待办任务，辅助自动生成日报周报。
version	0.1.0
metadata	{"openclaw":{"emoji":"📅","requires":{"env":["DINGTALK_APP_KEY","DINGTALK_APP_SECRET"],"bins":["curl","jq"]},"primaryEnv":"DINGTALK_APP_KEY"}}

钉钉日历与待办技能

通过钉钉开放平台日历 API 和待办 API，管理日程事件和待办任务。常用于自动生成日报/周报。

获取 Access Token

钉钉新版 API（api.dingtalk.com）使用 Header 鉴权：

ACCESS_TOKEN=$(curl -s "https://oapi.dingtalk.com/gettoken?appkey=${DINGTALK_APP_KEY}&appsecret=${DINGTALK_APP_SECRET}" | jq -r '.access_token')

新版 API 调用时在 Header 中传入：x-acs-dingtalk-access-token: ${ACCESS_TOKEN}

日历操作

1. 查询日历事件列表

获取用户某时间段内的日程：

curl -s -X GET "https://api.dingtalk.com/v1.0/calendar/users/<userId>/calendars/primary/events?timeMin=2026-03-01T00:00:00%2B08:00&timeMax=2026-03-07T23:59:59%2B08:00&maxResults=50" \
  -H "x-acs-dingtalk-access-token: ${ACCESS_TOKEN}" \
  -H "Content-Type: application/json" | jq '.events'

返回值关键字段：