dingtalk-tb-ai-skill

What This Skill Does

The dingtalk-tb-ai-skill is an integration designed to empower OpenClaw agents to interface directly with Teambition, a robust project management platform. This skill enables the automation of project administration, task tracking, and team collaboration workflows through a specialized Python-based runtime environment. By leveraging Teambition Query Language (TQL), it allows for granular control over task data, enabling users to query, update, create, and monitor the progress of complex project workstreams.

Installation

To begin, ensure you have the OpenClaw environment configured. Navigate to the skill directory and synchronize the dependencies using uv sync.

Authentication

1. Obtain your Token from the Teambition Open Platform.
2. Configure it via environment variables by exporting TB_USER_TOKEN in your shell, or add it to your ~/.openclaw/openclaw.json configuration file under the skill entry settings to ensure persistent authorization for your agent.

Use Cases

• Project Coordination: Efficiently pull task lists filtered by priority or due date to prioritize daily stand-ups.
• Task Lifecycle Management: Transition tasks between stages, update metadata, or append comments to document ongoing progress.
• Team Insight: Quickly identify overdue tasks or unassigned work items to balance team workload.
• Administrative Automation: Bulk update task priorities or filter project-specific requirements using structured TQL queries.

Example Prompts

• "List all my pending tasks that were due before today and sort them by due date."
• "Create a new task in project ID '12345' titled 'Finalize documentation' assigned to me."
• "Search for all tasks in the 'Marketing' project that mention the keyword 'Q3 Review' and summarize their current status."

Tips & Limitations

• Tips: Master the TQL syntax provided in the documentation to perform complex filtering. Use order by clauses to keep your output organized. If you frequently fetch specific metadata, leverage the --extra-fields parameter in the detail query scripts.
• Limitations: This skill is strictly for Teambition. It cannot interact with Jira, Asana, or other project management tools. It is not designed to replace native administrative settings that require full GUI access, and it expects a configured TB_USER_TOKEN for every request. Always verify query results when performing bulk updates to ensure data integrity.