dingtalk-todo

What This Skill Does

The dingtalk-todo skill provides comprehensive management capabilities for DingTalk tasks (Todo) directly within the OpenClaw agent environment. It automates the lifecycle of your tasks, including creation, retrieval, updates, and completion. By leveraging the DingTalk Open Platform APIs, the skill handles identity management, allowing users to seamlessly transition between simple task management and complex team collaboration by converting user IDs to union IDs automatically. It is designed to be a persistent, session-aware tool that remembers your configurations, ensuring a frictionless experience for recurring workflows.

Installation

To integrate this skill into your OpenClaw agent, execute the following command in your terminal: clawhub install openclaw/skills/skills/breath57/dingtalk-todo

Upon the first run, the skill will guide you through a one-time configuration process. It stores your AppKey, AppSecret, and User ID in a local configuration file located at ~/.dingtalk-skills/config to ensure secure and persistent access across multiple chat sessions.

Use Cases

• Personal Productivity: Quickly capture tasks during meetings or brainstorms without switching browser tabs.
• Team Coordination: Assign tasks to colleagues by looking up their user IDs and converting them into actionable DingTalk Todo items.
• Workflow Tracking: Monitor your pending tasks and filter them by completion status to stay organized throughout the day.
• Deadline Management: Set specific due dates, priorities, and descriptions to ensure nothing falls through the cracks.

Example Prompts

1. "创建待办：明天上午十点前完成项目周报编写，优先级设为高。"
2. "查看我所有尚未完成的待办任务，并标记第一个任务为已完成。"
3. "给我的同事张三指派一个待办，内容是审阅产品需求文档，截止时间设为本周五下班前。"

Tips & Limitations

• Security: Never share your AppSecret. The skill is designed to redact sensitive information in logs, showing only the first four characters followed by asterisks.
• ID Requirements: Ensure you have access to the DingTalk management console to retrieve your correct userId. The skill handles the unionId conversion automatically.
• Scripting: For complex operations, the agent utilizes temporary shell scripts to prevent input truncation. This ensures that multi-line logic and variable assignments are executed reliably without syntax errors caused by terminal stream limitations.
• Persistence: Configuration is stored locally. If you migrate your environment, be sure to back up the ~/.dingtalk-skills/ directory.