Vikunja 任务管理器

通过 REST API 管理自托管 Vikunja 实例中的任务与项目。

配置

设置以下环境变量：

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

获取您的 API token：Vikunja → 设置 → API Tokens → 创建 token。

命令

列出任务

{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

逾期任务

{baseDir}/scripts/vikunja.sh overdue

即将到期的任务（未来 N 小时内）

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

创建任务

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

优先级：1（低）至 5（紧急）。截止日期格式：YYYY-MM-DD。

完成任务

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

获取任务详情

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

列出项目

{baseDir}/scripts/vikunja.sh projects

创建项目

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

获取通知

{baseDir}/scripts/vikunja.sh notifications

截止日期监控

如需主动接收有关到期/逾期任务的通知，请配置一个 cron 任务：

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

注意事项

• --project 中的项目名称不区分大小写
• 筛选表达式遵循 Vikunja 的筛选语法（参见 https://vikunja.io/docs/filters）
• 所有时间均按 America/Denver 时区处理