Todoist 任务管理器：代理任务可见性

通过将内部推理和进度日志直接同步到 Todoist，最大化长时间运行的代理工作流的透明度。

痛点

当代理运行复杂的多步骤任务（如构建全栈应用或进行深度研究）时，用户往往会失去对代理当前正在做什么、哪些步骤已经完成以及代理可能被什么卡住的追踪。手动检查聊天记录对于后台任务来说很繁琐。

功能介绍

此用例使用 todoist-task-manager 技能来：

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

所需技能

您不需要预构建的技能。只需提示您的 OpenClaw 代理创建以下设置指南中描述的 bash 脚本。由于 OpenClaw 可以管理自己的文件系统并执行 shell 命令，它会在您请求时"为您构建"技能。

详细设置指南

1. 配置 Todoist

创建一个项目（例如 "OpenClaw Workspace"）并获取其 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_id 的任务，分别对应进行中、等待中和已完成）
3. add_comment.sh（用于将进度日志发布为评论）

使用以下变量进行设置：
- Token：[您的 Todoist API 令牌]
- Project ID：[您的项目 ID]
- Section IDs：[进行中 ID、等待中 ID、已完成 ID]

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

相关链接

• Todoist REST API 文档