什么是 Todoist？

Todoist 技能使 AI 智能体能够直接与全球最受欢迎的生产力平台之一进行交互。通过利用官方 Todoist TypeScript SDK，此技能允许用户通过结构化 CLI 管理日常工作流程、组织复杂项目并处理提醒。当集成到 Openclaw Skills 中时，它将标准的待办事项列表转化为一个能够通过自然语言命令确定工作优先级并保持专注的智能助手。

该工具专为需要在编码环境与其个人组织系统之间架起桥梁的开发人员和高级用户而设计。无论您是列出任务还是向项目添加详细注释，此技能都为 Openclaw Skills 生态系统内的完整任务生命周期管理提供了必要的端点。

下载入口:https://github.com/openclaw/skills/tree/main/skills/mjrussell/todoist

安装与下载

1. ClawHub CLI

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

2. 手动安装

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

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

3. 提示词安装

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

Todoist 应用场景

• 使用自然语言截止日期（如“下周五下午 3 点”）立即创建任务。
• 获取任务和项目的每日简报以开始工作日。
• 在项目之间移动任务，使个人和工作生活保持井井有条。
• 使用特定的优先级或标签过滤高优先级项目。
• 通过 AI 智能体添加评论或备注，为现有任务添加上下文。

1. AI 智能体从用户那里识别与生产力相关的请求，例如添加提醒或检查日程。
2. 智能体将请求映射到适当的 Todoist CLI 命令，例如 todoist add 或 todoist tasks。
3. 该技能使用安全存储的 TODOIST_API_TOKEN 与 Todoist API 进行通信。
4. CLI 处理任务元数据，包括自然语言日期、优先级和项目分配。
5. 操作结果返回给智能体，智能体确认操作或向用户显示请求的数据。

Todoist 配置指南

首先，确保您已通过 npm 安装了所需的 CLI 工具：

npm install -g todoist-ts-cli@^0.2.0

接下来，从 Todoist 开发者设置 (https://todoist.com/app/settings/integrations/developer) 获取您的 API 令牌。然后，您可以通过以下两种方式之一对该技能进行身份验证：

todoist auth <your-token>
# 或者
export TODOIST_API_TOKEN="your-token"

Todoist 数据架构与分类体系

该技能跨多个 Todoist 核心实体管理数据，确保您的 AI 智能体与您的帐户之间有清晰的映射。在 Openclaw Skills 中，数据根据以下模式进行处理：

所有任务列表都包含唯一的 ID，这对于执行 done、move 或 delete 等管理操作至关重要。

name: todoist
description: Manage tasks and projects in Todoist. Use when user asks about tasks, to-dos, reminders, or productivity.
homepage: https://todoist.com
metadata:
  clawdbot:
    emoji: "?"
    requires:
      bins: ["todoist"]
      env: ["TODOIST_API_TOKEN"]

Todoist CLI

CLI for Todoist task management, built on the official TypeScript SDK.

Installation

# Requires todoist-ts-cli >= 0.2.0 (for --top / --order)
npm install -g todoist-ts-cli@^0.2.0

Setup

1. Get API token from https://todoist.com/app/settings/integrations/developer
2. Either:

   todoist auth <your-token>
   # or
   export TODOIST_API_TOKEN="your-token"
   

Commands

Tasks

todoist                    # Show today's tasks (default)
todoist today              # Same as above
todoist tasks              # List tasks (today + overdue)
todoist tasks --all        # All tasks
todoist tasks -p "Work"    # Tasks in project
todoist tasks -f "p1"      # Filter query (priority 1)
todoist tasks --json

Add Tasks

todoist add "Buy groceries"
todoist add "Meeting" --due "tomorrow 10am"
todoist add "Review PR" --due "today" --priority 1 --project "Work"
todoist add "Prep slides" --project "Work" --order 3  # add at a specific position (1-based)
todoist add "Triage inbox" --project "Work" --order top  # add to top (alternative to --top)
todoist add "Call mom" -d "sunday" -l "family"  # with label

Manage Tasks

todoist view <id>          # View task details
todoist done <id>          # Complete task
todoist reopen <id>        # Reopen completed task
todoist update <id> --due "next week"
todoist move <id> -p "Personal"
todoist delete <id>

Search

todoist search "meeting"

Projects & Labels

todoist projects           # List projects
todoist project-add "New Project"
todoist labels             # List labels
todoist label-add "urgent"

Comments

todoist comments <task-id>
todoist comment <task-id> "Note about this task"

Usage Examples

User: "What do I have to do today?"

todoist today

User: "Add 'buy milk' to my tasks"

todoist add "Buy milk" --due "today"

User: "Remind me to call the dentist tomorrow"

todoist add "Call the dentist" --due "tomorrow"

User: "Mark the grocery task as done"

todoist search "grocery"   # Find task ID
todoist done <id>

User: "What's on my work project?"

todoist tasks -p "Work"

User: "Show my high priority tasks"

todoist tasks -f "p1"

Filter Syntax

Todoist supports powerful filter queries:

• p1, p2, p3, p4 - Priority levels
• today, tomorrow, overdue
• @label - Tasks with label
• #project - Tasks in project
• search: keyword - Search

Notes

• Task IDs are shown in task listings
• Due dates support natural language ("tomorrow", "next monday", "jan 15")
• Priority 1 is highest, 4 is lowest
• Use --order <n> (1-based) or --order top to insert a task at a specific position within a project/section