在 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/ 目录下的技能文件。
使用前准备
- 宿主机上有 Node.js 18+ 以及
npm/npx。技能声明的安装命令固定了版本:npm install -g @tufty/cli@1.1.1;也可以用npx @tufty/cli@1.1.1 <command>按需运行。 - 在宿主机上完成一次认证:运行
tufty login,或设置TUFTY_API_KEY。技能本身不保存密钥,沿用本机 CLI 的认证。见 认证。
技能声明会访问的域名是 tufty.ai 与 static.tufty.ai,配置文件位于 ~/.tufty/config.json。
技能如何调用 CLI
技能被触发后,智能体按技能里的说明:
- 运行
tufty <tool> -h查看当前参数; - 用户还没确认花费时,先加
--dry-run预估积分; - 执行命令,从标准输出的 JSON 信封里读取
result.outputs[].url; - 遇到
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> 的输出为准。
