给你的 AI 助理加上 To Do 功能：让它真正帮你管任务

让懒猫微服里的“小龙猫”助手，通过 agenttodo-assistant 技能，连接到 AgentTODO，然后帮你查看、创建、拆分和更新待办任务。

你可以把它理解成：

• AgentTODO 负责保存你的任务。
• 小龙猫负责和你聊天、理解你的需求。
• agenttodo-assistant 技能负责告诉小龙猫应该怎么调用 AgentTODO。

0. 准备条件

0.1 需要先安装的应用

请先在懒猫微服中安装并启动下面几个应用。

1. 小龙猫

2. AgentTODO

3. 局域网端口转发工具

0.2 先在小龙猫中创建一个助手

打开小龙猫后，你需要先完成这些基础配置：

1. 安装或创建一个 Agent。
2. 创建一个助手。
3. 配置好这个助手使用的 AI 模型。
4. 确认可以正常和助手对话。

如果你现在还没有办法正常和小龙猫里的助手聊天，请先把小龙猫的基础配置完成，再继续后面的步骤。

1. 为什么需要端口转发

在懒猫微服里，每个应用都是一个独立的容器。

这意味着：

• 小龙猫是一个应用容器。
• AgentTODO 是另一个应用容器。
• 它们虽然都装在同一个懒猫微服里，但并不能直接用 localhost 互相访问。

很多新手最容易出错的地方，就是让小龙猫访问：

http://localhost:3300

这通常是不对的。

因为这里的 localhost 指的是“小龙猫自己所在的容器”，不是 AgentTODO 所在的容器。

所以我们需要先用“局域网端口转发工具”，把 AgentTODO 的 3300 端口转发到微服的物理网卡 IP 上。这样小龙猫助手就可以通过一个局域网地址访问 AgentTODO。

2. 配置 AgentTODO 端口转发

这一部分的目标是得到一个小龙猫可以访问的 AgentTODO 地址，格式类似：

http://192.168.1.140:3300

其中 192.168.1.140 要替换成你自己的微服物理网卡 IP。

2.1 打开局域网端口转发工具

在懒猫微服中打开“局域网端口转发工具”，新增一条端口转发规则。

2.2 填写基础信息和入口配置

请按下面方式填写：

1. 备注：填写 AgentTODO 端口开放
2. 协议：选择 TCP
3. 局域网入口类型：选择 微服物理网卡
4. 监听端口 / 端口段：填写 3300

这里最重要的是 局域网入口类型。

一定要选择：

微服物理网卡

这样转发出来的地址才会变成局域网里可以访问的地址。

2.3 填写目标配置

继续填写目标配置：

1. 转发目标类型：选择 微服应用
2. 微服应用：选择 AgentTODO
3. 实例用户：选择当前 AgentTODO 所在的用户，一般保持默认即可
4. 服务：选择 agenttodo
5. 目标端口：填写 3300

填写完成后，点击 测试目标连接。

• 如果测试成功，保存这条规则。
• 如果测试失败，请先看后面的常见问题。

2.4 记住微服物理网卡 IP

保存端口转发规则后，请记住你的微服物理网卡 IP。

比如你的微服物理网卡 IP 是：

192.168.1.140

那么 AgentTODO 的访问地址就是：

http://192.168.1.140:3300

后面要把这个地址告诉小龙猫助手。

请注意：

• 不要写成 localhost。
• 不要写成 127.0.0.1。
• 不要漏掉前面的 http://。
• 不要漏掉后面的端口 :3300。

3. 在小龙猫中安装 AgentTODO 技能

这一部分的目标是让小龙猫助手学会怎么使用 AgentTODO。

技能地址是：

https://github.com/iHunterDev/agenttodo-assistant

3.1 直接让助手安装技能

打开你在小龙猫中创建好的助手，直接发送下面这段话：

请帮我安装这个技能：
https://github.com/iHunterDev/agenttodo-assistant

3.2 等待技能安装完成

安装完成后，小龙猫应该会告诉你技能已经安装成功，或者可以开始使用这个技能。

如果安装失败，请先确认：

• GitHub 地址是否复制完整。
• 小龙猫当前是否可以正常联网。

4. 告诉助手 AgentTODO 地址

技能安装好以后，还需要告诉助手你的 AgentTODO 地址。

假设你前面记下来的微服物理网卡 IP 是：

192.168.1.140

那么你就对助手发送：

My AgentTODO address is http://192.168.1.140:3300

请把 192.168.1.23 换成你自己的微服物理网卡 IP。

发送以后，助手会根据这个地址自动推导出 AgentTODO API 地址：

http://192.168.1.140:3300/api

一般情况下，你不需要手动填写 /api，只需要告诉助手 AgentTODO 页面地址即可。

