个人用户龙虾接入指南：MiniTeamClawUI 配置与登录流程

# MiniTeamClawUI 接入小龙猫 OpenClaw 教程 ## 0. 准备条件 ### 0.1 环境前提 - 已拥有一个可正常运行的小龙猫环境下的 OpenClaw 类型助手。 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.totoro - 当前应用已经安装完成，并能正常打开。 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.miniteamclawui ### 0.2 前置准备 - 确认小龙猫已完成基础配置，并且 OpenClaw 助手能够正常运行。 - 确认 MiniTeamClawUI 已安装完成，并可以正常进入部署向导。 - 后续需要在小龙猫助手对话区域右上角的 webshell 中查询 Gateway Token，并在需要时执行设备审批命令。 ### 0.3 参考教程 如果尚未完成小龙猫的基础配置，请先参考[小龙猫使用攻略](https://playground.lazycat.cloud/#/guideline/1558)。 ## 1. 配置小龙猫里的龙虾访问方式 先在 LightOS WebShell 中发布 OpenClaw Gateway 服务，获取应用域名。后续 MiniTeamClawUI 会用这个域名连接龙虾。 ### 1.1 配置端口转发 在 LightOS WebShell 中发布 OpenClaw Gateway 服务。 #### 1.1.0 打开龙虾的 WebShell 打开 LightOS 应用，找到小龙猫里的 OpenClaw，也就是龙虾应用，然后打开它的 WebShell。  打开 WebShell 后，在右侧终端管理面板中确认当前容器是 OpenClaw，然后点击右上角的 `添加`。  #### 1.1.1 添加服务发布 在 `服务配置` 页面中填写： - `上游协议`：选择 `HTTP`。 - `上游地址`：填写 `127.0.0.1`。 - `端口`：必须填写 `18789`。 - `标题`：可以按自己的习惯填写，例如 `我的 OpenClaw`。 - `子域名`：可以按自己的习惯填写，例如 `myopenclaw`。 - `不使用懒猫账号保护`：必须勾选。 端口必须填写 `18789`，并勾选 `不使用懒猫账号保护`。 填写完成后，点击 `部署服务`。  #### 1.1.2 找到刚发布的服务应用 部署完成后，回到懒猫微服应用列表，进入 `我的` 页面，找到刚才发布的应用。 应用名称就是上一步在 `标题` 中填写的名称。 打开应用右键菜单，点击 `应用详情`。  #### 1.1.3 获取 OpenClaw 访问地址 进入应用详情后，找到 `应用域名`。这个域名后续要填写到 MiniTeamClawUI。 例如应用域名为： ```text myopenclaw.ailab.heiyu.space ``` 在 MiniTeamClawUI 中填写 `OpenClaw 地址` 时，需要加上 `wss://` 前缀，最终填写为： ```text wss://myopenclaw.ailab.heiyu.space ``` 获取到这个访问地址后，本步骤完成。  如果使用自建 OpenClaw，请填写实际可访问的 OpenClaw Gateway 地址。 ## 2. 配置 MiniTeamClawUI 连接小龙猫里的龙虾 这一部分的目标是让 MiniTeamClawUI 成功连接到小龙猫中的 OpenClaw，并完成后续登录。 ### 2.1 完成部署向导初始化 首次启动 MiniTeamClawUI 后，会进入部署向导页面。按照页面提示填写后，点击开始部署。 填写时建议注意以下几点： - `懒猫用户名` 必须填写正确，否则后续网盘文件选择和附件上传可能异常。 - `应用登录密码` 是后续进入 MiniTeamClawUI 时使用的密码，建议提前记录。 - `OpenClaw 默认 Agent 名称` 如果没有特殊定制需求，建议保持默认值。 - `懒猫网盘选择文件支持` 一般建议保持开启，便于后续团队协作时上传文件到 OpenClaw。 完成后，页面会进入连接工作区的引导配置环节。  ### 2.2 填写 OpenClaw 连接信息  这一步会进入 `连接你的工作区` 页面。按下面方式填写。 #### 2.2.1 OpenClaw 地址 填写 OpenClaw Gateway 的访问地址。地址格式必须以 `ws://` 或 `wss://` 开头。 如果使用小龙猫，请填写第 `1.1.3` 步获取到的应用域名，并在前面加上 `wss://`。示例： ```text wss://myopenclaw.ailab.heiyu.space ``` 如果你使用的是自建 OpenClaw，请根据实际部署环境填写 OpenClaw Gateway 访问地址。常见情况如下： 1. 局域网访问地址 如果 MiniTeamClawUI 能访问 OpenClaw 所在设备的局域网地址，可以填写局域网地址，例如： ```text ws://192.168.1.100:18789 ``` 填写的 IP 必须能被 MiniTeamClawUI 所在微服访问。 2. 公网访问地址 如果 OpenClaw Gateway 已经通过公网域名或公网 IP 暴露，并且当前微服可以访问互联网，可以填写公网地址，例如： ```text wss://openclaw.example.com ``` 公网地址需要能被 MiniTeamClawUI 所在微服访问。 #### 2.2.2 Gateway 认证方式 `Gateway 认证方式` 选择： ```text Token ``` #### 2.2.3 Gateway Token `Gateway Token` 在 OpenClaw 所在环境的终端中查询。如果使用小龙猫，就在小龙猫 WebShell 中执行。 在终端中执行： ```bash grep '"token"' ~/.openclaw/openclaw.json ``` 输出结果通常类似于： ```text "token": "abc" ``` 只填写引号中的 token 值，例如： ```text abc ``` 请注意： - 不要复制前后的引号。 - 不要复制 `token:` 这一段键名。 - 不要把结尾逗号一起复制进去。 首次连接当前工作区时，`Gateway Token` 必须填写。已保存过 token 的工作区可以留空。 #### 2.2.4 工作区访问地址 填写团队成员访问这个前端工作区时使用的地址，只填写协议和域名即可。 可以点击 `填入当前页面域名` 自动填写，也可以手动填写当前 MiniTeamClawUI 应用地址： ```text https://miniteamclaw.${你的微服名字}.heiyu.space ``` 请将 `${你的微服名字}` 替换为当前微服实例的实际名称。 ### 2.3 保存配置并继续 填写完成后，核对： - `OpenClaw 地址` 与当前小龙猫或自建 OpenClaw Gateway 的实际访问地址一致。 - `Gateway Token` 填写的是纯 token 值。 - `工作区访问地址` 使用的是当前应用可以正常访问的协议和域名。 确认无误后，点击 `保存并继续`。  ### 2.4 检查连接状态  保存后，点击 `检查连接`。 如果页面提示需要审批设备访问，复制页面给出的审批命令，到 OpenClaw 所在环境的终端中执行。使用小龙猫时，在小龙猫 WebShell 中执行。   命令格式通常如下： ```bash openclaw devices approve <device-id> ``` 示例： ```bash openclaw devices approve 60d5433d-3f04-4ae9-8ced-7dfc7605c386 ```  执行完成后，回到页面，再次点击 `检查连接`。  页面提示连接成功，并出现 `继续登录` 按钮后，连接完成。  ### 2.5 连接失败时的排查方法 如果连接检查没有通过，检查： 1. 确认 `OpenClaw 地址` 是否填写正确，并且 MiniTeamClawUI 所在微服能够访问该地址。 2. 确认 `Gateway Token` 是否填写正确，且没有包含多余引号或标点。 3. 确认 OpenClaw 当前处于运行状态。 4. 确认审批命令已经在 OpenClaw 所在环境的终端中成功执行。 5. 确认 `工作区访问地址` 是当前应用真实可访问的协议和域名，例如 `https://xxx.heiyu.space`，不要填写路径。 ## 3. 登录并绑定懒猫账号 当页面出现 `继续登录` 后，点击进入登录流程。  ### 3.1 使用懒猫微服账号登录 在登录页点击 `使用懒猫微服登录`，然后在授权页面点击 `Grant Access`。  ### 3.2 绑定本地账号 授权完成后，页面会返回本地账号绑定界面。 请填写： 1. `用户名`：当前工作区中的本地账号名 2. `密码`：该本地账号对应的密码 填写后点击 `绑定账号`。  ### 3.3 完成验证 绑定成功后，如果页面进入 MiniTeamClawUI 主界面，就表示整个接入流程已经完成。 建议最后确认以下内容： - 可以正常进入 MiniTeamClawUI 主界面。 - 可以正常发起与 OpenClaw 相关的操作。 - 当前账号可以正常使用文件选择、附件上传等功能。  ## 4. 常见问题 ### 4.1 服务发布后无法访问 OpenClaw 地址 如果第 `1.1.3` 步获取到的 OpenClaw 地址无法访问，检查： - 服务发布时端口是否填写为 `18789`。 - 服务发布时是否勾选了 `不使用懒猫账号保护`。 - 当前发布的服务是否属于小龙猫里的 OpenClaw，也就是龙虾容器。 - 小龙猫里的 OpenClaw 是否处于正常运行状态。 ### 4.2 连接检查无法通过 检查： - `OpenClaw 地址` 是否正确，并且已经加上 `wss://` 前缀。 - `OpenClaw 地址` 是否来自第 `1.1.3` 步获取到的应用域名。 - `Gateway Token` 是否正确。 - OpenClaw 是否处于运行状态。 - 设备审批命令是否已在小龙猫 WebShell 中执行。 - `工作区访问地址` 是否是当前 MiniTeamClawUI 应用真实可访问的协议和域名，例如 `https://xxx.heiyu.space`，不要填写路径。 ### 4.3 LightOS 环境中无法访问 MiniTeamClawUI 或 OpenClaw 如果需要在 LightOS 中访问当前 MiniTeamClawUI 应用，请将 LightOS 网络模式改为 `host`。 `macvlan` 和 `ipvlan` 可能导致页面无法访问或连接检查失败。 ### 4.4 登录后无法正常使用附件或网盘功能 检查部署向导中的 `懒猫用户名` 是否填写正确。 ## 5. 界面截图 ### 5.1 移动端截图      ### 5.2 PC 截图     

