tufty.aitufty.ai CLI

在 Agent 中使用技能

tufty 工具技能:安装、准备与调用方式。

技能把一个工具的触发场景、调用命令、输出格式和错误处理写进一份 SKILL.md,让智能体在合适的时候稳定地调用对应的 tufty 命令,不必每次重新摸索参数。每个工作室工具对应一个技能。

技能清单

技能名称类型对应命令
tufty-pet-dressup宠物换装 Pet Dress-Up图片tufty pet-dressup
tufty-image-to-video图转视频 Image to Video视频tufty image-to-video

每个技能都有英文 SKILL.md 和中文 SKILL-cn.md 两个版本。

获取技能

技能将以发布者 tufty-ai 上架 ClawHub(即将上线)。上线后可在 OpenClaw 中按名称安装,例如:

openclaw skills install tufty-ai/tufty-pet-dressup

在此之前,可以直接使用源码仓库 tufty-ai/tufty-cli 中 skills/ 目录下的技能文件。

使用前准备

  1. 宿主机上有 Node.js 18+ 以及 npm / npx。技能声明的安装命令固定了版本:npm install -g @tufty/cli@1.1.1;也可以用 npx @tufty/cli@1.1.1 <command> 按需运行。
  2. 在宿主机上完成一次认证:运行 tufty login,或设置 TUFTY_API_KEY。技能本身不保存密钥,沿用本机 CLI 的认证。见 认证。

技能声明会访问的域名是 tufty.ai 与 static.tufty.ai,配置文件位于 ~/.tufty/config.json。

技能如何调用 CLI

技能被触发后,智能体按技能里的说明:

  1. 运行 tufty <tool> -h 查看当前参数;
  2. 用户还没确认花费时,先加 --dry-run 预估积分;
  3. 执行命令,从标准输出的 JSON 信封里读取 result.outputs[].url;
  4. 遇到 insufficient_balance 时告诉用户积分不足并给出充值链接;遇到 unauthorized 或 no_api_key 时引导用户获取 API 密钥。

例如,宠物换装技能最终执行的就是一条普通的 CLI 命令:

tufty pet-dressup --product ./sweater.jpg --model ./corgi.jpg --quality medium --ratio 1:1

技能里的帮助文本和价格在生成时取自工具清单,之后价格如有调整,以 tufty tools describe <id> 的输出为准。

On this page