小龙猫调用“微信ClawBot万能视频下载器”（小龙猫篇 · 使用教程）

# 把 微信ClawBot万能视频下载器 接入懒猫小龙猫（小龙猫篇 · 使用教程）--不用二选一「我全都要」 > 以前绑定“微信ClawBot万能视频下载器”应用的ClawBot帮你下视频又用不了“小龙猫”。现在有更省心的办法：**把“微信ClawBot万能视频下载器”的「下载技能」接入懒猫自带的 AI 助手「小龙猫」**。只要在小龙猫里启用这个技能，以后对它说一句"下这个视频"，它就替你下好，直接把视频文件发给你。 --- https://appstore.lazycat.cloud/#/shop/detail/wx.clawbot.lazycat.app.mediasaber https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.totoro ## 一、这有什么不一样？ | | 老办法 | **新办法（接入小龙猫）** | |---|---|---| | 下视频要绑什么 | 把 ClawBot 绑定“微信ClawBot万能视频下载器”用不了小龙猫 | **只要绑定/启用小龙猫** | | 共用 | 没法和小龙猫共用 | **只需要小龙猫** | | 怎么下视频 | 把链接发给微信机器人 | 把链接发给小龙猫，它调用技能替你下 | | 更强大的功能 | 发回ClawBot | 可以让小龙猫音视频分离 | --- ## 二、第一次用：启用技能（只需一次） 第一次下视频，要先在小龙猫里把 ClawBot 的下载技能"启用"一下。**这个动作只做一次**，以后就不用管了。 ### 第一步：打开小龙猫 在懒猫微服桌面找到**小龙猫**，打开它的对话界面。 >  ### 第二步：启用“微信ClawBot万能视频下载器”的下载技能 在小龙猫里找到（微信ClawBot 万能视频下载器）这个应用的**技能**，把它**启用 / 添加**。 >  启用后，小龙猫就能指挥 ClawBot 帮你下视频了。 --- ## 三、怎么下视频？两步 技能启用好后，每次下视频就两步： ### 第一步：把视频链接发给小龙猫 把你要下的视频链接发给小龙猫，或者直接说一句，比如： - "帮我下载 https://……" - "下个视频 https://……" 支持的链接跟以前一样：抖音、小红书、B 站、YouTube、微博、快手、X（推特）、Instagram、头条等都行。 #### 小龙猫演示 >  #### 手机上效果 >  就这么简单。**发链接 → 等 → 收视频。** 还有彩蛋，各位探索一下吧

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

传统 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 下载 - 资源是否有有效的做种者  当确认电影下载完成后，您可以指挥小龙猫将文件存放到网盘中的指定目录。例如，这里让它存放在“电影”目录下。   至此，小龙猫已完整完成**搜索 → 下载 → 保存到指定位置**的全过程。您只需打开网盘，即可畅享观影。 

让应用体验升级，打通网盘右键、MCP、SKILL，彻底融入懒猫微服