买微服血赚攻略：独家功能，帮我把Mac电脑桌面文件整理一下并发PPT到Windows上

Mac 电脑在日常学习或办公后，桌面上常常会堆积许多零散文件。时间一长，不仅整理起来麻烦，也会影响使用效率。为了更方便地管理桌面文件，并在不同设备或系统之间快速传输文件，可以使用小龙猫的新技能来完成桌面整理、文件传输等操作： 使用到的应用： https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.totoro https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.lazycat-filedrop-skill 首先确认"允许访问本地系统"这个开关是打开的：   给小龙猫安装完成"懒猫文件管家技能"后，需要在小龙猫里面对应助手打开技能，先进入小龙猫应用内：  勾选想要使用的助手，打开这个技能开关：  然后查看MCP状态，确认有没有MCP同步失败的。  我这里有一个失败的，点击一下重试同步：  完成后就会消失，没有就不用管这里：  现在我的MAC桌面现在比较乱，然后我还想把刚刚写好的PPT放到我的Windows里面，等会方便演示。  和小龙猫说：帮我把mac电脑桌面文件整理一下并且把桌面上的ppt发到我的windows上 MacOS要确认同意一下权限：  同意后再输入一次：  小龙猫的执行过程还是很有意思的，你可以看到图标分门别类的按顺序被放到不同的文件夹，这就是整理完成后的内容：  查看桌面上的文件夹也都是分门别类的放进去了：   查看我的Windows电脑桌面，PPT文件也被放到桌面了。  需要注意：如果要删除文件一定要让助手列出要删除的文件一个个进行确认！！！小心自己的数据突然消失。  玩法远不止于此，我介绍的只是其中一种操作方式。熟练掌握后，你可以根据自己的需求继续探索更多用法。

