什么是 Vikunja 任务管理器？

Vikunja 任务管理器技能为 AI 代理与 Vikunja 生产力套件交互提供了一个强大的界面。它使用户能够将开发环境与个人任务管理系统桥接，促进编码任务与项目截止日期之间的无缝协作。通过将其集成到您的 Openclaw Skills 库中，您可以直接从代理工作流中自动执行日常组织任务，例如检查截止日期、创建提醒和列出活动项目。

此技能专为偏好自托管解决方案并希望利用自动化力量来维护生产力管道的开发人员和高级用户设计。它利用 Vikunja REST API 执行高级操作，确保您的任务数据在本地和基于服务器的环境中保持同步和可访问。

下载入口:https://github.com/openclaw/skills/tree/main/skills/nickian/vikunja-tasks

安装与下载

1. ClawHub CLI

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

2. 手动安装

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

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

3. 提示词安装

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

Vikunja 任务管理器 应用场景

• 在不离开命令行的情况下跟踪并完成开发任务。
• 为新仓库或客户业务自动化项目创建。
• 通过集中的 AI 驱动通知坚控逾期项目和即将到来的截止日期。
• 在私有的自托管服务器上组织购物清单、提醒和个人待办事项。

1. 该技能使用预配置的 API 令牌和 URL 向您的自托管 Vikunja 实例进行身份验证。
2. 用户提供自然语言或结构化命令来查询任务、按项目筛选或更新任务状态。
3. 该技能执行相应的 REST API 请求，以获取或修改 Vikunja 服务器上的数据。
4. 结果经处理后返回给代理，提供对任务详情、优先级和截止日期的可见性。
5. 可以应用高级坚控逻辑，根据特定时间间隔或任务状态触发自动警报。

Vikunja 任务管理器 配置指南

要开始使用此 Openclaw Skills 扩展，请在终端或配置文件中设置以下环境变量：

export VIKUNJA_URL="https://your-vikunja-instance.com"
export VIKUNJA_TOKEN="your-api-token"

要生成 API 令牌，请登录您的 Vikunja 实例并导航至 设置 > API 令牌 > 创建令牌。

Vikunja 任务管理器 数据架构与分类体系

该技能管理 Vikunja 生态系统中多个关键实体的数据：

注意：所有日期时间操作均已本地化到 America/Denver 时区，以确保调度的一致性。

name: vikunja
description: Manage tasks and projects on a self-hosted Vikunja instance. Use when the user wants to create, view, complete, or manage tasks, check what's due or overdue, list projects, or get task notifications. Also use for to-do lists, reminders, and task tracking.

Vikunja Task Manager

Manage tasks and projects on a self-hosted Vikunja instance via REST API.

Setup

Set these environment variables:

export VIKUNJA_URL="https://your-vikunja-instance.com"
export VIKUNJA_TOKEN="your-api-token"

Get your API token: Vikunja → Settings → API Tokens → Create token.

Commands

List tasks

{baseDir}/scripts/vikunja.sh tasks --count 10
{baseDir}/scripts/vikunja.sh tasks --project "Shopping" --count 5
{baseDir}/scripts/vikunja.sh tasks --search "groceries"
{baseDir}/scripts/vikunja.sh tasks --sort priority --order desc

Overdue tasks

{baseDir}/scripts/vikunja.sh overdue

Tasks due soon (next N hours)

{baseDir}/scripts/vikunja.sh due --hours 24
{baseDir}/scripts/vikunja.sh due --hours 48

Create a task

{baseDir}/scripts/vikunja.sh create-task --project "Tasks" --title "Buy milk" --due "2026-02-01" --priority 3

Priority: 1 (low) to 5 (urgent). Due date format: YYYY-MM-DD.

Complete a task

{baseDir}/scripts/vikunja.sh complete --id 123

Get task details

{baseDir}/scripts/vikunja.sh task --id 123

List projects

{baseDir}/scripts/vikunja.sh projects

Create a project

{baseDir}/scripts/vikunja.sh create-project --title "New Project" --description "Optional description"

Get notifications

{baseDir}/scripts/vikunja.sh notifications

Due Date Monitoring

To get proactive notifications about due/overdue tasks, set up a cron job:

clawdbot cron add r
  --name "Task due check" r
  --cron "0 9,14 * * *" r
  --tz "America/Denver" r
  --session isolated r
  --message "Check Vikunja for overdue and upcoming tasks (next 24 hours). If any are found, notify me with the list." r
  --deliver r
  --channel telegram

Notes

• Project names in --project are case-insensitive
• Filter expressions follow Vikunja filter syntax (see https://vikunja.io/docs/filters)
• All times are handled in America/Denver timezone