TickTick Power Skill for Openclaw

A command-line integration and AI agent capability that automates task, project, and attachment management on TickTick and Dida365.

liuboacean
v0.1.3
May 19, 2026
0
779
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install liubo-ticktick-cli

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install liubo-ticktick-cli 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 TickTick Power Skill?

The TickTick Power Skill is a robust tool designed to integrate your task and project workflows seamlessly with your command-line interface or AI agents. Developed to work natively under WorkBuddy and other environments leveraging Openclaw Skills, this tool enables advanced task automation on both TickTick and Dida365 platforms. By leveraging OAuth2 authentication, the skill provides secure and rapid execution of common task operations, project handling, and attachment uploads.

With this tool, developers and AI agents can execute bulk operations, configure priority levels, manage deadlines using natural relative language, and coordinate project directories directly through automated scripts. It acts as an essential productivity block within the broader Openclaw Skills ecosystem, unlocking the potential to turn manual to-do lists into fully automated personal knowledge and scheduling engines.

TickTick Power Skill Use Cases

  • Automating task generation directly from code repositories or CI/CD pipelines.
  • Seamlessly synchronizing action items discovered by AI coding agents into personal or team TickTick lists.
  • Managing complex multi-stage project lists and auto-generating daily/weekly task digests.
  • Uploading local build reports or documents as attachments directly to tasks for centralized reference.
  • Mass-archiving or bulk-abandoning outdated or irrelevant tasks through simple CLI scripts.

How TickTick Power Skill Works

  1. Authentication: Establish a secure connection via OAuth2 (either automated browser flow or manual input) to obtain client credentials and refresh tokens, which are safely stored locally.
  2. Target Identification: Query list or project directories to identify precise target 24-character IDs for correct task categorization.
  3. Task Orchestration: Execute granular CLI operations to create, update, complete, or abandon tasks with rich metadata like priorities, tags, and times.
  4. Attachment Uploading: Use local session cookies to securely upload document attachments directly to specific tasks using TickTick Web Session APIs.
  5. AI Agent Interaction: AI agents programmatically interface with the command-line wrapper using JSON output modes, driving continuous integration loops within the Openclaw Skills framework.

TickTick Power Skill Setup

1. Install Dependencies

Install the skill package directly or install the required requests package:

pip install requests
# Alternatively, install the local development path
pip install -e ~/.workbuddy/skills/ticktickpower/

2. Register Application

  1. Visit the TickTick Developer Center (https://developer.ticktick.com/manage).
  2. Create a new application, and set your Redirect URI to http://localhost:8080.
  3. Record your Client ID and Client Secret.

3. Run OAuth2 Authentication

Authenticate interactively or manually on headless environments:

# Interactive Browser Authentication
python -m ticktick.cli auth --client-id <YOUR_CLIENT_ID> --client-secret <YOUR_CLIENT_SECRET>

# Manual Headless Authentication
python -m ticktick.cli auth --client-id <ID> --client-secret <SECRET> --manual

Ensure that the skill directory ~/.workbuddy/skills/ticktickpower/ is loaded within your environment to enable integration with other Openclaw Skills.

TickTick Power Skill Data Schema & Taxonomy

The skill stores OAuth credentials and session configurations locally at ~/.clawdbot/credentials/ticktick-cli/config.json. Below is the schema layout:

Field Type Description
clientId String The unique client identifier from TickTick Developer Center
clientSecret String The private application secret
accessToken String The active OAuth2 access token
refreshToken String Token used to refresh credentials automatically
tokenExpiry Number Millisecond timestamp indicating token expiration
redirectUri String Callback URI, typically http://localhost:8080

Task and Project Property Taxonomy

  • Priorities: none (default), low, medium, high
  • Flexible Due Dates: Relative formats supported: today, tomorrow, in 3 days, next monday, YYYY-MM-DD, and timezone-explicit YYYY-MM-DDTHH:MM.

TickTick Power Skill Advanced Features

  • Multi-Agent Orchestration: Seamlessly coordinates with AI systems using JSON outputs (--json) to feedback task updates and task creation results to AI agents.
  • Robust Rate-Limiting & Retries: Handles TickTick API rate limits (100 req/min, 300 req/5min) with built-in automatic cooling periods and up to 4 retry attempts.
  • Bulk Action Support: Includes commands like batch-abandon to drop outdated tasks via single API payloads to minimize API footprint.
  • Hybrid File Attachments: Supports both official OAuth API calls and secure Web Session-based attachment uploads using session cookies.
  • Zero-Conf Agent Integration: Integrates directly with WorkBuddy and the wider Openclaw Skills runtime without requiring extensive secondary system files.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*