买微服血赚攻略：神级工具，小龙猫Agent+懒猫清单技能玩法必看

今天这篇**血赚攻略**，不聊虚的。我们只讲一件事：**如何通过“懒猫清单技能”，让小龙猫变成你最听话、最靠谱的执行秘书。**  先来介绍一下主角 - **懒猫清单**：一个任务管理工具本体 - **小龙猫**：你的智能助手 - **懒猫清单技能（Skill）**：**连接小龙猫和懒猫清单的“桥”**。装上这个技能，小龙猫才能真正替你操作清单，而不仅仅是“教你如何用清单” https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.skill.lzc-todolist-skill https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.todolist https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.totoro ## 小龙猫安装并配置 SKILL 安装后上文提到的懒猫应用后， 打开小龙猫客户端，点击技能商店。  进入到清单技能详细页面后，打开对应小助手的技能权限  ## 懒猫清单技能的核心玩法 有了这个技能，你不需要打开任何界面，不需要点来点去。**像跟真人助理说话一样，交代给小龙猫就行。** ### 🎯 玩法1：创建任务 > **你对小龙猫说：** > “使用懒猫清单，帮我创建一个本周五晚上9点去看电影的任务。” 小龙猫会自动： - 在懒猫清单里新增一条任务：“去看电影” - 时间设为：本周五 21:00 - 你甚至可以直接加优先级：“高优先级”  ### 🎯 玩法2：查询任务 > **你对小龙猫说：** > “使用懒猫清单，查一下今天未完成的高优先级任务。” 小龙猫秒回： - 任务列表 - 每个任务的标题、时间、状态 - 如果太多，它会帮你汇总  ### 🎯 玩法3：更新任务 > **你对小龙猫说：** > “使用懒猫清单，把标题包含‘发票’的任务标记为完成。” 小龙猫会： - 搜索所有标题带“发票”的任务 - 批量标记为完成 - 告诉你更新了几条  ### 🎯 玩法4：统计任务 > **你对小龙猫说：** > “使用懒猫清单，统计本月任务完成率。” 小龙猫返回： - 总任务数 / 已完成数 - 完成百分比 - 甚至按优先级拆分  至此，您已经掌握懒猫清单和小龙猫的结合协作

小龙猫使用攻略

https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.totoro ## 新建助手 我这边按照创建一个 hermes 的流程来演示 安装好之后直接打开 点击创建 AI 助手  填写助手名称和选择要使用的 AI Agent，然后点击创建助手  添加 AI 供应商  添加供应商的名称，AI 协议，API 地址，和 AI 的 Key 之后点击下拉菜单可以选择自己要使用的模型，我这里选择的 gpt-5.5  选择之后点击验证，提示验证成功之后点击保存  > 如果有多个供应商，这里点击会切换所有 AI 助手使用的供应商，如果想指定某个 AI 助手不跟随全局，可以在 AI 助手的管理界面锁定使用的 AI 供应商 我们可以查看当前 AI 助手使用的供应商  我这里是锁定的 gpt-5.5  配置完成就可以和我们的助手聊天了  ## 绑定聊天软件 可以在助手的设置页面，点击自己要绑定的聊天软件  > 这里根据网络情况可能要多等待一会  出现二维码之后使用聊天软件扫码  登录过的聊天软件图标会有颜色区分  如果需要重新绑定，再次点击就有重新绑定的按钮  ## AI 助手升级 更新 AI 助手的版本，在 AI 助手设置页面，点击版本升级   ## AI 助手访问懒猫网盘 读写懒猫网盘的文件，可以在 AI 助手设置页面，点击**文件权限管理**进行配置   ## AI 助手管理 在 AI 助手管理页面，可以重启，删除和查看助手的日志  

AxonHub -- 给你的小龙猫装上一个AI模型网关

