Clup:自动化 ClickUp 任务管理 - Openclaw Skills

作者:互联网

2026-04-17

AI教程

什么是 Clup - ClickUp 工单管理器?

Clup 是一款强大的实用程序,旨在增强 Openclaw Skills 生态系统内的任务管理。其核心目的是作为开发人员的快速想法与结构化项目管理系统之间的智能桥梁。通过强制要求至少 2-3 句的描述长度,它确保在 ClickUp 中创建的每个任务都是可操作的,并携带必要的背景信息,例如系统环境、任务背后的动机以及具体的业务技术要求。

Clup 为速度和一致性而构建,允许用户直接通过终端或 AI 代理界面与 ClickUp 交互。它消除了手动数据录入的繁琐,同时保持了项目文档的高标准。无论您是在管理复杂的防火墙规则还是简单的提醒,Clup 都能确保您的团队拥有所需的所有信息,而无需离开命令行。

下载入口:https://github.com/openclaw/skills/tree/main/skills/niyol/clickup-ticket-manager

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install clickup-ticket-manager

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 clickup-ticket-manager。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

Clup - ClickUp 工单管理器 应用场景

  • 为防火墙规则或服务器迁移等基础设施变更创建详细的技术工单。
  • 在活跃的开发会话期间,记录带有特定环境上下文的错误报告。
  • 使用 AI 代理工作流从自然语言提示生成可执行的任务提醒。
  • 通过强制执行特定的元数据要求,标准化团队内的工单创建。
Clup - ClickUp 工单管理器 工作原理
  1. 用户或 AI 代理通过 clup 脚本发起任务创建请求。
  2. 系统分析输入以确保其达到质量阈值,特别要求有清晰的标题和描述性的正文。
  3. 如果输入过于模糊,工具会在继续之前主动要求用户提供更多上下文。
  4. 验证后,脚本会处理优先级和自定义标签等可选参数。
  5. 数据使用配置的环境变量(用于身份验证和列表识别)传输到 ClickUp API。
  6. 返回成功消息以及指向新创建的 ClickUp 任务的直接 URL。

Clup - ClickUp 工单管理器 配置指南

要将 Clup 集成到您的 Openclaw Skills 环境中,请遵循以下配置步骤:

# 确保脚本可执行
chmod +x clup.sh

# 在 .bashrc 或 .zshrc 中配置环境变量
export CLICKUP_API_KEY="your_api_key"
export CLICKUP_DEFAULT_LIST_ID="your_list_id"

# 可选:设置标签和状态的默认值
export CLICKUP_DEFAULT_TAG="dev-ops"
export CLICKUP_DEFAULT_STATUS="BACKLOG"

# 可选:创建符号链接以实现全系统访问
sudo ln -s $(pwd)/clup.sh /usr/local/bin/clup

Clup - ClickUp 工单管理器 数据架构与分类体系

Clup 使用以下架构将用户输入映射到 ClickUp API 结构:

属性 来源 / 标志 格式 备注
标题 --title 字符串 简短且可操作
描述 --description Markdown 字符串 至少需要 2-3 句话
优先级 --priority urgent, high, normal, low 默认值为 normal
标签 --tags 逗号分隔列表 与 CLICKUP_DEFAULT_TAG 合并
状态 环境变量 字符串 通过 CLICKUP_DEFAULT_STATUS 控制
name: clup
description: ClickUp Ticket Manager. Create tasks in ClickUp with quality descriptions (2-3 sentences minimum).

ClickUp Ticket Manager

CLI tool: clup.sh (or clup if symlinked)

Prerequisites:

  • Script must be executable: chmod +x clup.sh
  • Required ENV variables: CLICKUP_API_KEY, CLICKUP_DEFAULT_LIST_ID
  • Optional: Create symlink for system-wide access

When to Use

User says:

  • "Create a ticket for..."
  • "Make a task for..."
  • "I need a reminder for..."
  • "Add a ClickUp ticket for..."

Your Job

Transform vague input into quality tickets with context!

Quality Rules

  1. Title: Short, clear, actionable
  2. Description: MINIMUM 2-3 sentences with:
    • What needs to be done?
    • Why / What for?
    • Context (system, server, user, etc.)
  3. If input is vague: ASK before creating!

Example Transformation

? User: "ticket for firewall rule"

? You create:

./clup.sh --title "Firewall Rule for Production System" r
     --description "Open port 443 from server web-01 (10.0.1.5) to db-prod (10.0.2.10). Required for API communication after migration. Coordination with network team needed."

Command

# Basic (use ./clup.sh or clup depending on installation)
./clup.sh --title "..." --description "..."

# With priority
./clup.sh --title "..." --description "..." --priority high
# Priority: urgent, high, normal, low (optional)

# With custom tags
./clup.sh --title "..." --description "..." --tags "bug,urgent,backend"
# Tags: comma-separated list (optional)

Note: If installed via symlink, use clup instead of ./clup.sh

Response

After success, show the user the ClickUp URL so they can click through.

Notes

  • Default tags are automatically added (configurable via CLICKUP_DEFAULT_TAG, comma-separated)
  • Default status: "BACKLOG" (configurable via CLICKUP_DEFAULT_STATUS)
  • Default list: Set via CLICKUP_DEFAULT_LIST_ID
  • For help/options: ./clup.sh --help

相关推荐