OpenClaw技能故事 Day064 | wecom-get-todo-list

林晓端着咖啡杯，目光停留在电脑屏幕的企业微信界面上。作为科技伦理研究员，她习惯用系统化的方式管理自己的工作——但今天，密密麻麻的待办事项让她感到一丝焦虑。

“这周的待办至少有三十多条，”她对着屏幕自言自语，”但企业微信的待办列表只能一页页翻，每次想找某个具体任务都要花好几分钟。”

她试着搜索了一下，发现企业微信自带的搜索功能只能按关键词查找，无法按时间范围过滤，更别提批量查看状态了。作为研究人员，她深知效率工具对保持工作状态的重要性——如果连自己的待办都理不清，还怎么研究别的技术伦理问题？

发现痛点：待办管理的盲区

林晓打开自己的待办列表，发现几个明显的问题：

问题一：分页不便。待办一多，企业微信默认只显示前10条，她得不断点击”加载更多”，而且没有明确的进度提示。

问题二：时间过滤缺失。她想看看”这周创建的待办有哪些”，或者”明天有哪些任务要提醒”，但企业微信没有提供这种时间维度的筛选。

问题三：信息不完整。列表页面只显示待办标题和状态，想看具体内容还得一个个点进去——这对于快速浏览来说太慢了。

“如果有个技能能帮我一键获取待办列表，还能按时间过滤、自动分页拉取，甚至批量获取详情，那该多好。”林晓在笔记本上写下这个想法。

开发技能：wecom-get-todo-list 诞生

带着这个需求，林晓开始研究企业微信的MCP接口。她发现企业微信提供了待办相关的API，但需要通过MCP（Model Context Protocol）服务来调用。

经过几天的开发调试，她创建了 wecom-get-todo-list 技能——一个专门用于查询企业微信待办列表的工具。

这个技能的核心能力包括：

1. 灵活的时间过滤：支持按创建时间和提醒时间进行范围查询
2. 分页支持：自动处理分页逻辑，支持通过cursor翻页
3. 状态筛选：返回待办的状态信息（进行中/已完成/已删除）
4. 批量操作基础：返回的todo_id列表可以直接传给详情查询接口

核心功能：让待办管理更智能

wecom-get-todo-list 技能最强大的地方在于它的两步工作流设计。

第一步：获取待办列表

调用方式很简单，通过 wecom_mcp 工具即可：

wecom_mcp call todo get_todo_list '{}'

如果不传任何参数，它会返回最近的待办列表（默认最多10条，可设置到20条）。

更实用的是，你可以按时间范围查询：

{
  "create_begin_time": "2026-05-01 00:00:00",
  "create_end_time": "2026-05-07 23:59:59",
  "limit": 20
}

这样就可以精确获取”这个月创建的待办”或”今天之前提醒的任务”。

第二步：自动获取详情（关键！）

林晓在开发时特别注意了一个问题：列表接口只返回概要信息。也就是说，你拿到的是待办ID、状态、创建时间这些元数据，但看不到待办的具体内容和分派人。

“这对用户来说毫无意义，”林晓在开发笔记中写道，”用户想知道的是’要做什么’，而不是一串ID。”

所以她设计了一个智能流程：获取列表后，必须自动调用 wecom-get-todo-detail 获取完整详情，然后才向用户展示。这不是可选步骤，而是完成用户请求的必要环节。

分页提醒机制

另一个贴心的设计是分页提醒。接口是分页的，如果 has_more 为 true，说明后面还有数据。这时技能会明确告诉用户：”还有更多待办未显示，是否需要继续查看？”

“用户可能不知道后面还有数据，”林晓解释道，”如果你不说，他们会以为看到的就是全部，这可能导致遗漏重要待办。这是一个容易被忽略但后果严重的点。”

实战回响：从混乱到有序

林晓第一次使用这个技能是在一个周一的早晨。她需要对上周的工作做个回顾，看看哪些待办还没完成。

“看看我最近的待办。”她对OpenClaw说道。

几秒钟后，技能返回了结果：

📋 您最近的待办事项（共15条）：

【进行中】
1. [ID: TODO_001] 完成Q2技术伦理报告 - 提醒时间：2026-05-08 09:00
2. [ID: TODO_002] 评审AI代码审查工具方案 - 提醒时间：2026-05-07 14:00
3. [ID: TODO_003] 准备周五的团队分享材料 - 提醒时间：2026-05-09 10:00
...（已自动获取详情）

⚠️ 还有更多待办未显示，是否需要继续查看？

“太棒了！”林晓兴奋地说，”不仅看到了待办标题，还自动获取了详细内容和分派人。而且它还提醒我还有更多待办——这让我知道不能掉以轻心。”

从那以后，她每天都会用这个技能快速浏览待办，再也不用在企业微信界面上一个个点击了。

使用方法：简单三步

如果你想使用 wecom-get-todo-list 技能，只需：

1. 确保前置条件已满足
首次使用需要按 wecom-preflight 技能执行前置检查，确保MCP工具已加入白名单。

2. 发起查询
你可以说：

• “看看我的待办列表”
• “我有哪些待办”
• “这周的待办有哪些”
• “最近有什么待办”

技能会自动调用 wecom_mcp call todo get_todo_list 获取列表。

3. 自动获取详情
技能会用返回的todo_id列表自动调用 wecom-get-todo-detail，然后向你展示完整的待办内容。

可选：按时间范围查询
如果你需要特定时间段的待办，可以说：

• “这个月创建的待办有哪些”
• “明天有哪些任务要提醒”

独特价值：不是简单的API封装

wecom-get-todo-list 技能的价值不仅在于封装了企业微信的API，更在于它理解用户的真实需求。

智能工作流：它知道用户要的不是ID列表，而是有意义的待办内容，所以会自动获取详情。

分页意识：它知道分页接口可能让用户误以为看到了全部数据，所以会主动提醒。

错误处理：遇到网络问题或API错误时，它会自动重试（最多三次），而不是简单地报错。

时间理解：当你说”这周”、”明天”、”下周一”时，它会自动推算具体日期，不用你手动输入 YYYY-MM-DD HH:mm:ss 格式。

林晓在技能文档中写道：”好的工具不应该只是功能的堆砌，而应该理解用户的使用场景和心理预期。wecom-get-todo-list 不只是调用API，它在替用户思考。”

明日预告

明天，林晓将探索 wecom-get-todo-detail 技能——一个专门用于获取待办详情的工具。当你有了待办ID列表后，它如何帮你批量获取完整内容？又如何处理复杂的详情数据？敬请期待 Day065 的故事。

📌 技能名称：wecom-get-todo-list
📌 技能功能：企业微信待办列表查询，支持时间过滤和分页
📌 使用场景：查看待办概览、按时间范围筛选待办
📌 注意事项：查完列表后必须查详情，分页未拉完时必须提醒用户

OpenClaw技能故事，每天讲述一个技能的前世今生。