之前用CPA来搭配小龙虾，这次我们换个新的AI模型网关---AxonHub，正好给新晋选手---小龙猫来配置使用。 先打开下面的AxonHub应用链接，在懒猫商店里安装。 https://appstore.lazycat.cloud/#/shop/detail/community.lazycat.app.axonhub 首次打开会有个配置向导，小白不懂的话，直接默认点击下方开始部署即可。  ### 注册账号密码 进入应用后，首先需要创建账号密码，按需对应填写即可，然后点击“初始化系统”。  进入后，填写你创建的账号密码进行登录。  首次进入应用会有个配置向导。如果你想先了解一下这个应用的话，可以点击“开始引导”，跟随它的指引一一了解功能。这里我们就直接点击“跳过引导”，到下一步。  ### 配置AI模型 > 跟CPA一样，需要先配置AI厂商模型。 点击左侧的“渠道”，然后点击页面右上角的“添加渠道”。  在新跳出的窗口可以看到左侧基本上主流的AI服务商都包含在内了，右侧就是每个服务商需要设定的配置信息。  #### 这里我们先配置Deepseek，可参考下图。 1. 左侧选择“Deepseek”渠道 2. 右侧“渠道名称”可自己修改 3. 下方“API Key”填入你的ds官方key 4. 点击“获取”，即可在右侧看到对应可以使用的模型 5. 根据自己的爱好进行配置，点击“确认选中” 6. 需要在默认测试模型中选择一个模型，用于测试API Key是否可行 7. 填写完所有之后就可以点击右下角的“创建”  创建完成之后，我们就可以看到在渠道中新增的DS配置，这时还需要点击打开“状态”， 点击“测试”看连通性，显示“测试成功”后，就可以点击下方的“启用”。这样我们才算真正的把DS接入到AxonHub上。   #### 如果你有算力仓，也可以按照下图来进行配置 1. 左侧选择“OpenAI”渠道（因为算力仓地址兼容OpenAI渠道，可以选这个进行配置） 2. 右侧“渠道名称”可自己修改 3. "Base Url"需要改成算力仓Ollama地址，即“https://ollama-ai.你的设备名.heiyu.space/v1” 4. 下方“API Key”可随意填写 5. 点击“获取”，即可在右侧看到对应可以使用的模型 6. 根据自己的爱好进行配置，点击“确认选中” 7. 需要在默认测试模型中选择一个模型，用于测试API Key是否可行 8. 填写完所有之后就可以点击右下角的“创建”  配置完成之后，还是安装上述再打开“状态”-“测试”-“启用”  #### 如果你购买的是三方API厂商的服务的话，也可以参考下图配置。 流程也是和上述算力仓配置一样，这里就不多赘述了。  到这里，就已经完成了AI服务商的配置并启用了。  ### 配置API Key > 为了能访问使用AxonHub，我们需要先配置API Key。 点击左侧“API密钥”，进入页面后，点击右上角“创建API Key”，在跳出的窗口内，可按需修改名称，类型默认“用户”即可，然后点击“创建”。  创建完之后，我们就可以看到API Key，以及对应的AI客户端的配置示例（如果你正好有用到的话，可以复制这些配置进行替换）。 我们这里需要关注的是这个对外的“Base Url”的填写： 如果你用兼容OpenAI的客户端，填写“https://axonhub.你的设备名.heiyu.space/v1” 如果你用兼容Anthropic的客户端，填写“https://axonhub.你的设备名.heiyu.space/anthropic”  至此，你已经配置好了AI模型和API Key，下一步就是在小龙猫里使用 ## 配置小龙猫并使用 打开下方小龙猫链接并安装 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.totoro 新建助手流程就不多说了，这里直接给出AI配置方式，见下图： 1. 点击左侧“AI配置” 2. “供应商名称”可自行填写 3. “AI协议”可选择“OpenAI”，也可选择“Anthropic” 4. “API URL”根据你选择“AI协议”，填写对应的地址，这里我就填写“https://axonhub.你的设备名.heiyu.space/v1” 5. "API Key"填写你在AxonHub里获取的API Key 6. ”模型名称“里，点击下拉箭头选择获取模型 7. 选择你需要的模型 配置好后，点击测试，显示”测试成功“，即表示配置完成了。点击”添加AI供应商“保存配置。  但实际情况是，截止到目前为止，你配置完之后聊天会显示”API call failed after 3 retries: Connection error.“ 连接错误  这时候，你需要用到端口转发工具，对AxonHub进行端口转发配置 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward 配置后，只需要对应修改下”API URL“改成你的IP地址，见下图。这时候选择模型进行验证会显示”验证失败“，不用管，点击保存即可。  然后你进行对话，这时候就可以用了。  AxonHub还有个好处就是，你可以在左侧”请求“里，查看到最近一次”请求详情“，方便你进行查看。  主页面你也可以查看AI模型厂商的调用情况，方便你管理多个上游AI模型厂商。 

买微服血赚攻略：用小龙猫实现看电影自由

传统 NAS 需要手动找资源、下载资源、再保存资源，操作繁琐，非常不便。 **小龙猫** 是一款新一代 AI Agent 管理软件，可以理解为您的专属私人秘书——您只需发号施令，它就能帮您干活、解答疑问。 **VueTorrent** 是一个开源种子下载器，专门用来下载电影资源，好比一把工具。 **Skill（技能）**，则是教会秘书干活的本领宝典。配置好工具后，再教给秘书相应的技能，它就能自动为您寻找并下载资源。 您可以通过 **VueTorrent** 和 **技能（SKILL）**，让微服内的 **小龙猫助手** 拥有自动搜索、下载、保存资源的能力，真正实现观影自由。 想看电影，只需跟小龙猫说一声，它就会自动完成下载并保存到网盘。 --- 下面我来为您演示一下如何通过小龙猫下载加勒比海盗到懒猫网盘中 ### 需要下载的应用 请下载并安装以下软件： - 小龙猫助手： https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.totoro - VueTorrent 下载器： https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.vuetorrent 安装完成后，请参考 **这篇教程** 完成小龙猫的基础配置： https://playground.lazycat.cloud/#/guideline/1558 > 建议 API 模型使用 ChatGPT 5.4 及以上版本。 配置完成后，在小龙猫中打开已创建的助手，在对话框中发送以下内容： ``` https://github.com/whoamihappyhacking/lazycat-movie-search-skill 帮我安装好这个技能 ``` 稍等片刻小龙猫就会告知安装状态。如果安装失败，请确认： - GitHub 地址是否完整复制 - 小龙猫当前是否可以正常联网  --- ## 开始使用 在安装好技能的助手中发送： `懒猫电影搜索 "电影名"` （将“电影名”替换为实际要搜索的电影，例如：`懒猫电影搜索 复仇者联盟`，尽量不要增加多余描述） 发送成功后，小龙猫便通过技能自动查询相关资源。您可以看到它搜索出大量资源列表。  您可以告诉小龙猫需要哪一部资源。建议优先选择 **Seeds/Peers（种子数/连接数）** 较高的资源。图中带有火焰标志的资源，数值越高表示越**热门**、做种者越多，下载速度也更快。  下载任务开始时，小龙猫会第一时间通知您。您也可以手动输入 `懒猫电影搜索 下载状态` 来查询下载进度。 如果下载失败，请检查： - 小龙猫的网络是否正常 - 微服所在网络环境是否限制了 P2P 下载 - 如果使用代理，确认代理服务器是否允许 P2P 下载 - 资源是否有有效的做种者  当确认电影下载完成后，您可以指挥小龙猫将文件存放到网盘中的指定目录。例如，这里让它存放在“电影”目录下。   至此，小龙猫已完整完成**搜索 → 下载 → 保存到指定位置**的全过程。您只需打开网盘，即可畅享观影。 

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

