调用钉钉开放平台API，支持用户搜索/详情/查询、部门管理（搜索/详情/子部门/用户列表/父部门）、机器人单聊消息发送、群聊消息发送、群内机器人列表查询、离职记录查询。Use when needing to search DingTalk users or departments, get user/depart...
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
用于调用钉钉开放平台 API 的技能，支持用户搜索/详情/查询、部门管理（搜索/详情/子部门/用户列表/父部门）、机器人消息发送、群内机器人查询、离职记录查询、OA审批管理（查询/发起/审批/转交/评论）等功能。
DINGTALK_APP_KEYDINGTALK_APP_SECRETexport DINGTALK_APP_KEY="<your-app-key>" export DINGTALK_APP_SECRET="<your-app-secret>"
根据姓名搜索用户，返回匹配的 UserId 列表。
npx ts-node scripts/search-user.ts "<搜索关键词>"
输出：
{ "success": true, "keyword": "张三", "totalCount": 3, "hasMore": false, "userIds": ["123456789", "987654321"] }
根据名称搜索部门，返回匹配的部门 ID 列表。
npx ts-node scripts/search-department.ts "<搜索关键词>" [--debug]
输出：
{ "success": true, "keyword": "技术部", "totalCount": 2, "hasMore": false, "departmentIds": [12345, 67890] }
获取指定部门的详细信息。
npx ts-node scripts/get-department.ts <deptId> [--debug]
输出：
{ "success": true, "department": { "deptId": 12345, "name": "技术部", "parentId": 1 } }
获取指定部门下的子部门 ID 列表。根部门 deptId 为 1。
npx ts-node scripts/list-sub-departments.ts <deptId> [--debug]
输出：
{ "success": true, "deptId": 1, "subDepartmentIds": [12345, 67890, 11111] }
获取指定部门下的用户列表（userId + 姓名），自动分页获取全部用户。
npx ts-node scripts/list-department-users.ts <deptId> [--debug]
输出：
{ "success": true, "deptId": 12345, "users": [ { "userId": "user001", "name": "张三" }, { "userId": "user002", "name": "李四" } ] }
通过机器人向指定用户发送单聊消息。
npx ts-node scripts/send-user-message.ts "<userId>" "<robotCode>" "<消息内容>" [--debug]
输出：
{ "success": true, "userId": "123456", "robotCode": "robot_code", "processQueryKey": "query_key", "flowControlledStaffIdList": [], "invalidStaffIdList": [], "message": "消息内容" }
通过机器人向指定群会话发送消息。
npx ts-node scripts/send-group-message.ts "<openConversationId>" "<robotCode>" "<消息内容>" [--debug]
输出：
{ "success": true, "openConversationId": "cid", "robotCode": "robot_code", "processQueryKey": "query_key", "message": "消息内容" }
查询群内已配置的机器人列表。
npx ts-node scripts/get-bot-list.ts "<openConversationId>" [--debug]
输出：
{ "success": true, "openConversationId": "cid", "botList": [ { "robotCode": "code", "robotName": "name", "robotAvatar": "url", "openRobotType": 1 } ] }
获取指定用户的详细信息，包括姓名、手机号、邮箱、部门列表等。
npx ts-node scripts/get-user.ts "<userId>" [--debug]
输出：
{ "success": true, "user": { "userid": "user001", "name": "张三", "mobile": "138****1234", "email": "zhangsan@example.com", "dept_id_list": [12345, 67890] } }
获取指定用户所属的所有父部门列表，从直接部门到根部门。
npx ts-node scripts/list-user-parent-departments.ts "<userId>" [--debug]
输出：
{ "success": true, "userId": "user001", "parentIdList": [12345, 67890, 1] }
获取指定部门的所有父部门列表，第一个是自身，最后一个是根部门。
npx ts-node scripts/list-department-parents.ts <deptId> [--debug]
输出：
{ "success": true, "deptId": 12345, "parentIdList": [12345, 67890, 1] }
获取指定部门下所有用户的 userid 列表。
npx ts-node scripts/list-department-user-ids.ts <deptId> [--debug]
输出：
{ "success": true, "deptId": 12345, "userIds": ["user001", "user002", "user003"] }
分页获取部门用户详细信息，支持自定义 cursor 和 size。
npx ts-node scripts/list-department-user-details.ts <deptId> [--cursor <cursor>] [--size <size>] [--debug]
输出：
{ "success": true, "deptId": 12345, "users": [ { "userid": "user001", "name": "张三" }, { "userid": "user002", "name": "李四" } ], "hasMore": true, "nextCursor": 100 }
获取企业员工总数，可选择是否仅统计已激活员工。
npx ts-node scripts/get-user-count.ts [--onlyActive] [--debug]
输出：
{ "success": true, "onlyActive": false, "count": 150 }
根据手机号查询用户 userid。仅企业内部应用可用，只能查询在职员工。
npx ts-node scripts/get-user-by-mobile.ts "<mobile>" [--debug]
输出：
{ "success": true, "mobile": "13800138000", "userId": "user001" }
根据 unionid 获取用户 userid。
npx ts-node scripts/get-user-by-unionid.ts "<unionid>" [--debug]
输出：
{ "success": true, "unionid": "xxxxx", "userId": "user001" }
获取指定日期未登录钉钉的员工列表。只能查询一个月内数据，每天9点后调用才能确保获取前一天数据。
npx ts-node scripts/list-inactive-users.ts "<queryDate>" [--deptIds "id1,id2"] [--offset <offset>] [--size <size>] [--debug]
输出：
{ "success": true, "queryDate": "20240115", "userIds": ["user001", "user002"], "hasMore": false }
查询指定时间范围内的离职员工记录。仅企业内部应用可用。
npx ts-node scripts/list-resigned-users.ts "<startTime>" ["<endTime>"] [--nextToken <token>] [--maxResults <max>] [--debug]
输出：
{ "success": true, "startTime": "2024-01-01T00:00:00+08:00", "endTime": "2024-02-01T00:00:00+08:00", "records": [ { "userId": "user001", "name": "张三", "leaveTime": "2024-01-15T10:00:00Z", "leaveReason": "个人原因" } ] }
获取指定审批模板在时间段内的审批实例 ID 列表。
npx ts-node scripts/list-approval-instance-ids.ts <processCode> --startTime <timestamp> --endTime <timestamp> [--size <size>] [--nextToken <token>] [--debug]
输出：
{ "success": true, "processCode": "PROC-XXX", "instanceIds": ["xxx-123", "xxx-456"], "totalCount": 2, "hasMore": false, "nextToken": null }
获取单个审批实例的详细信息，包括表单数据、审批记录、任务列表等。
npx ts-node scripts/get-approval-instance.ts <instanceId> [--debug]
输出：
{ "success": true, "instanceId": "xxx-123", "instance": { "processInstanceId": "xxx-123", "title": "请假申请", "createTimeGMT": "2024-01-01T00:00:00Z", "finishTimeGMT": "2024-01-01T12:00:00Z", "originatorUserId": "user001", "originatorDeptId": "1", "status": "COMPLETED", "processCode": "PROC-XXX", "formComponentValues": [...], "operationRecords": [...], "tasks": [...] } }
获取用户发起的审批实例列表。
npx ts-node scripts/list-user-initiated-approvals.ts <userId> [--startTime <timestamp>] [--endTime <timestamp>] [--maxResults <max>] [--nextToken <token>] [--debug]
输出：
{ "success": true, "userId": "user001", "instances": [...], "totalCount": 5, "hasMore": false, "nextToken": null }
获取抄送给用户的审批实例列表。
npx ts-node scripts/list-user-cc-approvals.ts <userId> [--startTime <timestamp>] [--endTime <timestamp>] [--maxResults <max>] [--nextToken <token>] [--debug]
获取用户待处理的审批任务列表。
npx ts-node scripts/list-user-todo-approvals.ts <userId> [--maxResults <max>] [--nextToken <token>] [--debug]
输出：
{ "success": true, "userId": "user001", "instances": [...], "totalCount": 3, "hasMore": false, "nextToken": null }
获取用户已处理的审批实例列表。
npx ts-node scripts/list-user-done-approvals.ts <userId> [--startTime <timestamp>] [--endTime <timestamp>] [--maxResults <max>] [--nextToken <token>] [--debug]
获取用户待审批任务数量。
npx ts-node scripts/get-user-todo-count.ts <userId> [--debug]
输出：
{ "success": true, "userId": "user001", "count": 5 }
创建新的审批实例。
npx ts-node scripts/create-approval-instance.ts <processCode> <originatorUserId> <deptId> '<formValuesJson>' [--ccList "user1,user2"] [--debug]
示例：
npx ts-node scripts/create-approval-instance.ts "PROC-XXX" "user001" "1" '[{"name":"标题","value":"请假申请"},{"name":"请假天数","value":"3"}]'
输出：
{ "success": true, "processCode": "PROC-XXX", "originatorUserId": "user001", "instanceId": "xxx-new" }
撤销/终止指定的审批实例。
npx ts-node scripts/terminate-approval-instance.ts <instanceId> <operatingUserId> [--remark "撤销原因"] [--debug]
输出：
{ "success": true, "instanceId": "xxx-123", "message": "审批实例已终止" }
同意或拒绝审批任务。
npx ts-node scripts/execute-approval-task.ts <instanceId> <userId> <agree|refuse> [--taskId <taskId>] [--remark "审批意见"] [--debug]
示例：
npx ts-node scripts/execute-approval-task.ts "xxx-123" "user001" "agree" --remark "同意申请" npx ts-node scripts/execute-approval-task.ts "xxx-123" "user001" "refuse" --remark "条件不符"
输出：
{ "success": true, "instanceId": "xxx-123", "userId": "user001", "action": "agree", "message": "已同意审批" }
将审批任务转交给其他用户处理。
npx ts-node scripts/transfer-approval-task.ts <instanceId> <userId> <transferToUserId> [--taskId <taskId>] [--remark "转交原因"] [--debug]
输出：
{ "success": true, "instanceId": "xxx-123", "userId": "user001", "transferToUserId": "user002", "message": "审批任务已转交" }
为审批实例添加评论。
npx ts-node scripts/add-approval-comment.ts <instanceId> <userId> "<comment>" [--debug]
输出：
{ "success": true, "instanceId": "xxx-123", "userId": "user001", "message": "评论已添加" }
所有脚本在错误时返回统一格式：
{ "success": false, "error": { "code": "ERROR_CODE", "message": "错误描述" } }
常见错误码：
MISSING_CREDENTIALSINVALID_ARGUMENTSAUTH_FAILEDUNKNOWN_ERRORNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.