The standup meeting just ended. You have six new action items from three different conversations, a blocker someone mentioned that needs escalating, and two tasks that should be moved to the current sprint. You open ClickUp, navigate to the right space, find the right list, create each task one at a time, assign people, set priorities, drag things into the sprint board. Fifteen minutes of clicking for what was a two-minute verbal exchange.
This is the gap the OpenClaw ClickUp skill fills. Your AI agent connects directly to your ClickUp workspace. You tell it what happened in the meeting, and it creates the tasks, assigns them, sets the priority levels, and updates the sprint. Through a text message. While you walk to your next meeting.
This article covers how to set up the OpenClaw ClickUp integration, what you can do with it, and practical workflows that teams actually use day to day.
What the ClickUp Skill Does
The ClickUp skill connects your OpenClaw agent to the ClickUp API v2. Once configured, your agent can read and write data across your entire ClickUp workspace.
What it handles:
- Task management — Create, update, close, and delete tasks
- Project browsing — Navigate spaces, folders, lists, and views
- Assignment and priority — Assign tasks to team members, set urgency levels
- Sprint planning — Move tasks between sprints, update story points
- Status tracking — Change task status, check progress across lists
- Time tracking — Log time against tasks, check time reports
- Comments and updates — Add comments to tasks, read recent activity
- Custom fields — Read and update custom fields on tasks
- Search — Find tasks across your workspace by keyword, assignee, or status
The skill uses your personal ClickUp API token, so it has the same permissions you do. If you can see a space in the ClickUp app, your agent can access it too.
Who This Is For
The OpenClaw ClickUp integration works for anyone who manages work in ClickUp but wants to reduce the time spent inside the app. Common profiles:
Engineering leads who need to create tasks from Slack conversations, standup notes, or bug reports without switching to ClickUp every time.
Project managers who want quick status updates without navigating through multiple views. Ask your agent “what is the sprint progress?” instead of clicking into the board view.
Individual contributors who want to update their task status, log time, and check what is next without leaving their editor or messaging app.
Remote teams where ClickUp is the central project hub and people communicate through Telegram, WhatsApp, or Discord — the same channels where OpenClaw agents live.
Installation and Setup
Step 1: Get Your ClickUp API Token
ClickUp provides personal API tokens for API access.
- Open ClickUp and go to Settings (bottom-left gear icon)
- Navigate to Apps
- Under API Token, click Generate
- Copy the token
This token represents your account. The agent will have the same access level you do.
Step 2: Install the Skill
clawhub install clickup
Step 3: Configure the Token
openclaw config set clickup.api_token YOUR_CLICKUP_API_TOKEN
Alternatively, use an environment variable:
export CLICKUP_API_TOKEN=pk_your_token_here
Add it to your shell profile for persistence.
Step 4: Verify the Connection
openclaw skills reload
openclaw start
Test with a simple query:
List my ClickUp spaces
If the agent returns your workspace structure, the setup is complete. If you see an authentication error, double-check that the API token is correct and has not expired.
Navigating Your Workspace
ClickUp organizes work in a hierarchy: Workspace, Space, Folder, List, Task. The skill understands this structure and lets you navigate it conversationally.
Viewing Your Spaces
Show me all spaces in my ClickUp workspace
Returns:
Spaces in "Acme Corp":
1. Engineering (12 lists)
2. Marketing (8 lists)
3. Operations (5 lists)
4. Design (3 lists)
Drilling Into a Space
Show me the lists in the Engineering space
Lists in Engineering:
- Backend Tasks (23 open tasks)
- Frontend Tasks (17 open tasks)
- DevOps (8 open tasks)
- Sprint 14 (31 tasks, 18 in progress)
- Backlog (89 tasks)
Viewing Tasks in a List
Show open tasks in the Backend Tasks list, sorted by priority
The agent returns tasks with their status, assignee, priority, and due date. You get a project overview without opening the ClickUp app.
Creating and Managing Tasks
Task creation is where the OpenClaw ClickUp skill saves the most time. Instead of navigating to the right list and filling out fields, describe what you need.
Quick Task Creation
Create a task in Backend Tasks: Implement rate limiting for the /api/search endpoint
The agent creates the task with the title, places it in the Backend Tasks list, and confirms the task ID.
Tasks with Full Details
Create a task in Sprint 14:
Title: Fix authentication timeout bug
Priority: Urgent
Assignee: Sarah
Due date: Friday
Description: Users report being logged out after 5 minutes instead of 30.
The session TTL config may have been overwritten in the last deploy.
Tags: bug, auth, production
Every field gets populated in one message. No forms, no dropdowns, no multi-step creation flow.
Updating Existing Tasks
Update task CU-12345: change status to In Review and add a comment
saying "PR #892 is ready for review"
The agent finds the task by ID, updates the status, and posts the comment.
Batch Operations
Move all tasks tagged "blocked" in Sprint 14 to the Backlog list
Set all tasks assigned to me in Backend Tasks to priority High
Batch operations that would take minutes of clicking in the UI happen in seconds.
Closing Tasks
Mark task CU-12345 as complete
Close all tasks in the "Done" status in Sprint 14
Sprint Planning Workflows
Sprint planning is one of the strongest use cases for the OpenClaw ClickUp integration. The back-and-forth between reviewing backlog items, estimating effort, and building the sprint becomes a conversation.
Reviewing the Backlog
Show me the top 20 backlog items sorted by priority, with their story points and labels
The agent returns a ranked list you can review without switching to ClickUp’s board view.
Building a Sprint
Create a new sprint list called "Sprint 15" in the Engineering space
with start date March 3 and end date March 14
Move these tasks from Backlog to Sprint 15:
CU-11234, CU-11256, CU-11278, CU-11290, CU-11301
Capacity Planning
What is the total story points assigned to Sprint 15?
Break it down by assignee.
Sprint 15 capacity:
- Total: 47 story points
- Sarah: 15 points (5 tasks)
- Mike: 13 points (4 tasks)
- Alex: 12 points (3 tasks)
- Unassigned: 7 points (2 tasks)
Compare that against your team’s velocity:
What was the average completed story points per sprint
for the last 3 sprints?
Mid-Sprint Adjustments
What tasks in Sprint 15 are still in "To Do" status with 3 days left?
Move CU-11301 back to Backlog and replace it with CU-11320 from the Backlog
These adjustments take thirty seconds through your agent instead of several minutes of dragging cards in the UI.
Status Updates and Reporting
Project managers spend a significant amount of time checking status across multiple lists and summarizing progress. The OpenClaw ClickUp skill automates this.
Quick Status Check
What is the progress on Sprint 15?
Sprint 15 Progress:
- To Do: 4 tasks (8 points)
- In Progress: 6 tasks (15 points)
- In Review: 3 tasks (9 points)
- Done: 5 tasks (15 points)
Overall: 53% complete by story points
On track for March 14 deadline
Daily Standup Summary
Show me what each person on the Engineering team completed yesterday
and what they are working on today
The agent pulls activity from the last 24 hours and current “In Progress” tasks to generate a standup summary. Send this to your team channel at 9 AM without anyone needing to type their update.
Weekly Report
Generate a weekly summary for the Engineering space covering:
- Tasks completed this week
- Tasks added this week
- Current blockers (anything tagged "blocked")
- Sprint progress percentage
The agent compiles this from ClickUp data and formats it as a readable report. Copy it into your status email or team Slack channel.
Custom Field Reporting
If your ClickUp workspace uses custom fields (customer name, revenue impact, department):
Show all tasks in Q1 Initiatives where the "Revenue Impact" custom field
is greater than $50,000, sorted by due date
Team Collaboration Through the Agent
When your team communicates through messaging apps, the OpenClaw ClickUp skill bridges conversation and project management.
Creating Tasks from Conversations
During a Telegram group discussion about a bug:
Create a ClickUp task from this:
Bug: The export function generates corrupt CSV files when the data
contains Unicode characters. Affects the reporting dashboard.
Assign to Mike, priority High, add to Sprint 15.
The discussion stays in Telegram. The task lands in ClickUp with all the context.
Assigning and Notifying
Assign CU-12345 to Sarah and add a comment:
"Sarah, this is blocking the release. Can you pick this up today?"
Sarah sees the assignment and comment in ClickUp. You did not leave your messaging app.
Checking Someone’s Workload
What is Sarah working on right now?
Show her in-progress tasks across all spaces.
Useful before assigning new work to someone. Check their current load without pinging them directly.
Automated Workflows
The real efficiency gains come from combining the OpenClaw ClickUp skill with recurring patterns.
Morning Briefing
Set up a daily routine:
Every morning at 9 AM, send me:
1. My tasks due today
2. Any tasks assigned to me that are overdue
3. New comments on my tasks from the last 24 hours
You start each day with a clear picture without opening ClickUp.
End-of-Day Logging
Log 2 hours against task CU-12345 and update status to In Review.
Add comment: "Completed implementation, PR #901 opened."
Time tracking, status updates, and context notes in one message.
Blocker Escalation
Find all tasks in Sprint 15 that have been in "Blocked" status
for more than 2 days. List them with the blocking reason if it is
in the comments.
Surface issues before they derail the sprint.
OpenClaw ClickUp vs. Using the ClickUp App
The ClickUp app is designed for visual project management: drag-and-drop boards, Gantt charts, dashboards. The OpenClaw ClickUp skill is not a replacement for all of that. It is a faster interface for specific operations.
| Operation | ClickUp App | OpenClaw ClickUp Skill |
|---|---|---|
| Create a single task | 30-60 seconds | 5-10 seconds |
| Update 5 task statuses | 2-3 minutes | 15-20 seconds |
| Sprint progress check | Navigate to board view, count | Instant summary |
| Weekly report | Manual compilation | Automated generation |
| Visual board management | Excellent | Not applicable |
| Gantt chart planning | Built-in | Not supported |
| Task creation from mobile | Open app, navigate, fill form | Send a text message |
| Dashboard views | Rich visual dashboards | Text-based summaries |
Use the ClickUp app for: Visual planning, Gantt charts, dashboards, complex views, client-facing presentations.
Use the OpenClaw ClickUp skill for: Quick task creation, status updates, reporting, batch operations, mobile task management, and anything where speed matters more than visual layout.
Configuration Options
Fine-tune the skill behavior:
# Set default space for new tasks
openclaw config set clickup.default_space "Engineering"
# Set default list for quick task creation
openclaw config set clickup.default_list "Inbox"
# Set your default assignee (your ClickUp user ID)
openclaw config set clickup.default_assignee "user_abc123"
# Enable time tracking integration
openclaw config set clickup.time_tracking true
Multiple Workspaces
If you belong to multiple ClickUp workspaces (common for freelancers and consultants):
openclaw config set clickup.workspace_id "team_12345"
Or switch between workspaces in conversation:
Switch to the "Client A" ClickUp workspace
Troubleshooting
”Invalid API token”
ClickUp API tokens do not expire, but they can be revoked. If you regenerated your token in ClickUp settings, update the config:
openclaw config set clickup.api_token YOUR_NEW_TOKEN
“Space not found”
Space names are case-sensitive. Ask your agent to list spaces to see the exact names:
List all my ClickUp spaces
“Rate limit exceeded”
ClickUp’s API allows 100 requests per minute for personal tokens. If you hit this during batch operations, the skill automatically waits and retries. For persistent issues, break large operations into smaller batches.
Tasks not appearing in the expected list
Check that the list ID is correct. ClickUp list names can be duplicated across folders. The skill matches by name within the space you specify. Be explicit:
Create task in Engineering > Sprint 15 > Backend Tasks
Custom fields not updating
Custom fields require the field ID, not just the name. Ask your agent to list available custom fields for a list:
Show me the custom fields available in the Backend Tasks list
Then use the exact field name when updating.
Pairing with Other Skills
The ClickUp skill works well alongside other OpenClaw capabilities.
- Pair with mcporter to create ClickUp tasks when MCP server health checks fail
- Pair with notification skills to send sprint updates to Slack, Discord, or email
- Pair with calendar skills to sync ClickUp due dates with your calendar
- Browse productivity skills for tools that complement project management workflows
Getting Started
If you have not set up OpenClaw yet, the Getting Started guide walks through the full installation process.
Once your agent is running:
clawhub install clickup
openclaw config set clickup.api_token YOUR_TOKEN
openclaw skills reload
Start simple:
List my ClickUp spaces
Then create your first task through conversation:
Create a task in my Engineering space: Test the ClickUp integration
From there, build toward sprint planning, automated reporting, and team workflows. The overhead of project management shrinks when the interface is a text message.
For the full skill documentation, visit the clickup skill page. For more productivity tools, browse productivity skills. And for recommendations across every category, read Best OpenClaw Skills 2026.