让懒猫微服里的“小龙猫”助手，通过 `agenttodo-assistant` 技能，连接到 AgentTODO，然后帮你查看、创建、拆分和更新待办任务。 你可以把它理解成： - AgentTODO 负责保存你的任务。 - 小龙猫负责和你聊天、理解你的需求。 - `agenttodo-assistant` 技能负责告诉小龙猫应该怎么调用 AgentTODO。 ## 0. 准备条件 ### 0.1 需要先安装的应用 请先在懒猫微服中安装并启动下面几个应用。 1. 小龙猫 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.totoro 2. AgentTODO https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.agenttodo 3. 局域网端口转发工具 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward ### 0.2 先在小龙猫中创建一个助手 打开小龙猫后，你需要先完成这些基础配置： 1. 安装或创建一个 Agent。 2. 创建一个助手。 3. 配置好这个助手使用的 AI 模型。 4. 确认可以正常和助手对话。 如果你现在还没有办法正常和小龙猫里的助手聊天，请先把小龙猫的基础配置完成，再继续后面的步骤。  ## 1. 为什么需要端口转发 在懒猫微服里，每个应用都是一个独立的容器。 这意味着： - 小龙猫是一个应用容器。 - AgentTODO 是另一个应用容器。 - 它们虽然都装在同一个懒猫微服里，但并不能直接用 `localhost` 互相访问。 很多新手最容易出错的地方，就是让小龙猫访问： ```text http://localhost:3300 ``` 这通常是不对的。 因为这里的 `localhost` 指的是“小龙猫自己所在的容器”，不是 AgentTODO 所在的容器。 所以我们需要先用“局域网端口转发工具”，把 AgentTODO 的 `3300` 端口转发到微服的物理网卡 IP 上。这样小龙猫助手就可以通过一个局域网地址访问 AgentTODO。 ## 2. 配置 AgentTODO 端口转发 这一部分的目标是得到一个小龙猫可以访问的 AgentTODO 地址，格式类似： ```text http://192.168.1.140:3300 ``` 其中 `192.168.1.140` 要替换成你自己的微服物理网卡 IP。 ### 2.1 打开局域网端口转发工具 在懒猫微服中打开“局域网端口转发工具”，新增一条端口转发规则。  ### 2.2 填写基础信息和入口配置 请按下面方式填写： 1. `备注`：填写 `AgentTODO 端口开放` 2. `协议`：选择 `TCP` 3. `局域网入口类型`：选择 `微服物理网卡` 4. `监听端口 / 端口段`：填写 `3300` 这里最重要的是 `局域网入口类型`。 一定要选择： ```text 微服物理网卡 ``` 这样转发出来的地址才会变成局域网里可以访问的地址。  ### 2.3 填写目标配置 继续填写目标配置： 1. `转发目标类型`：选择 `微服应用` 2. `微服应用`：选择 `AgentTODO` 3. `实例用户`：选择当前 AgentTODO 所在的用户，一般保持默认即可 4. `服务`：选择 `agenttodo` 5. `目标端口`：填写 `3300` 填写完成后，点击 `测试目标连接`。 - 如果测试成功，保存这条规则。 - 如果测试失败，请先看后面的常见问题。  ### 2.4 记住微服物理网卡 IP 保存端口转发规则后，请记住你的微服物理网卡 IP。 比如你的微服物理网卡 IP 是： ```text 192.168.1.140 ``` 那么 AgentTODO 的访问地址就是： ```text http://192.168.1.140:3300 ``` 后面要把这个地址告诉小龙猫助手。 请注意： - 不要写成 `localhost`。 - 不要写成 `127.0.0.1`。 - 不要漏掉前面的 `http://`。 - 不要漏掉后面的端口 `:3300`。  ## 3. 在小龙猫中安装 AgentTODO 技能 这一部分的目标是让小龙猫助手学会怎么使用 AgentTODO。 技能地址是： ```text https://github.com/iHunterDev/agenttodo-assistant ``` ### 3.1 直接让助手安装技能 打开你在小龙猫中创建好的助手，直接发送下面这段话： ```text 请帮我安装这个技能： https://github.com/iHunterDev/agenttodo-assistant ```  ### 3.2 等待技能安装完成 安装完成后，小龙猫应该会告诉你技能已经安装成功，或者可以开始使用这个技能。 如果安装失败，请先确认： - GitHub 地址是否复制完整。 - 小龙猫当前是否可以正常联网。  ## 4. 告诉助手 AgentTODO 地址 技能安装好以后，还需要告诉助手你的 AgentTODO 地址。 假设你前面记下来的微服物理网卡 IP 是： ```text 192.168.1.140 ``` 那么你就对助手发送： ```text My AgentTODO address is http://192.168.1.140:3300 ``` 请把 `192.168.1.23` 换成你自己的微服物理网卡 IP。 发送以后，助手会根据这个地址自动推导出 AgentTODO API 地址： ```text http://192.168.1.140:3300/api ``` 一般情况下，你不需要手动填写 `/api`，只需要告诉助手 AgentTODO 页面地址即可。  ## 5. 测试是否连接成功 现在用一两句话测试一下即可。 ### 5.1 查看今天的任务 对助手发送： ```text 帮我看看今天要做什么。 ``` 如果连接成功，助手会去 AgentTODO 中读取今天的任务，然后再回复你。 如果你今天还没有任务，它可能会告诉你今天没有待办。  ### 5.2 创建一个简单任务 继续测试创建任务： ```text 帮我创建一个任务：明天下午 3 点前提交周报。 ``` 创建完成后，你可以打开 AgentTODO 页面（去应用列表，打开 AgentTODO 这个应用，可以看到当前的任务和管理任务），看任务是否已经出现。   ## 6. 配置完成后可以怎么用 上面的步骤走完以后，基础配置就完成了。 下面这些不是必须操作的流程，只是一些日常使用时可以参考的说法。你可以按自己的习惯直接和助手说。 ### 6.1 查看任务 ```text 今天我有哪些任务？ ``` ```text 帮我看一下最近有哪些还没完成的事情。 ``` ```text 我这周的任务压力大不大？ ``` ### 6.2 创建任务和计划 ```text 帮我添加一个任务：明天下午 3 点前提交周报。 ``` ```text 帮我创建一个学习 Python 的计划，拆成 5 个步骤。 ``` ```text 帮我记录一个每周五下午整理工作台的重复任务。 ``` ### 6.3 记录进展 ```text 我已经写完周报初稿了，帮我记录一下。 ``` ```text Python 学习计划里，环境安装这一步已经完成了。 ``` ```text 搬家计划完成了，帮我把它标记为完成。 ``` ### 6.4 查找任务 ```text 帮我找一下和搬家有关的任务。 ``` ```text 我之前是不是记过一个买显示器的任务？ ``` ## 7. 常见问题 ### 7.1 为什么不能用 `localhost:3300` 因为小龙猫和 AgentTODO 是两个不同的应用容器。 在小龙猫里，`localhost` 指的是小龙猫自己的容器，不是 AgentTODO 的容器。所以小龙猫访问 `localhost:3300` 时，通常找不到 AgentTODO。 正确做法是使用微服物理网卡 IP，例如： ```text 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 优先检查你告诉助手的地址是否正确。 地址应该类似： ```text My AgentTODO address is http://192.168.1.140:3300 ``` 请重点检查： - IP 是否是微服物理网卡 IP。 - 端口是否是 `3300`。 - 前面是否有 `http://`。 - 有没有错误地写成 `localhost` 或 `127.0.0.1`。 ### 7.4 浏览器能打开 AgentTODO，但助手还是访问失败 请确认你是在同一个网络环境下测试。 有时候你的电脑浏览器能打开某个地址，不代表小龙猫所在的容器也一定能访问它。 在本教程的场景中，建议使用“局域网端口转发工具”暴露出来的微服物理网卡地址，也就是： ```text http://微服物理网卡IP:3300 ``` ### 7.5 技能安装失败怎么办 请检查下面几项： 1. 技能地址是否完整： ```text https://github.com/iHunterDev/agenttodo-assistant ``` 2. 小龙猫是否可以正常访问 GitHub。 3. 当前助手是否已经完成 AI 模型配置。 4. 当前助手是否支持安装技能。 如果只是网络问题，可以稍后再试或者使用小猪佩奇（找 VIP 群获取）。 ### 7.6 任务创建了，但内容不是我想要的 你可以直接让助手修改，例如： ```text 把刚才那个搬家计划改得更细一点，每一步都写清楚要做什么。 ``` 或者： ```text 这个任务不要放到下周了，改成这周五之前完成。 ``` 对于比较重要的任务，建议你让助手先列出计划，确认后再创建： ```text 先不要创建任务，先帮我列一个计划，我确认后你再写入 AgentTODO。 ``` ### 7.7 需要把 AgentTODO 暴露到公网吗 不建议。 AgentTODO 技能的默认使用场景是可信局域网。请不要把 AgentTODO 直接暴露到公网，避免不必要的安全风险。 ## 8. 最后确认 如果下面几件事都能完成，就说明配置成功了： 1. 你可以通过 `http://微服物理网卡IP:3300` 打开 AgentTODO。 2. 小龙猫已经安装 `agenttodo-assistant` 技能。 3. 你已经告诉助手 AgentTODO 地址。 4. 助手可以读取今天的任务。 5. 助手可以创建任务、拆分子任务、记录进展。 完成以后，你就可以把小龙猫当成自己的任务助理来用了。

