Todoist 任务管理器：智能体任务可见性

    OpenClaw用例   OpenClaw AI 任务管理 Todoist 任务跟踪

Todoist 任务管理器：智能体任务可见性

通过将内部推理和进度日志直接同步到 Todoist，最大限度地提高长期运行的智能体工作流程的透明度。

痛点

当智能体运行复杂的多步骤任务（如构建全栈应用程序或执行深度研究）时，用户经常失去对智能体当前正在做什么、哪些步骤已完成以及智能体可能卡在哪里的跟踪。手动检查聊天日志对于后台任务来说很繁琐。

功能

这个用例使用 todoist-task-manager 技能来：

  1. 可视化状态：在特定部分中创建任务，如 🟡 进行中 或 🟠 等待中。
  2. 外部化推理：将智能体的内部"计划"发布到任务描述中。
  3. 流式日志：实时添加子步骤完成作为任务的注释。
  4. 自动协调：心跳脚本检查停滞的任务并通知用户。

所需技能

你不需要预先构建的技能。只需提示你的 OpenClaw 智能体创建下面 设置指南 中描述的 bash 脚本。由于 OpenClaw 可以管理自己的文件系统并执行 shell 命令，它将根据请求有效地为你"构建"技能。

详细设置指南

1. 配置 Todoist

创建一个项目（例如，“OpenClaw 工作区”）并获取其 ID。为不同状态创建部分：

  • 🟡 进行中
  • 🟠 等待中
  • 🟢 已完成

2. 实现：“智能体构建"的技能

与其安装技能，不如让 OpenClaw 为你创建这些脚本。每个脚本处理与 Todoist API 通信的不同部分。

scripts/todoist_api.sh（核心包装器）：

#!/bin/bash
# 用法：./todoist_api.sh <endpoint> <method> [data_json]
ENDPOINT=$1
METHOD=$2
DATA=$3
TOKEN="YOUR_TODOIST_API_TOKEN"

if [ -z "$DATA" ]; then
  curl -s -X "$METHOD" "https://api.todoist.com/rest/v2/$ENDPOINT" \
    -H "Authorization: Bearer $TOKEN"
else
  curl -s -X "$METHOD" "https://api.todoist.com/rest/v2/$ENDPOINT" \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d "$DATA"
fi

scripts/sync_task.sh（任务和状态管理）：

#!/bin/bash
# 用法：./sync_task.sh <task_content> <status> [task_id] [description] [labels_json_array]
CONTENT=$1
STATUS=$2
TASK_ID=$3
DESCRIPTION=$4
LABELS=$5
PROJECT_ID="YOUR_PROJECT_ID"

case $STATUS in
  "In Progress") SECTION_ID="SECTION_ID_PROGRESS" ;;
  "Waiting")     SECTION_ID="SECTION_ID_WAITING" ;;
  "Done")        SECTION_ID="SECTION_ID_DONE" ;;
  *)             SECTION_ID="" ;;
esac

PAYLOAD="{\"content\": \"$CONTENT\""
[ -n "$SECTION_ID" ] && PAYLOAD="$PAYLOAD, \"section_id\": \"$SECTION_ID\""
[ -n "$PROJECT_ID" ] && [ -z "$TASK_ID" ] && PAYLOAD="$PAYLOAD, \"project_id\": \"$PROJECT_ID\""
if [ -n "$DESCRIPTION" ]; then
  ESC_DESC=$(echo "$DESCRIPTION" | sed ':a;N;$!ba;s/\n/\\n/g' | sed 's/"/\\"/g')
  PAYLOAD="$PAYLOAD, \"description\": \"$ESC_DESC\""
fi
[ -n "$LABELS" ] && PAYLOAD="$PAYLOAD, \"labels\": $LABELS"
PAYLOAD="$PAYLOAD}"

if [ -n "$TASK_ID" ]; then
  ./scripts/todoist_api.sh "tasks/$TASK_ID" POST "$PAYLOAD"
else
  ./scripts/todoist_api.sh "tasks" POST "$PAYLOAD"
fi

scripts/add_comment.sh（进度日志）：

#!/bin/bash
# 用法：./add_comment.sh <task_id> <comment_text>
TASK_ID=$1
TEXT=$2
ESC_TEXT=$(echo "$TEXT" | sed ':a;N;$!ba;s/\n/\\n/g' | sed 's/"/\\"/g')
PAYLOAD="{\"task_id\": \"$TASK_ID\", \"content\": \"$ESC_TEXT\"}"
./scripts/todoist_api.sh "comments" POST "$PAYLOAD"

3. 用法提示

你可以将此提示给你的智能体，以同时 设置 和 使用 可见性系统：

我想让你为你的运行构建一个基于 Todoist 的任务可见性系统。

首先，在 'scripts/' 文件夹中创建三个 bash 脚本：
1. todoist_api.sh（Todoist REST API 的 curl 包装器）
2. sync_task.sh（创建或更新任务，为进行中、等待中和已完成指定特定的 section_ids）
3. add_comment.sh（将进度日志作为注释发布）

使用这些变量进行设置：
- Token: [你的 Todoist API Token]
- Project ID: [你的项目 ID]
- Section IDs: [进行中 ID，等待中 ID，已完成 ID]

创建后，对于我给你的每个复杂任务：
1. 在 '进行中' 中创建一个任务，并在描述中放入你的完整计划。
2. 对于每个子步骤完成，调用 add_comment.sh 并记录你做了什么。
3. 完成后将任务移动到 '已完成'。

相关链接