← Back to Skills Marketplace
4365
Downloads
8
Stars
36
Active Installs
11
Versions
Install in OpenClaw
/install dingtalk-api
Description
调用钉钉开放平台API，支持用户搜索/详情/查询、部门管理（搜索/详情/子部门/用户列表/父部门）、机器人单聊消息发送、群聊消息发送、群内机器人列表查询、离职记录查询。Use when needing to search DingTalk users or departments, get user/depart...
Usage Guidance
Install only if you control the DingTalk app credentials and can restrict its permissions. Use a dedicated least-privilege app, avoid enabling approval-write scopes unless required, require human confirmation before messaging or approval actions, and avoid --debug in shared logs because responses may contain employee or workflow data.
Capability Analysis
Type: OpenClaw Skill
Name: dingtalk-api
Version: 1.4.0
The skill bundle is designed to interact with the DingTalk API for user, department, messaging, and approval management. All code consistently calls official DingTalk API endpoints (`oapi.dingtalk.com`, `api.dingtalk.com`) after obtaining an access token using `DINGTALK_APP_KEY` and `DINGTALK_APP_SECRET` from environment variables. There is no evidence of data exfiltration to unauthorized third parties, persistence mechanisms, arbitrary shell execution beyond the intended `npx ts-node` invocations, or prompt injection attempts in `SKILL.md` or `README.md` to mislead the agent into malicious actions. The dependencies in `package-lock.json` are standard for the stated functionality. Input arguments are passed directly to DingTalk API parameters, which is expected for an API client and does not introduce vulnerabilities within the skill itself.
Capability Assessment
Purpose & Capability
The implementation coherently targets DingTalk APIs for directory, messaging, HR-status, and OA approval workflows, but the top-level SKILL frontmatter under-discloses approval-management and some HR-sensitive capabilities that are documented later in SKILL.md, README.md, and package.json.
Instruction Scope
State-changing commands can send chats, create approvals, terminate approvals, approve or reject tasks, transfer tasks, and add comments using arbitrary supplied IDs; the artifacts do not add confirmation gates, allowlists, role checks, or clear read/write separation.
Install Mechanism
Installation is conventional npm/ClawHub/Git usage with standard DingTalk/AliCloud dependencies and no postinstall execution found. CLAUDE.md contains maintainer-oriented publish instructions that include git push and clawhub publish after a publish request, which should require explicit confirmation if followed by an agent.
Credentials
DINGTALK_APP_KEY and DINGTALK_APP_SECRET are expected for a DingTalk API client, but the effective authority depends on the app's enterprise permissions and can include PII, HR status, messaging, and workflow mutation; least-privilege and data-handling guidance is thin.
Persistence & Privilege
No local persistence, background worker, broad filesystem indexing, credential-store access, or third-party exfiltration path was found; scripts call official DingTalk endpoints and print results to stdout/stderr.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install dingtalk-api - After installation, invoke the skill by name or use
/dingtalk-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.4.0
新增 OA 审批 API 功能，支持查询审批记录、发起/撤销审批、执行任务、转交任务、添加评论等操作
v1.3.1
security: 移除不安全的 Git hook 脚本，消除潜在的安全隐患
v1.3.0
新增10个用户管理API：部门父部门列表、用户父部门列表、用户详情、部门用户详情（分页）、部门用户ID列表、员工人数、未登录用户列表、手机号查用户、unionid查用户、离职记录查询
v1.2.2
修复部门管理API：切换到钉钉TOP API端点(oapi.dingtalk.com)，解决InvalidAction.NotFound错误
v1.2.1
修正部门管理 API 端点路径：使用钉钉标准的 POST + body 参数格式
v1.2.0
新增部门管理只读查询功能：搜索部门、获取部门详情、获取子部门列表、获取部门用户列表
v1.1.0
新增机器人单聊/群聊消息发送、群内机器人列表查询，重构文档
v1.0.3
钉钉API技能 - 更新reamme文档
v1.0.2
钉钉API技能 - 初始技能
v1.0.1
钉钉API技能 - 更新reamme文档
v1.0.0
钉钉API技能 - 支持用户搜索功能
Metadata
Frequently Asked Questions
What is DingTalk API?
调用钉钉开放平台API，支持用户搜索/详情/查询、部门管理（搜索/详情/子部门/用户列表/父部门）、机器人单聊消息发送、群聊消息发送、群内机器人列表查询、离职记录查询。Use when needing to search DingTalk users or departments, get user/depart... It is an AI Agent Skill for Claude Code / OpenClaw, with 4365 downloads so far.
How do I install DingTalk API?
Run "/install dingtalk-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is DingTalk API free?
Yes, DingTalk API is completely free (open-source). You can download, install and use it at no cost.
Which platforms does DingTalk API support?
DingTalk API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created DingTalk API?
It is built and maintained by ogenes (@ogenes); the current version is v1.4.0.
More Skills