买微服血赚攻略：用小龙猫实现听音乐自由

### 需求背景：想下载音乐存储在本地，用来听歌或者搭建个人音乐服务器（例如Navidrome）但是资源较少、各大网站下载繁琐，歌词不能下载等。 使用到的应用： https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.totoro https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.lzcmusicplayer ### **1.懒猫微服商店下载“小龙猫”** 具体配置教程可参考：[小龙猫使用攻略 - 懒猫攻略](https://lazycat.cloud/playground/guideline/1558)  ### **2.安装SKILL** 直接和他说："学习一下：https://github.com/whoamihappyhacking/joox-music-download-skill"  ### 3.直接开玩 有多种方式，我这里例举两种，AI会自己去获取歌单并且下载。  **我有自己的音源，要是怕污染音源，也可以单独让小龙猫建一个文件夹**  **还可以模糊的问：帮我推荐最近的热歌，搜索后帮我逐一在JOOX下载**  要是歌曲没看到，可以在右上角点击一下刷新  要是没扫出来音乐的话可以看一下小龙猫对话，确认一下放置音乐的目录在哪里。  我的目录就在懒猫网盘的Music目录里面，如果另外建立了一个文件夹，可以按照下面方式在懒猫音乐进行歌曲添加   也可以添加远程挂载和外置硬盘 

小龙猫 + Vikunja + GTD 个人任务管理教程