懒猫微服的好处不言而喻——万物互联，不过目前官方提供的好玩的功能还比较有限。不过，微服的好底子让我们有了可以发挥自己想法的机会。本文将介绍如何将应用融入到懒猫微服中，并且打通网盘的右键、MCP、SKILL等功能。 > 项目中以ZOCR项目为例，ZOCR是一个开源的OCR识别工具，支持多种语言的文字识别。 > 通过将ZOCR融入懒猫微服，我们可以实现对网盘图片的OCR识别功能，在小龙猫中使用技能对网络图片或本地图片进行OCR识别，补足部分模型不支持图片文字识别的不足。 > 也可以通过编程接口对图片进行识别，或者将MCP工具接入到其他AI应用中进行使用。 ## 相关应用 https://appstore.lazycat.cloud/#/shop/detail/com.aweoo.lazycat.helloxz.zocr https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.totoro ## 效果演示 ZOCR登陆后使用  ZOCR未登陆使用  网盘右键菜单打开  使用技能对懒猫网盘图片进行OCR识别   ## 接入懒猫网盘文件拦截器 如果不能选择懒猫网盘中的文件，那无疑这个应用的使用体验将大打折扣。官方提供了[专题——自动拦截文件选择器](https://developer.lazycat.cloud/lazycat-file-picker-auto-intercept.html)提供了很大的帮助，直接按照文档接入，接口实现对应的功能。 ```yml # lzc-manifest.yml application: injects: - id: open-save-chooser on: browser when: - / do: # /lzcapp/pkg/content/ 是lzc-build.yml中配置的contentdir目录下的需要打包的内容，需要将文档中提供的脚本下载到本地需要打包的目录中，并修正对应的地址。 - src: file:///lzcapp/pkg/content/lazycat-injects/lzc-file-chooser-inject.js ``` ## 打通网盘右键菜单 既然我们需要选择到懒猫网盘的文件，那么如果能在网盘中使用右键菜单打开的话，体验岂不是更好。 于是，我们看到了刚才接入懒猫网盘拦截器中我们“漏掉”的一部分代码。 ```yml # lzc-manifest.yml application: file_handler: mime: - image/jpeg - image/png - image/bmp - image/webp actions: open: /?filename=/%u # %u是懒猫网盘给过来的文件的路径。 ``` 那么，这个是怎么工作的呢。让我们先部署一下，然后在懒猫网盘中选择一个文件，就拿`测试文件夹`下面的`DDNS.png`举例好了。当我们依次使用右键->在线应用打开->ZOCR点击后会发现客户端帮我们打开了选择应用，并且在应用日志中我们可以看到，有一个特殊的请求日志。 ```bash # 日志中出现的请求信息 /?filename=/%E6%B5%8B%E8%AF%95%E6%96%87%E4%BB%B6%E5%A4%B9%2FDDNS.png # 让我们使用URL解码工具解码一下 /?filename=/测试文件夹/DDNS.png ``` 原来，懒猫微服会将应用打开，并且将我们选择的文件`/测试文件夹/DDNS.png`通过我们配置的回调路径`/?filename=/%u`传递过来，并跳转到对应的页面。 不过问题来了，我们虽然拿到了对应的路径，但是我们需要怎么拿到这个文件呢。 这个时候我们就又需要刚才的懒猫网盘拦截器出场了。通过研究发现，懒猫网盘提供了一个超级API，所有应用地址的 `/_lzc/files/home/` 路径都可以访问到自己的网盘文件（当然是在登录状态下），而懒猫网盘拦截器就是利用了这点实现的。那么我们就可以照葫芦画瓢，也写一个直接获取文件并赋值的。 ```javascript // lazycat-injects/auto-select-file-and-submit-inject.js const DISK_ROOT = '/_lzc/files/home'; const encodePath = (path) => String(path).split('/').map(encodeURIComponent).join('/'); const basename = (path) => String(path).split('/').filter(Boolean).pop() || 'file'; const waitFor = (fn, timeout = 5000) => new Promise((resolve, reject) => { const start = Date.now(); const timer = setInterval(() => { const value = fn(); if (value) { clearInterval(timer); resolve(value); } else if (Date.now() - start > timeout) { clearInterval(timer); reject(new Error('file input not found')); } }, 100); }); const run = async () => { console.debug('try to get filename'); const params = new URLSearchParams(window.location.search); const targetFilename = params.get('filename'); if (!targetFilename) return; console.debug('get filename:', targetFilename); if (window.__autoFilled) return; window.__autoFilled = true; try { const fileInput = await waitFor(() => // 这里获取上传的input元素 document.querySelector('#fileInput') ); const response = await fetch(`${DISK_ROOT}${encodePath(targetFilename)}`); if (!response.ok) { throw new Error(`fetch file failed: ${response.status}`); } const blob = await response.blob(); const file = new File([blob], basename(targetFilename), { type: blob.type || 'application/octet-stream', lastModified: Date.now(), }); const dataTransfer = new DataTransfer(); dataTransfer.items.add(file); fileInput.files = dataTransfer.files; fileInput.dispatchEvent(new Event('input', { bubbles: true })); fileInput.dispatchEvent(new Event('change', { bubbles: true })); console.debug('select file finish.'); // 这里点击提交按钮 const submitBtn = document.querySelector('#submitBtn'); if (submitBtn) { setTimeout(() => submitBtn.click(), 100); } console.debug('submit finish.'); } catch (error) { console.error('auto select file failed:', error); window.__autoFilled = false; } }; // 这里判断页面加载完成后才执行 if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', run); } else { run(); } ``` ```yml application: injects: - id: auto-select-file-and-submit on: browser # 在真实浏览器环境执行，操作页面DOM when: - /?filename # 匹配根路径，且URL带filename查询参数（值任意） do: - src: file:///lzcapp/pkg/content/lazycat-injects/auto-select-file-and-submit-inject.js ``` 好，让我们重新部署，再次尝试使用ZOCR打开懒猫网盘中的文件，可以看到已经能自动识别我们选择好的图片了。 但是，懒猫网盘拦截器已经实现了获取文件的功能，我们为什么不直接复用呢。让我们改造一下官方提供的代码，增加一个接口让我们能直接调用原生的能力。 ```javascript // lazycat-injects/lzc-file-chooser-inject.js /* ...... 此处省略了其他代码 */ // 此处为原先的代码 const installDownloadAnchorHooks = () => { if (HTMLAnchorElement.prototype.click.__lzcHooked) { return; } const hookedClick = function () { if (isDownloadAnchor(this)) { if (shouldUseNativeDownloadAnchor(this)) { return STATE.hooks.originalAnchorClick.call(this); } interceptDownloadAnchorSilently(this); return; } return STATE.hooks.originalAnchorClick.call(this); }; hookedClick.__lzcHooked = true; HTMLAnchorElement.prototype.click = hookedClick; }; // 新增：导出方法 const selectLazyCatInputFile = async (input, path) => { const target = typeof input === "string" ? document.querySelector(input) : input; if (!(target instanceof HTMLInputElement) || target.type !== "file") { throw new Error("LazyCat selectInputFile needs a file input."); } target.files = await createInputFiles([{ filename: path }], target); target.dispatchEvent(new Event("input", { bubbles: true })); target.dispatchEvent(new Event("change", { bubbles: true })); return target.files; }; // 新增：挂载到window对象上 window.lzcFileChooser = { ...(window.lzcFileChooser || {}), selectInputFile: selectLazyCatInputFile, }; // 此处为原先的代码 installFilePickerHooks(); installFileInputHooks(); installDownloadAnchorHooks(); ``` 这样就可以最大程度的精简代码了。 ```javascript // lazycat-injects/auto-select-file-and-submit-inject.js const run = async () => { console.debug('src try to get filename') const targetFilename = new URLSearchParams(location.search).get('filename'); if (!targetFilename || window.__autoFilled) return; window.__autoFilled = true; // 调用懒猫网盘拦截器导出的方法，将对应的文件绑定到input元素上 await window.lzcFileChooser.selectInputFile('#fileInput', targetFilename); setTimeout(() => { // 点击提交按钮 document.querySelector('#submitBtn')?.click(); }, 100); }; if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', run); } else { run(); } ``` 让我们重新部署试一下，发现依旧能正确自动处理选好的图片。那么，我们就成功接入网盘右键菜单功能啦。 ## 制作MCP 那么，既然已经是万物互联时代了，我们的AI大总管——小龙猫怎么能不接入呢。让我们先做一个通用的MCP服务，这样技能只需要让智能体调用对应的MCP服务就好了。 > 至于为什么不直接写脚本，然后让skill来调用。是因为不一定所有的智能体都支持skill，也有一部分只支持MCP。 本来是打算直接fork改代码的，但是既然作者没搞，我也不方便直接动手（如果PR没合并，后期更新就比较麻烦）。 加上目前的接口比较简单，所以我打算直接写一个中转MCP服务。再利用[进阶主题——路由规则](https://developer.lazycat.cloud/advanced-route.html)，我们就很容易让MCP服务正常跑起来，且不干扰主程序。 ```yml # lzc-manifest.yml application: routes: - /=http://zocr:5080/ upstreams: - location: /mcp # mcp入口地址 disable_trim_location: true # 转发时不去掉location backend: http://127.0.0.1:8080 # string 上游的地址，需要是一个合法的url，支持http,https,file三个协议 use_backend_host: false # 访问上游时http host header使用backend中的host，而非浏览器请求时的host backend_launch_command: ZOCR_API_URL=http://zocr:5080 ZOCR_TOKEN={{ index .UserParams "zocr.token" }} /lzcapp/pkg/content/mcp-server/mcp-server # string 自动启动此字段里的程序 ``` 不过有个小插曲，由于MCP并不支持文件传输了，所以图片内容需要进行base64后再通过MCP进行识别。 但是这里有个坑，大模型的记忆并不可靠，这也就导致我最初测试的十几次都是错误的base64信息，然后程序会解析图片失败，并且反响解码后的图片也不是原图。所以，需要文件传输的接口还是要单独设计，然后在MCP中明确该接口的用法即可。 当然，最后不要忘记导出你的MCP，不然小龙猫可是不会给你干活的哦。 ```yml # lzc-build.yml resource_exports: - kind: mcp-providers source: ./resources/mcp-providers/ ``` ## 制作SKILL skill的话，懂得都懂，直接按照MCP或者接口的使用方式写如何使用就行了，但是不要忘记在配置中增加技能导出。 ```yml # lzc-build.yml resource_exports: - kind: skills source: ./resources/skills/ ``` Q：那么让我们部署测试一下吧，但是为什么这么不稳定呢，好想http接口找不到对应的地址，就算找到也会失败。 A：这是因为[进阶主题——应用间访问](https://developer.lazycat.cloud/advanced-app-interconnect.html)中有提到，与其他应用访问时，可以使用内部接口`app.<target-pkg-id>.lzcx`，但是需要请求时在`header`中增加`X-HC-USER-TICKET`鉴权。 Q：但是小龙猫哪里知道这些，我岂不是要写很麻烦的说明文档吗，况且我也拿不到这个凭据啊。 A：不要着急，小龙猫设计的时候就已经规划好了，在`懒猫网盘: 全部文件/应用文稿/小龙猫/{你的龙猫}/当前记忆/workspace/TOOLS.md`中已经写好了，如果要访问懒猫应用地址是，可以增加对应的代理。而我们只需要在技能中明确说明，这个额外的HTTP接口你也要使用这个代理就可以啦。 当然这里说的比较泛一点，有不明白的小伙伴可以去我移植的ZOCR项目中查看我写的技能提示词，或者让你的小龙猫看一下其他技能中是否有出现过类似的提示词，并让它给你生成一个新的，接着就是反复部署，开新的回话进行测试调整。 ## 知识点巩固 1. 文件夹和权限(系统版本V1.6.0) | 文件夹 | 对应权限 | 功能 | 发展 | |:-|:-|:-|:-| | /lzcapp/var | 自动挂载 | 存储应用数据，卸载时可选删除，在懒猫网盘/应用数据中查看 | - | | /lzcapp/cache | 自动挂载 | 应用缓存目录，不重要可随时清理的内容，目前直接在网盘中查看 | - | | /lzcapp/run/mnt/home | 自动挂载 | **被废弃的**用户文稿目录 | V1.7.0后需要管理员明确授权 **尽量不要使用** | | /lzcapp/document | document.read/document.write | 新的用户文稿目录 | V1.7.0后正式上线 | | /lzcapp/documents | document.private | 应用文稿根目录，可在懒猫网盘/全部文件/应用文稿中查看 | 推荐使用，应用卸载后默认不会删除 | 其他参考：[最佳实践——文件访问](https://developer.lazycat.cloud/advanced-file.html) 2. 路由权限和访问 - 同一个应用不同的服务访问使用域名`$service_name.$appid.lzcapp`，详见[进阶主题——路由规则](https://developer.lazycat.cloud/advanced-route.html#http%E4%B8%8A%E6%B8%B8) - 不同应用间访问使用域名`app.<target-pkg-id>.lzcx`，并需要`X-HC-USER-TICKET`鉴权，详见[进阶主题——应用间访问](https://developer.lazycat.cloud/advanced-app-interconnect.html) - 无需登陆微服即可访问服务，适用于服务器上内网穿透公开服务（不建议），详见[进阶主题——独立鉴权](https://developer.lazycat.cloud/advanced-public-api.html) - 登陆状态下才能使用懒猫网盘拦截器，详见[进阶主题——脚本注入](https://developer.lazycat.cloud/advanced-injects.html) ## 最后说两句 看似简单的功能，但其实设计的知识点还是很多的。尽管目前已经对接了很多，但是还有客户端的部分也可以想办法接入。不过还在现在流程还能跑通，这也多亏了懒猫微服的设计者在背后做了很多的工作。不过随着技术的迭代，新的内容和挑战也一直出现。让我们一起学习，打造属于我们自己的数据中心和“小龙猫”吧。 > 最后多嘴一句，不知道我之前提到的[ActivityPub](https://zh.wikipedia.org/wiki/ActivityPub)宇宙，会不会在工程师的规划之内呢。 ## 参考链接 - [fghwett/helloxz-zocr-lzcapp](https://github.com/fghwett/helloxz-zocr-lzcapp) - [懒猫微服开发者手册](https://developer.lazycat.cloud/) ## 特别鸣谢 - [ZOCR项目](https://github.com/helloxz/zocr) - [懒猫微服应用商店官方支持团队](https://lazycat.cloud/about?navtype=AfterSalesService)

