
AI Agent知识库【免费下载链接】awesome-openclaw-usecasesA community collection of OpenClaw use cases for making life easier.项目地址https://gitcode.com/gh_mirrors/aw/awesome-openclaw-usecases点击查看免费下载长时运行的 Agent 工作流如构建全栈应用、深度调研对用户而言常常是黑盒你只知道它在跑却不知道它此刻在做什么、已完成哪些步骤、卡在了哪里。本指南以 awesome-openclaw-usecases 仓库中的 Todoist Task Manager 用例 为核心讲解如何让 OpenClaw 通过三个 bash 脚本把内部推理过程与进度日志实时同步到 Todoist从而获得一个可随时查看的 Agent 任务看板。读完本文你将掌握 Todoist REST API 的封装方法、任务/评论的同步脚本实现以及一套可直接复制使用的 Agent 提示词。痛点长时 Agent 任务的黑盒问题当 Agent 执行复杂的多步骤任务比如搭建一个全栈应用、完成一次深度研究时用户很难跟踪Agent 当前正在做什么哪些步骤已经完成Agent 是不是卡住了对于后台运行的任务手动翻看聊天日志既繁琐又低效。这正是 todoist-task-manager.md 要解决的问题——把 Agent 的运行状态外置到用户每天都打开的任务管理工具中。方案概述What It Does该用例借助todoist-task-manager技能skill实现四项能力可视化状态在 Todoist 项目中按特定分区section创建任务例如 In Progress进行中、 Waiting等待中。外化推理将 Agent 内部的Plan计划写入任务描述description。流式日志将每个子步骤的完成情况以评论comment形式实时追加到任务下。自动对账通过一个心跳heartbeat脚本检查停滞任务并及时通知用户。该用例在仓库 README.md 的 Productivity生产力分类中被描述为通过将推理和进度日志同步到 Todoist最大化智能体的透明度。前置条件你甚至不需要预装技能一个关键的设计理念是你不需要预先安装任何现成技能。只需要给 OpenClaw Agent 一段提示词让它自己创建下文配置指南中描述的 bash 脚本。因为 OpenClaw 能够管理自己的文件系统并执行 shell 命令它会在收到请求后现场搭建这套技能。仓库维护者在 README.md 中同时给出了重要安全提醒OpenClaw 技能和第三方依赖可能存在严重安全漏洞社区技能多未经过维护者审计务必审查技能源码、检查请求的权限并避免硬编码 API 密钥或凭据。下文会给出相应的安全实践建议。详细配置指南1. 配置 Todoist 侧首先在 Todoist 中完成准备工作创建一个项目Project例如命名为 OpenClaw Workspace并获取其Project ID。在该项目中为不同状态创建分区Section In Progress进行中 Waiting等待中 Done已完成获取每个分区的Section ID以及你的Todoist API Token。这些 ID 将在后续脚本中作为占位符被替换。你既可以在 Todoist 网页端手动创建分区也可以让 Agent 通过 Todoist REST API 的sections端点完成创建——从脚本结构可以推断这套系统的核心就是围绕tasks、comments、sections等 REST v2 端点展开的。2. 实现Agent 自建的技能脚本这套技能由三个脚本组成每个脚本负责与 Todoist API 通信的不同部分。原文档提供了完整代码下面逐一展开讲解。scripts/todoist_api.sh——核心 API 封装这是整个系统的底层封装负责所有与 Todoist REST API 的 HTTP 通信。用法为./todoist_api.sh endpoint method [data_json]#!/bin/bash # Usage: ./todoist_api.sh endpoint method [data_json] ENDPOINT$1 METHOD$2 DATA$3 TOKENYOUR_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要点说明端点拼接所有请求统一发往https://api.todoist.com/rest/v2/下的相对端点例如tasks、tasks/{id}、comments。认证方式通过Authorization: Bearer请求头携带 API Token。有无请求体的分支当第三个参数数据 JSON为空时仅发送带认证头的请求否则额外附带Content-Type: application/json与-d数据体。这使其同时支持 GET 类查询与 POST 类写入。安全建议原文档以硬编码变量TOKENYOUR_TODOIST_API_TOKEN示意但依据仓库 README.md 的安全警告强烈建议改为从环境变量读取如TOKEN${TODOIST_TOKEN}避免将密钥写入脚本文件。scripts/sync_task.sh——任务与状态管理负责创建任务或更新任务状态。用法为./sync_task.sh task_content status [task_id] [description] [labels_json_array]#!/bin/bash # Usage: ./sync_task.sh task_content status [task_id] [description] [labels_json_array] CONTENT$1 STATUS$2 TASK_ID$3 DESCRIPTION$4 LABELS$5 PROJECT_IDYOUR_PROJECT_ID case $STATUS in In Progress) SECTION_IDSECTION_ID_PROGRESS ;; Waiting) SECTION_IDSECTION_ID_WAITING ;; Done) SECTION_IDSECTION_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要点说明状态到分区的映射通过case语句把语义化的状态In Progress/Waiting/Done映射到具体的section_id实现任务出现在哪个分区的控制。任务创建与更新的分支传入task_id时更新已有任务POST 到tasks/{id}否则创建新任务POST 到tasks。注意更新时不再携带project_id——这是从脚本第 68 行[ -n $PROJECT_ID ] [ -z $TASK_ID ]的条件中可以推断的行为避免对已存在任务误改项目归属。描述转义使用sed把描述中的换行符转为\n、双引号转义为\确保多行 Plan 能作为合法 JSON 字符串提交。标签支持第五个参数labels_json_array会以 JSON 数组原样拼入 payload可用于给任务打上类型标签。scripts/add_comment.sh——进度日志记录负责把子步骤完成日志实时追加到任务评论中。用法为./add_comment.sh task_id comment_text#!/bin/bash # Usage: ./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要点说明评论即日志Todoist 的comments端点允许向任务追加评论这里被复用为进度日志流——每完成一个子步骤就追加一条评论用户在 Todoist 任务详情页即可看到按时间排列的执行记录。同样的转义逻辑与sync_task.sh一致对换行与双引号做 JSON 转义保证多行日志安全提交。3. 使用提示词同时完成搭建与使用原文档提供了一个可直接复制给 Agent 的提示词它既指导 Agent 完成脚本搭建也定义了后续每个复杂任务的处理流程I want you to build a Todoist-based task visibility system for your own runs. First, create three bash scripts in a scripts/ folder: 1. todoist_api.sh (a curl wrapper for Todoist REST API) 2. sync_task.sh (to create or update tasks with specific section_ids for In Progress, Waiting, and Done) 3. add_comment.sh (to post progress logs as comments) Use these variables for the setup: - Token: [Your Todoist API Token] - Project ID: [Your Project ID] - Section IDs: [In Progress ID, Waiting ID, Done ID] Once created, for every complex task I give you: 1. Create a task in In Progress with your full PLAN in the description. 2. For every sub-step completion, call add_comment.sh with a log of what you did. 3. Move the task to Done when finished.这段提示词的核心是定义了任务生命周期协议接到复杂任务 → 在In Progress分区创建任务把完整计划PLAN写入描述每个子步骤完成 → 调用add_comment.sh记录一条日志全部完成 → 把任务移到Done分区即用sync_task.sh更新section_id。运行原理与源码级解读一次典型运行的调用链从三个脚本的调用关系可以还原出完整链路sync_task.sh 构建登录页 In Progress Plan: 1.设计UI 2.写后端... └─ todoist_api.sh tasks POST {...section_id...} → 创建任务返回 task_id add_comment.sh task_id 已完成UI 骨架搭建 └─ todoist_api.sh comments POST {...} → 追加进度日志 sync_task.sh 构建登录页 Done task_id └─ todoist_api.sh tasks/task_id POST {...section_id:Done...} → 收尾也就是说todoist_api.sh是唯一直接接触网络的层sync_task.sh与add_comment.sh在其上构建语义操作Agent 则只需按提示词约定调用高层脚本即可。这种分层设计让 API Token 只出现在一处便于集中管理与替换。心跳对账停滞任务检测原文档在能力清单中提到一个心跳heartbeat脚本定期检查是否存在长时间没有新评论、也没有移动到Done的任务即停滞任务并通知用户。该脚本不在本次提供的三个脚本之列从文档描述可以推断其实现思路是调用tasks端点按section_id拉取In Progress/Waiting分区下的任务结合评论的最后更新时间判断活跃度超时则触发通知例如发送到 Telegram 或邮件。这保证了即使 Agent 卡死用户也能第一时间被提醒而不会让任务无声地悬在那里。与其他用例的组合使用仓库中有多个用例与 Todoist 相关这套可视化系统可以与它们形成闭环Automated Meeting Notes Action Items该用例会把会议纪要中的行动项自动创建到 Jira、Linear、Todoist 或 Notion。原文档明确建议将此用例与 Todoist Task Manager 搭配使用以获得 Agent 创建任务的完整可见性——会议行动项由 Agent 自动创建后同样可以通过本系统被追踪与展示。Multi-Channel Personal Assistant该用例把 Todoist 作为快速任务捕获渠道用户在任何对话中说把 [任务] 加入我的待办即触发 Todoist 写入与本系统结合后这些由 Agent 写入的任务也能以同样方式获得状态可视化。安全注意事项基于仓库 README.md 的明确警告在使用本方案时请注意不要硬编码 API Token原文档脚本中TOKENYOUR_TODOIST_API_TOKEN仅为示意。实际使用时请通过环境变量注入或使用 OpenClaw 的密钥管理机制避免密钥随脚本文件泄露。审查脚本来源本方案的核心卖点是让 Agent 现场自建脚本因此在首次运行前请人工检查 Agent 生成的脚本内容确认其只调用预期的端点、只读取预期的变量。最小权限原则Todoist API Token 只应具备本项目所需的最小范围并妥善保管。相关资源本方案对应的原文档usecases/todoist-task-manager.md仓库总览与完整用例索引README.md贡献指南如何新增用例CONTRIBUTING.md官方参考Todoist REST API v2 文档可在 Todoist 开发者门户查阅本方案用到的关键端点包括tasks创建/更新任务、tasks/{id}按 ID 更新、comments追加评论以及用于获取分区 ID 的sections端点。小结Todoist Task Manager 用例的巧妙之处在于它没有引入任何新的技能安装负担而是把 Todoist 这样一个用户本就高频使用的工具变成 Agent 的状态显示器。通过三个 bash 脚本OpenClaw 就能在 Todoist 中实时呈现自己的计划、进度与停滞状态让长时任务的透明度从翻聊天记录升级为看一眼任务看板。配合心跳对账机制与仓库中其他 Todoist 相关用例它可以进一步融入你的日常工作流成为 Agent 自治运行的可信仪表盘。赞分享AI Agent知识库【免费下载链接】awesome-openclaw-usecasesA community collection of OpenClaw use cases for making life easier.项目地址https://gitcode.com/gh_mirrors/aw/awesome-openclaw-usecases点击查看免费下载相关推荐Rich进度条系统可视化任务处理进度Rich进度条系统可视化任务处理进度 Rich库提供了一个高度模块化和可扩展的进度条系统通过精心设计的类层次结构和接口抽象实现了灵活且功能丰富的任务进度可免费搞定电脑性能排查CPU、内存、磁盘 3 步走免费搞定电脑性能排查CPU、内存、磁盘 3 步走 电脑突然变卡任务管理器打开却发现各项都“正常”根本不知道问题出在哪。这时候用 System Inform桌面应用调试器应用安全驱动开发Symphony 日志最佳实践为 Codex Agent 编排系统构建可检索、可诊断的结构化日志Symphony 日志最佳实践为 Codex Agent 编排系统构建可检索、可诊断的结构化日志 Symphony 将项目工作拆解为相互隔离的自主实现运行让人工智能AI Agent代码智能体Agent 编排Agent 工作流后端任务调度上一篇英雄联盟国服换肤终极教程5分钟免费解锁全皮肤指南下一篇从零开始掌握电路仿真CircuitJS1 Desktop Mod让电子设计变得如此简单创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考