# 基于小龙猫 + Vikunja + GTD 的个人任务管理助理  这篇教程把懒猫微服中的“小龙猫”连接到 Vikunja，并用简化版 GTD 管理个人任务。 分工如下： - Vikunja：保存和展示任务。 - 小龙猫：理解你的指令。 - GTD：提供任务整理规则。 - 小龙猫技能：调用 Vikunja API，把任务写入系统。 开始前，先在懒猫微服中安装并打开小龙猫和 Vikunja。 接下来完成 5 件事： - 配置 Vikunja 端口转发 - 获取 Vikunja API Token - 获取 Vikunja 的 OpenAPI JSON 文件 - 让小龙猫生成 Vikunja 技能 - 让小龙猫自动初始化 GTD 项目，并按 GTD 管理任务 ## 0. 准备条件 确认下面内容已准备好。 1. 小龙猫 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.totoro 2. Vikunja https://appstore.lazycat.cloud/#/shop/detail/dev.beiyu.vikunja 3. 局域网端口转发应用 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward ## 1. 最终效果 配置完成后，对小龙猫说： ```text 帮我记录一下：明天上午整理发票。 ``` 小龙猫会把任务写入 Vikunja。 也可以问： ```text 我今天有什么下一步任务？ ``` 或者： ```text 帮我看看有哪些事情还在等待别人回复。 ``` Vikunja 保存任务，小龙猫接收你的自然语言指令。 ## 2. 简化版 GTD 这里使用 5 个 GTD 分类。先了解分类含义，不用手工创建。 | 项目 | 用途 | | --- | --- | | 收件箱 | 存放刚想到、还没整理的事情 | | 项目 | 存放需要多个步骤才能完成的事情 | | 下一步 | 存放现在可以执行的具体动作 | | 等待中 | 存放需要别人回复、处理或确认的事情 | | 将来可能 | 存放现在不做、以后可能做的想法 | 基本流程： ```text 先收件，再整理，最后只看下一步。 ``` ## 3. 为什么需要端口转发 在懒猫微服中，每个应用都运行在独立容器里。 - 小龙猫在一个容器里。 - Vikunja 在另一个容器里。 - 它们不能直接通过 `localhost` 互相访问。 不要把 Vikunja 地址写成： ```text http://localhost:3456 ``` 在小龙猫中，`localhost` 指的是小龙猫自己的容器，不是 Vikunja 容器。 让小龙猫用这个地址访问 Vikunja： ```text http://host.lzcapp:3456 ``` 这是懒猫微服应用容器之间的访问地址。 ## 4. 配置 Vikunja 端口转发 目标地址： ```text http://host.lzcapp:3456 ``` 在懒猫微服的端口转发工具中新增规则：  1. 协议选择 TCP。 2. 局域网入口类型选择微服虚拟网卡。 3. 出口地址选择 `host.lzcapp`。 4. 端口填写 `3456`。  5. 转发目标类型选择微服应用。 6. 微服应用选择当前安装的 Vikunja 应用。 7. 服务选择 Vikunja 服务。 8. 目标端口填写 `3456`。  9. 点击测试目标连接。  10. 测试成功后保存规则。  注意： - 转发目标是 Vikunja，不是小龙猫。 - 小龙猫访问地址使用 `http://host.lzcapp:3456`，不要使用 `localhost` 或 `127.0.0.1`。 ## 5. 获取 Vikunja API Token 小龙猫操作 Vikunja 需要 API Token。 打开 Vikunja，进入：  ```text Settings > API Tokens ```  创建新 token： 1. 名称填写 `totoro-assistant`。 2. 权限选择项目和任务相关的读写权限。   3. 创建后立即复制 token。 4. 临时保存到安全位置，稍后写入小龙猫技能配置。  注意：API Token 只会完整显示一次。不要把它发到公开文章、截图、群聊或不可信的地方。 ## 6. 获取 Vikunja 的 JSON 文件 小龙猫需要 OpenAPI JSON 文件来调用 Vikunja API。 不要在外部浏览器访问 `http://host.lzcapp:3456` 下载文件。这个地址给小龙猫在容器内部访问 Vikunja 用，外部浏览器通常打不开。 从 Vikunja 页面下载： 1. 打开 Vikunja。 2. 进入 `Settings > API Tokens`。 3. 在 API Tokens 页面点击 `View API documentation`。  4. 页面打开后，在顶部找到下载按钮。  5. 点击下载按钮，保存 JSON 文件。  6. 如果文件名不是 `docs.json`，重命名为： ```text docs.json ``` 下一步把这个 JSON 文件发给小龙猫。 ## 7. 让小龙猫操作 Vikunja 把 `docs.json` 发给小龙猫，让它生成 Vikunja 技能。 ### 7.1 发送 OpenAPI 文件 把 `docs.json` 发给小龙猫，然后说： ```text 这是 Vikunja 的 docs.json。请根据这个 OpenAPI 描述，为我编写一个技能，用来调用 Vikunja API。 ```   ### 7.2 保存 Vikunja 地址和 API Token 技能生成后，把连接信息保存到技能配置中。对小龙猫说： ```text 请把我的 Vikunja 地址保存到技能配置中： http://host.lzcapp:3456 请把我的 Vikunja API Token 保存到技能配置中： 【这里填写你的 API Token】 ```  不要把 API Token 公开到博客、截图、群聊或不可信的聊天记录中。 ### 7.3 设置 GTD 规则 连接信息保存后，把下面规则发给小龙猫： ```text 以后你帮我管理 Vikunja 任务时，请按下面规则处理： 1. 没想清楚、只是临时记录的事情，先放入“收件箱”。 2. 需要多个步骤完成的事情，放入“项目”。 3. 已经明确可以执行的具体动作，放入“下一步”。 4. 需要等待别人回复或处理的事情，放入“等待中”。 5. 现在不做、以后可能做的事情，放入“将来可能”。 6. 如果我说的任务太模糊，请先改写成清楚的下一步动作。 7. 如果你不确定应该放哪里，先放入“收件箱”。 ```  ## 8. 让小龙猫初始化 GTD 项目 不要手工打开 Vikunja 创建项目，直接让小龙猫初始化。 对小龙猫说： ```text 请帮我初始化 Vikunja 的 GTD 项目。 请检查 Vikunja 里是否已经存在下面 5 个项目： 1. 收件箱 2. 项目 3. 下一步 4. 等待中 5. 将来可能 如果某个项目已经存在，不要重复创建。 如果某个项目不存在，请帮我创建。 创建完成后，请列出最终存在的这 5 个项目，并告诉我哪些是新创建的，哪些是原来已有的。 ```  第一版先保持简单，不急着添加标签、筛选器或复杂规则。 使用规则： - 新想法先进“收件箱”。 - 多步任务放进“项目”。 - 能直接执行的任务放进“下一步”。 - 卡在别人那里的任务放进“等待中”。 - 暂时不做的想法放进“将来可能”。 ## 9. 测试连接 用下面 3 个动作测试。 ### 9.1 查询项目 对小龙猫说： ```text 帮我查看 Vikunja 里有哪些项目。 ```  正常情况下会看到： ```text 收件箱 项目 下一步 等待中 将来可能 ``` ### 9.2 创建测试任务 继续对小龙猫说： ```text 帮我在“收件箱”里创建一个测试任务：测试小龙猫连接 Vikunja。 ``` 创建完成后，打开 Vikunja 确认任务是否出现。 ### 9.3 更新测试任务 再对小龙猫说： ```text 把刚才那个测试任务标记为完成。 ``` 如果 Vikunja 中的任务状态已更新，连接正常。 ## 10. 日常用法 把小龙猫当作任务入口。 ### 10.1 随手记录 ```text 帮我记一下：周末整理书桌。 ``` ```text 我想到一个事，以后可以研究一下家庭照片自动备份。 ``` <!-- 配图占位：图 10-1，随手记录任务的聊天示例。 --> ### 10.2 整理收件箱 ```text 帮我整理一下收件箱里的任务，把它们分到合适的项目。 ``` ```text 看看收件箱里有没有可以变成下一步的任务。 ``` ### 10.3 查看下一步 ```text 我今天应该先做哪些下一步任务？ ``` ```text 帮我列出所有还没完成的下一步。 ``` ### 10.4 管理项目 ```text 帮我看看“整理家庭资料”这个项目下一步是什么。 ``` ```text 这个任务太大了，帮我拆成几个步骤再写入 Vikunja。 ``` ### 10.5 跟进等待中任务 ```text 帮我看看有哪些任务还在等待别人回复。 ``` ```text 把“等张三确认合同”标记到等待中。 ``` ## 11. 完整示例 你对小龙猫说： ```text 我想把家里的纸质资料整理成电子版。 ``` 小龙猫会这样处理： 1. 判断这是一个多步任务。 2. 在 Vikunja 的“项目”中创建任务：把家里的纸质资料整理成电子版。 3. 拆出下一步：找出第一批需要扫描的纸质资料。 4. 把这个下一步写入“下一步”。 5. 如果需要家人提供资料，创建一条“等待中”任务。 之后问： ```text 资料整理这个项目下一步是什么？ ``` 重点：大项目不直接执行，先拆成明确的下一步。 ## 12. 常见问题 ### 12.1 为什么不能用 `localhost` 小龙猫和 Vikunja 是两个不同的应用容器。小龙猫中的 `localhost` 指向小龙猫自己的容器，不是 Vikunja 容器。 使用端口转发后的地址： ```text http://host.lzcapp:3456 ``` ### 12.2 小龙猫访问不了 Vikunja 怎么办 按顺序检查： 1. Vikunja 是否已启动。 2. 端口转发规则是否已保存并启用。 3. 地址是否为 `http://host.lzcapp:3456`。 4. API Token 是否正确。 5. `docs.json` 是否已发给小龙猫。 6. Vikunja 技能是否已生成并启用。 ### 12.3 下载不到 JSON 文件怎么办 回到 Vikunja 页面操作，不要在外部浏览器访问 `http://host.lzcapp:3456/api/v1/docs.json`。 按顺序检查： 1. Vikunja 是否能正常打开。 2. 是否已经进入 `Settings > API Tokens`。 3. 是否点击了 API Tokens 页面里的 `View API documentation`。 4. API 文档页面顶部是否有下载按钮。 5. 下载后的文件是否是 JSON 文件。 如果 API 文档页面本身打不开，先确认 Vikunja 已启动并重新登录 Vikunja。 ### 12.4 任务被放错项目怎么办 直接让小龙猫修改： ```text 把刚才那个任务从“收件箱”移动到“下一步”。 ``` 或者： ```text 这个任务不是项目，它只是一个下一步动作，帮我改一下。 ``` 分类不准时，直接让小龙猫修改。 ### 12.5 要不要一开始就用标签和复杂筛选 不建议。 第一版先用项目承载 GTD 结构。用稳定后，再考虑标签、优先级、截止日期和筛选器。 ## 13. 最后确认 完成下面检查项，表示配置成功： 1. 小龙猫可以通过 `http://host.lzcapp:3456` 访问 Vikunja。 2. Vikunja 中已创建 API Token。 3. 已获取 Vikunja 的 `docs.json`。 4. 小龙猫已生成 Vikunja 技能。 5. 技能已保存 Vikunja 地址和 API Token。 6. 小龙猫已在 Vikunja 中初始化“收件箱、项目、下一步、等待中、将来可能”。 7. 小龙猫可以创建、查询和更新 Vikunja 任务。 前期只关注两件事： - 所有想到的任务，都有一个可靠入口。 - 所有真正要做的事情，都能变成清楚的下一步。