dingtalk-document

What This Skill Does

The dingtalk-document skill is a comprehensive automation module for OpenClaw designed to manage DingTalk Knowledge Bases and documents programmatically. It serves as the primary interface for users to interact with enterprise-grade documentation through natural language, eliminating the need to navigate complex GUI menus. By leveraging the DingTalk Open Platform APIs, this skill handles workspace enumeration, document creation, hierarchical node management (folders/files), content read/write operations, and user permission administration. The skill is built on a robust helper script architecture, ensuring that authentication, token management, and identity resolution (userId to unionId) are handled consistently and securely.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface: clawhub install openclaw/skills/skills/breath57/dingtalk-document

Ensure that you have your DingTalk AppKey, AppSecret, and your organizational userId ready, as the setup process will trigger a configuration verification workflow to initialize the necessary environmental variables.

Use Cases

• Project Documentation Management: Automatically create folders for new projects and generate template documents for meeting minutes or technical specs.
• Content Automation: Sync internal knowledge bases by reading existing documentation and updating content via external triggers or LLM processing.
• Access Control: Efficiently add or remove team members from specific knowledge bases or sensitive document nodes based on project status changes.
• Knowledge Discovery: Quickly search and retrieve lists of workspaces or files to identify project status without leaving the OpenClaw context.

Example Prompts

1. "钉钉文档，帮我列出我所在的所有知识库，并告诉我每个库的ID是什么。"
2. "创建一个名为'Q3项目规划'的新文档，放在'研发部'知识库的根目录下，并写入初始化的大纲。"
3. "读取知识库ID为'12345'中名为'技术文档'的文件内容，并把全文总结一下告诉我。"

Tips & Limitations

• Authentication: Always ensure DINGTALK_MY_OPERATOR_ID is correctly configured via the helper script, as most APIs will fail without the proper unionId mapping.
• Error Handling: If you encounter an API 401 error, the skill is designed to support the --nocache flag within the internal helper, which forces a fresh token retrieval. Always use the /tmp/<task>.sh workflow for complex operations to avoid truncation issues common in shell environments.
• Permission Scope: The skill's actions are strictly governed by the app's permission settings in the DingTalk Developer Console. If an operation is denied, verify that the application has been granted the necessary 'Knowledge Base Read/Write' scopes in the DingTalk management portal.