A professional integration for programmatically retrieving and filtering employee reports and work logs from the DingTalk platform.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install dingtalk-log
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install dingtalk-log using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is DingTalk Report List API Integration?
This integration leverages the DingTalk Open Platform topapi/report/list interface to provide AI agents with the ability to query enterprise logs. By using Openclaw Skills, developers can automate the retrieval of daily reports, weekly updates, and custom templates. The skill handles complex filtering by employee ID, template name, and specific time ranges, making it an essential tool for enterprise data synchronization and workflow automation.
The skill provides a structured way to access internal communication data, ensuring that reports containing creator information, timestamps, and specific form contents are easily accessible for further analysis or reporting. It is designed specifically for Internal Enterprise and Third-party Enterprise applications.
DingTalk Report List API Integration Use Cases
- Automating the collection of daily or weekly reports for team performance tracking.
- Syncing work log data into centralized data analytics platforms or dashboards.
- Auditing employee activities and project progress based on specific report templates.
- Generating automated summaries of department-wide report submissions.
How DingTalk Report List API Integration Works
- The process begins by obtaining a valid access_token from the DingTalk OAuth2 service using the appKey and appSecret.
- The skill constructs a POST request including a JSON body with mandatory parameters like start_time, end_time, and pagination settings.
- The request is sent to the DingTalk API endpoint to fetch the first batch of report data.
- The skill parses the result, checking for the errcode and extracting the data_list which contains the report details.
- If the has_more flag is true, the skill utilizes the next_cursor to recursively fetch all remaining pages of data.
DingTalk Report List API Integration Setup
To get started with this integration from Openclaw Skills, follow these steps:
- Ensure your application is registered as an Internal or Third-party Enterprise app on the DingTalk Developer Console.
- Apply for the Query enterprise employee log permission in the console.
- Obtain your appKey and appSecret to generate an AccessToken.
# Example to get access_token
curl -X POST "https://api.dingtalk.com/v1.0/oauth2/accessToken" \
-H "Content-Type: application/json" \
-d '{"appKey": "your_app_key", "appSecret": "your_app_secret"}'
DingTalk Report List API Integration Data Schema & Taxonomy
The skill manages data using a strictly defined JSON structure for both requests and responses.
| Parameter | Type | Required | Description |
|---|---|---|---|
| start_time | Number | Yes | Start time in millisecond Unix timestamp |
| end_time | Number | Yes | End time in millisecond Unix timestamp |
| cursor | Number | Yes | Pagination cursor (initial value is 0) |
| size | Number | Yes | Page size (maximum 20) |
| template_name | String | No | Filter by specific report template name |
The response includes a data_list containing contents (key-value pairs of report fields), creator_name, create_time, and report_id.
DingTalk Report List API Integration Advanced Features
- Cursor-based pagination for handling large datasets without performance degradation.
- Dual-filtering logic allowing queries by either specific template names or individual user IDs.
- Modification-based filtering using modified_start_time to track updated reports.
- Token caching support to prevent API rate limiting from frequent authentication calls.
SKILL.md
Loading
Related Openclaw Skills
Playwright Stealth Scraper
A high-performance MCP skill for Openclaw Skills that bypasses sophisticated anti-bot measures using Playwright Extra and the Stealth plugin.
Google Ads Manager
An AI agent skill designed to manage Google Ads campaigns, budgets, and reporting via the Google Ads API.
Xiaohongshu Content Creator
A specialized content engine designed to generate viral-ready Xiaohongshu posts optimized for the platform's CES engagement algorithm.
Telegram Bot Manager
A specialized tool for registering, configuring, and maintaining Telegram bot integrations within the OpenClaw ecosystem.
Skill Operator (PassDeck)
A high-performance orchestration engine for collaborative AI agent sessions using CRDT-based persistence and cryptographic verification.
Developer Agent
An end-to-end development orchestrator that manages git lifecycles, build checks, and AI-driven implementation for high-quality software delivery.
Featured*
