| name | dingtalk-approval |
| description | 当用户要求'发起审批'、'查看审批'、'催办审批'、'请假'、'报销'、'采购申请',或提到钉钉OA审批相关操作时使用此技能。管理钉钉审批流程:发起审批实例、查询审批状态、获取审批列表、催办超时审批。 |
| version | 0.1.0 |
| metadata | {"openclaw":{"emoji":"📋","requires":{"env":["DINGTALK_APP_KEY","DINGTALK_APP_SECRET"],"bins":["curl","jq"]},"primaryEnv":"DINGTALK_APP_KEY"}} |
钉钉审批流操作技能
通过钉钉开放平台 OA 审批 API,实现审批实例的发起、查询、催办等操作。
前置条件
- 需要在钉钉开放平台创建企业内部应用
- 应用需申请以下权限:审批实例读写权限(全部 5 个审批相关权限)
- 环境变量
DINGTALK_APP_KEY 和 DINGTALK_APP_SECRET 已配置
获取 Access Token
所有 API 调用前,先获取 access_token(有效期 7200 秒,可缓存):
ACCESS_TOKEN=$(curl -s "https://oapi.dingtalk.com/gettoken?appkey=${DINGTALK_APP_KEY}&appsecret=${DINGTALK_APP_SECRET}" | jq -r '.access_token')
核心操作
1. 获取审批模板列表
查询企业已有的审批模板,获取 process_code(发起审批必需):
curl -s -X POST "https://oapi.dingtalk.com/topapi/process/listbyuserid?access_token=${ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d '{
"userid": "<发起人的userId>",
"offset": 0,
"size": 100
}' | jq