国内应用

国内应用接入

滴答清单 AI 接入:把任务查询与确认操作放进对话

为 Hermes Agent 或 OpenClaw 连接国内版滴答清单,查看清单和待办、按关键词找任务,并在核对标题、清单与时间后创建或完成任务。

滴答清单接入如何帮助您安排工作?

当任务分散在工作、生活和项目清单里,规划一天首先需要知道哪些事项真实存在。滴答清单接入让助手查询账号中的清单和任务,再依据截止时间、优先级与任务内容整理下一步建议。

您既可以问「这个清单里还有什么」,也可以查找含指定关键词的任务。需要新增事项时,助手先给出准备保存的标题、目标清单和时间;您确认后才写入账号。完成任务同样要先定位具体条目,避免把同名任务误标完成。

虽然常有人搜索“滴答清单 MCP”,本页托管连接实际通过滴答清单官方 Open API 执行操作,由国内应用工具提供给 Hermes Agent 与 OpenClaw 使用,不要求您另外安装一个第三方 MCP 服务。

接入后可以做什么?

  • 查看清单与任务详情分页列出当前授权可见的清单,选择清单后读取其中的任务,也可按准确的清单 ID 与任务 ID 查看单个任务。
  • 筛选近期未完成事项按最多 14 天的日期窗口查看未完成任务。默认查询过去 7 天到未来 7 天的范围;没有日期的任务应另用清单读取或关键词搜索核对。
  • 搜索任务并整理安排按关键词搜索,可结合清单、标签、完成状态和截止日期筛选。助手可以据返回结果建议处理顺序,建议本身不会更改已有任务的优先级或时间。
  • 确认后创建任务选择目标清单并确认标题后创建任务,可同时提供说明、开始或截止时间、全天标记、优先级和标签。日期与时区应在提交前明确。
  • 确认后标记完成先找到指定任务,核对标题、所在清单和任务 ID,再在您确认后将其标记为完成。当前接入没有删除或修改已有任务内容的操作。

如何生成滴答清单个人 API Token?

本接入使用国内版滴答清单账号的个人 API Token。官方提供个人令牌作为直接接入方式;如果您已有通过自己开放平台应用获得的 OAuth access_token,也可填写该访问令牌,但不能填写 Client Secret。

查看滴答清单官方 API 口令获取说明

  1. 登录国内版滴答清单打开 dida365.com 网页版,确认登录的是准备交给助手协助管理任务的账号。本连接使用国内版 API,不适用于国际版 TickTick 令牌。
  2. 创建个人 API 口令点击头像进入「设置 → 账户与安全 → API 口令」,创建并复制令牌。英文 Open API 文档对应的入口名称是「Settings → Account → API Token」。
  3. 连接托管机器人在 OpenClaw Launch 启动 Hermes Agent 或 OpenClaw,进入国内应用列表,找到「滴答清单」,将令牌填入「滴答清单 API Token」字段后连接。
  4. 从清单列表核对账号等待机器人可用后,让助手先列出清单名称,确认读到正确账号的内容。保存凭证不等于已经验证所有接口;首次成功查询才确认本次读取可用。
  5. 明确日期与查询范围查询近期待办时说明日期范围和时区。需要找无日期任务或更早的逾期任务时,使用具体清单或关键词单独查询,不要只依赖默认近期范围。
  6. 确认写入内容并核对结果让助手先展示目标清单、标题和开始或截止时间,确认后再创建。完成任务前核对具体条目;若创建响应不明确,先查询是否已经生成,再决定是否重试。
凭证与权限边界:个人 Token 提供对本人滴答清单账号的访问,应像密码一样保管。OpenClaw Launch 在服务端加密保存令牌,并通过代理请求国内版 Open API,原始令牌不写入机器人容器。读取沿用令牌权限;创建与完成任务要求先取得用户确认并携带 confirm:true。