小龙猫 + 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 任务。 前期只关注两件事： - 所有想到的任务，都有一个可靠入口。 - 所有真正要做的事情，都能变成清楚的下一步。

小龙猫使用攻略

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 助手管理页面，可以重启，删除和查看助手的日志  

给你的 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. 助手可以创建任务、拆分子任务、记录进展。 完成以后，你就可以把小龙猫当成自己的任务助理来用了。

小龙猫 + 懒猫电影搜索：一句话让私人影院自动上新

# 小龙猫 + 懒猫电影搜索：一句话让私人影院自动上新 --- ## 一、效果展示 先上最终效果。  > 懒猫影视截图  > 懒猫网盘截图 --- ## 二、一句话体验 小龙猫是跑在懒猫微服上的 AI 助手。你跟它说一句话，它就帮你做完搜片、选片、下载、入库这一整套流程。 ``` "加载懒猫电影搜索技能，帮我下载《星际穿越》4K 版" ``` 就是这么简单。你不用再打开浏览器搜资源、复制 magnet 链接、切到下载器粘贴、等下载完再手动扫库。小龙猫一条龙搞定。 --- ## 三、准备工作 你需要安装三个应用，做一个关键设置。 ### 第 1 步：安装小龙猫 打开懒猫桌面 → 应用商店，搜索 **小龙猫**。 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.totoro 直接点击安装。装好之后打开，按照引导完成助手的初始化配置（**强烈推荐使用DeepSeek V4 Pro模型**）。小龙猫是你和所有懒猫技能之间的"翻译官"，所有指令都发给它。 ### 第 2 步：安装 VueTorrent（种子下载器） 在应用商店搜索 **VueTorrent**。 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.vuetorrent 安装并启动 VueTorrent。默认登录账号：`admin` / `adminadmin`。 ### 第 3 步：安装懒猫电影搜索技能 还是在应用商店，搜索 **懒猫电影搜索**。 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.lazycat-movie-search-skill 点击安装。这是一个"技能"——可以理解为小龙猫的插件，装了它小龙猫才懂怎么搜电影和下电影。 ### 第 4 步：在小龙猫中启用技能 打开小龙猫 → 进入对话界面 → 点击设置或者技能管理入口 → 找到 **技能管理**。 你会看到一个技能列表，找到「懒猫电影搜索」，把开关打开（启用）。   这一步完成之后，小龙猫就装备好电影搜索能力了。 --- ## 四、开始使用：念咒语 ### 第一句咒语 跟你的小龙猫说： ``` 加载懒猫电影技能。 ``` 小龙猫会回复确认技能已加载，这时候电影搜索功能就上线了。 ### 第二句咒语 直接说出你想看的电影： ``` 帮我下载《星际穿越》 ``` 或者更具体一些： ``` 下载《盗梦空间》4K 版 找一下诺兰的《黑暗骑士崛起》 搜豆瓣 Top 250 前 10 部电影 我要看《肖申克的救赎》 ``` 小龙猫收到指令后，会做以下事情： **1. 搜索资源**：自动搜索 YTS 等电影资源站，找到匹配的片源。 **2. 展示搜索结果表格**：如果没指定具体分辨率，小龙猫会列出所有可选的版本，比如：  **3. 你选择，然后确认**： ``` 我要 4K 那个版本。 ``` --- ## 五、进阶技巧 ### 顺序下载 + 边下边播 BT 下载默认是随机下载文件块的，这意味着前几分钟的数据可能散落在文件的不同位置，没法提前开播。 **顺序下载模式**（Sequential Download）会把数据从头到尾按顺序下载。配合播放器的边下边播功能，你只需要等前 2-3% 下载完成，就可以直接打开播放——视频从开头逐段下载，播放器读取已下载的部分流畅播放。后面在后台继续下完剩余的部分。 懒猫电影搜索技能在添加任务时**默认开启**顺序下载模式，你什么都不用操心。 ### 种子热度 搜索结果里会显示 **Seeds / Peers** 数据。种子数（Seeds）越多，下载速度越快。热门新片的种子数动辄几百上千，冷门老片可能只有几个甚至零种子。 - **高种子数（100+）**：几分钟下完一部 4K 电影 - **中等种子数（10-99）**：几个小时能下完 - **零种子**：可能永远下不完（但也有例外，有些种子只是没人做种，但下载者之间可以互相补数据） 如果某部电影种子很少，小龙猫会在搜索结果里告诉你，你可以决定要不要换一部或者等一等。 ### 自动刮削入库 如果你同时装了 **懒猫影视**（或者 Jellyfin / Emby 等刮削器），电影下载完成后它会自动扫描指定目录，匹配海报、简介、演员信息、评分。下好的电影会直接在影视墙中展示出来，打开就能播放。 ### 最高画质优先 懒猫电影搜索会优先展示 4K（2160p）版本。如果你不指定分辨率，小龙猫会让你自己选；如果你明确说了"4K"或"最高画质"，它直接帮你选最好的版本下。 --- ## 六、常见问题 **Q：搜不到我想看的电影怎么办？** A：尝试使用英文片名搜索，或者带上年份。例如搜"Braveheart 1995"比搜"勇敢的心"更准。如果 YTS 上没有，还可以告诉小龙猫"用 IMDb ID 搜"或"去 rarbg 搜一下"。 **Q：为什么下载速度很慢？** A：检查种子数（Seeds）。太冷门的电影种子少，速度自然慢。另一个可能的原因是 VueTorrent 的上传限速没设好——小龙猫添加任务时会自动检查并设置上传限速（128 KiB/s），以免上传占满带宽拖慢下载。 **Q：顺序下载模式下可不可以中途切换成普通模式？** A：可以。在 VueTorrent 的任务列表里找到该任务，右键或点开详情，找到"顺序下载"选项关闭即可。一般没必要切换，顺序下载对大部分播放场景更友好。 **Q：不小心下载了重复的电影怎么办？** A：在 VueTorrent 中停止并删除多余的任务，再到懒猫网盘里删掉对应的文件。懒猫影视下次扫库时会自动清理掉已删除文件的条目。 --- ## 总结 整个流程就三步： 1. 应用商店装：小龙猫 + VueTorrent + 懒猫影视 + 懒猫电影搜索技能 2. 设置 VueTorrent 下载目录到网盘 3. 在小龙猫里启用电影搜索技能，然后跟小龙猫说一句话 之后每次想看新电影，只需打开小龙猫，说一句： ``` 加载懒猫电影技能。 帮我下载《电影名》。 ``` 私人影院自动上新。

个人用户龙虾接入指南：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 截图     

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

### 需求背景：想下载音乐存储在本地，用来听歌或者搭建个人音乐服务器（例如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目录里面，如果另外建立了一个文件夹，可以按照下面方式在懒猫音乐进行歌曲添加   也可以添加远程挂载和外置硬盘 

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模型厂商。