dingtalk-api调用钉钉开放平台API，支持用户搜索/详情/查询、部门管理（搜索/详情/子部门/用户列表/父部门）、机器人单聊消息发送、群聊消息发送、群内机器人列表查询、离职记录查询。Use when needing to search DingTalk users or departments, get user/depart...
Install via ClawdBot CLI:
clawdbot install ogenes/dingtalk-api用于调用钉钉开放平台 API 的技能，支持用户搜索/详情/查询、部门管理（搜索/详情/子部门/用户列表/父部门）、机器人消息发送、群内机器人查询、离职记录查询、OA审批管理（查询/发起/审批/转交/评论）等功能。
DINGTALK_APP_KEY 和 DINGTALK_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_CREDENTIALS - 未设置环境变量INVALID_ARGUMENTS - 参数不足AUTH_FAILED - access_token 获取失败UNKNOWN_ERROR - API 调用异常Generated Mar 1, 2026
HR teams can use this skill to automate employee onboarding/offboarding processes. They can search for users by name or mobile number, get detailed user information including department assignments, and query resignation records to maintain accurate employee databases. The ability to list inactive users helps track engagement and compliance.
Organizations can use the robot messaging functions to send important announcements to specific users or groups. Teams can target messages by department using department user lists, ensuring relevant communications reach the right audiences. The bot list query helps manage which automated systems are active in different chat groups.
IT administrators and organizational managers can use the department functions to map and maintain company hierarchy. They can search departments, get parent/child relationships, and understand reporting structures. This helps with organizational planning, access control setup, and ensuring proper department assignments for new hires.
Management can track employee activity by querying inactive users and monitoring login patterns. Combined with department user lists and user details, this helps identify teams or individuals who may need additional support or training. The user count function provides quick workforce metrics for reporting.
HR software companies can integrate DingTalk API functionality into their platforms to offer enhanced employee management features. This allows them to provide automated user synchronization, department mapping, and communication tools as premium add-ons to their core HR systems.
Consulting firms can build custom internal tools for enterprises that leverage DingTalk's organizational data. These tools might include automated reporting dashboards, compliance monitoring systems, or communication workflow automation that uses the user and department management functions.
Analytics companies can create products that combine DingTalk user activity data with other metrics to provide insights into workforce productivity and engagement. The inactive user tracking combined with department structures enables detailed analysis of team performance and collaboration patterns.
💬 Integration Tip
Ensure your DingTalk application has the correct API permissions enabled before implementation, as different functions require specific scopes like user read access or robot messaging permissions.
Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.
Connect to 100+ APIs (Google Workspace, Microsoft 365, GitHub, Notion, Slack, Airtable, HubSpot, etc.) with managed OAuth. Use this skill when users want to...
Build, debug, and deploy websites using HTML, CSS, JavaScript, and modern frameworks following production best practices.
YouTube Data API integration with managed OAuth. Search videos, manage playlists, access channel data, and interact with comments. Use this skill when users want to interact with YouTube. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Scaffold, test, document, and debug REST and GraphQL APIs. Use when the user needs to create API endpoints, write integration tests, generate OpenAPI specs, test with curl, mock APIs, or troubleshoot HTTP issues.
Search for jobs across LinkedIn, Indeed, Glassdoor, ZipRecruiter, Google Jobs, Bayt, Naukri, and BDJobs using the JobSpy MCP server.