连接后可以直接这样问

  • 列出滴答清单里我能访问的清单;再查看我选定清单中的任务,保留标题、截止时间和优先级,并说明结果是否被截断。
  • 按北京时间查询过去 7 天到未来 7 天的未完成任务,列出其中逾期的事项;说明本次日期范围,不要把结果当作全部待办。
  • 先找到「工作」清单,准备创建「提交项目周报」,截止时间为下周一北京时间 18:00;先展示具体日期、清单和标题,等我确认后再保存。

使用前必须知道的限制

清单列表每页最多 200 项,可按返回的下一页偏移继续读取。任务列表与搜索结果单次最多保留 200 条,结果截断时需缩小清单、关键词或日期范围。未完成任务查询的时间窗口最多 14 天,默认近期范围不会覆盖所有历史逾期或无日期任务。当前接入没有任务删除、已有任务改写、习惯、专注记录或日历同步功能。

不要把 API Token 发送到聊天或放入共享文档,泄露后在滴答清单撤销并更换。创建与完成会真实修改账号:先确认准确清单、任务与时间。创建请求若超时或返回结果未知,应先搜索任务或查询近期待办,确认没有生成重复项后再重试;助手对已有结果的排序建议不表示已修改您的任务设置。

托管连接还是自己搭工具?

方案适合谁您需要负责什么
OpenClaw Launch 托管希望尽快让机器人持续在线并连接滴答清单的用户提供必要授权、确认敏感操作并管理自己的应用账户
自行部署已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者为 Hermes Agent 或 OpenClaw 准备与滴答清单官方 Open API 兼容的工具,管理个人 Token 或自建 OAuth 授权,并维护日期与时区转换、分页、任务变更确认以及创建失败后的重复任务检查。

自行部署是合理选择;托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3,续费 $6/月,支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。

已经有机器人?前往国内应用一键接入查看连接状态;第一次部署可先阅读养龙虾入门指南

滴答清单接入常见问题

Hermes Agent 可以连接滴答清单吗?

可以。OpenClaw Launch 的国内应用工具同时服务于托管 Hermes Agent 和 OpenClaw,支持本页列出的任务查询、创建和完成操作。底层调用的是滴答清单官方 Open API。

必须注册 OAuth 应用才能连接吗?

个人使用可以直接在滴答清单网页版生成 API 口令,无需为此另建 OAuth 应用。已有自建应用 OAuth access_token 的用户也可填写访问令牌;请勿把 Client ID 或 Client Secret 当作 Token。

为什么查询近期待办没有出现所有未完成任务?

近期查询按日期窗口返回结果,单次最多 14 天,默认是过去 7 天到未来 7 天。更早的逾期任务和无日期任务可能不在窗口内;请按清单读取或使用关键词搜索,留意结果截断提示。

连接后会自动创建、完成或重新安排任务吗?

保存连接本身不会改动任务。创建和完成需先确认具体操作;助手可以提出安排建议,但当前没有修改已有任务日期、标题或优先级的接口,也不会因为查询就自动执行这些改动。

创建任务时超时了,可以马上再试一次吗?

先核对任务是否已经创建。请求可能已经到达滴答清单,只是响应没有成功返回;请先按标题搜索或查询对应清单,再决定是否重试,避免重复任务。

国际版 TickTick 的 Token 可以使用吗?

此连接使用 api.dida365.com 的国内版接口,需要国内版滴答清单对应的授权。不能把国际版 TickTick 的 Token 视为可以互换的凭证。

这是滴答清单官方 MCP 服务吗?

本页的托管连接通过官方 Open API 工作,再由 OpenClaw Launch 的国内应用工具提供给机器人。这里没有要求您部署第三方 MCP 服务,也没有把这个适配器称为滴答官方 MCP 服务。

继续配置您的中文 AI 助手

连接您的滴答清单任务助手

先创建持续在线的 AI Agent,再从国内应用列表连接滴答清单。托管首月 $3,续费 $6/月,支持支付宝和微信支付。

开始部署滴答清单助手