5. 测试是否连接成功

现在用一两句话测试一下即可。

5.1 查看今天的任务

对助手发送：

帮我看看今天要做什么。

如果连接成功，助手会去 AgentTODO 中读取今天的任务，然后再回复你。

如果你今天还没有任务，它可能会告诉你今天没有待办。

5.2 创建一个简单任务

继续测试创建任务：

帮我创建一个任务：明天下午 3 点前提交周报。

创建完成后，你可以打开 AgentTODO 页面（去应用列表，打开 AgentTODO 这个应用，可以看到当前的任务和管理任务），看任务是否已经出现。

6. 配置完成后可以怎么用

上面的步骤走完以后，基础配置就完成了。

下面这些不是必须操作的流程，只是一些日常使用时可以参考的说法。你可以按自己的习惯直接和助手说。

6.1 查看任务

今天我有哪些任务？

帮我看一下最近有哪些还没完成的事情。

我这周的任务压力大不大？

6.2 创建任务和计划

帮我添加一个任务：明天下午 3 点前提交周报。

帮我创建一个学习 Python 的计划，拆成 5 个步骤。

帮我记录一个每周五下午整理工作台的重复任务。

6.3 记录进展

我已经写完周报初稿了，帮我记录一下。

Python 学习计划里，环境安装这一步已经完成了。

搬家计划完成了，帮我把它标记为完成。

6.4 查找任务

帮我找一下和搬家有关的任务。

我之前是不是记过一个买显示器的任务？

7. 常见问题

7.1 为什么不能用 localhost:3300

因为小龙猫和 AgentTODO 是两个不同的应用容器。

在小龙猫里，localhost 指的是小龙猫自己的容器，不是 AgentTODO 的容器。所以小龙猫访问 localhost:3300 时，通常找不到 AgentTODO。

正确做法是使用微服物理网卡 IP，例如：

http://192.168.1.140:3300

7.2 端口转发测试失败怎么办

建议按下面顺序检查：

1. AgentTODO 是否已经启动。
2. 协议 是否选择了 TCP。
3. 局域网入口类型 是否选择了 微服物理网卡。
4. 监听端口 / 端口段 是否填写了 3300。
5. 转发目标类型 是否选择了 微服应用。
6. 微服应用 是否选择了 AgentTODO。
7. 服务 是否选择了 agenttodo。
8. 目标端口 是否填写了 3300。

如果这些都正确，但仍然失败，可以重启 AgentTODO 后再测试一次。

7.3 助手说无法连接 AgentTODO

优先检查你告诉助手的地址是否正确。

地址应该类似：

My AgentTODO address is http://192.168.1.140:3300

请重点检查：

• IP 是否是微服物理网卡 IP。
• 端口是否是 3300。
• 前面是否有 http://。
• 有没有错误地写成 localhost 或 127.0.0.1。

7.4 浏览器能打开 AgentTODO，但助手还是访问失败

请确认你是在同一个网络环境下测试。

有时候你的电脑浏览器能打开某个地址，不代表小龙猫所在的容器也一定能访问它。

在本教程的场景中，建议使用“局域网端口转发工具”暴露出来的微服物理网卡地址，也就是：

http://微服物理网卡IP:3300

7.5 技能安装失败怎么办

请检查下面几项：

1. 技能地址是否完整：

   https://github.com/iHunterDev/agenttodo-assistant
   

2. 小龙猫是否可以正常访问 GitHub。

3. 当前助手是否已经完成 AI 模型配置。

4. 当前助手是否支持安装技能。

如果只是网络问题，可以稍后再试或者使用小猪佩奇（找 VIP 群获取）。

7.6 任务创建了，但内容不是我想要的

你可以直接让助手修改，例如：

把刚才那个搬家计划改得更细一点，每一步都写清楚要做什么。

或者：

这个任务不要放到下周了，改成这周五之前完成。

对于比较重要的任务，建议你让助手先列出计划，确认后再创建：

先不要创建任务，先帮我列一个计划，我确认后你再写入 AgentTODO。

7.7 需要把 AgentTODO 暴露到公网吗

不建议。

AgentTODO 技能的默认使用场景是可信局域网。请不要把 AgentTODO 直接暴露到公网，避免不必要的安全风险。

8. 最后确认

如果下面几件事都能完成，就说明配置成功了：

1. 你可以通过 http://微服物理网卡IP:3300 打开 AgentTODO。
2. 小龙猫已经安装 agenttodo-assistant 技能。
3. 你已经告诉助手 AgentTODO 地址。
4. 助手可以读取今天的任务。
5. 助手可以创建任务、拆分子任务、记录进展。

完成以后，你就可以把小龙猫当成自己的任务助理来用了。