OpenClaw gifgrep 技能详解搜索 Tenor/Giphy、TUI 预览与 GIF 静帧/分帧表提取的完整工作流【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclawOpenClaw 内置的gifgrep技能skills/gifgrep/SKILL.md教 Agent 如何使用gifgrepCLI 完成「搜索 → 预览 → 下载 → 提取静帧/分帧表」的 GIF 获取全流程覆盖 Tenor/Giphy 双数据源、JSON 管道输出和 GIF 素材合规检查。读完本文你可以掌握该技能的全部命令与参数、在 OpenClaw 技能系统中的加载/门控机制以及如何把 GIF 安全地落到本地素材库中。技能定位与整体工作流gifgrep是一个 GIF 搜索 CLI/TUI 工具。技能文档将其定位为GIF-Grab 工作流Search → preview → download → extractstill/sheet用于快速评审与分享。四步拆解Search按关键词查询 GIF 供应商Tenor/Giphy支持文本列表或 JSON 输出Preview进入 TUI 交互式浏览或在终端中渲染静态缩略帧Download把选中的 GIF 下载到本地~/DownloadsExtract从 GIF 中抽取单张静帧still或多帧网格图sheet便于文档、PR、聊天场景中的快速评审。这个技能的载体是标准的 OpenClaw 技能目录目录下含一个带 YAML frontmatter 的SKILL.md。OpenClaw 从多个来源加载技能按优先级过滤具体加载顺序工作区技能 项目 Agent 技能 个人技能 托管技能 内置技能 额外目录见 docs/tools/skills.md 的 Loading order 一节。frontmatter二进制门控与安装声明skills/gifgrep/SKILL.md 的 frontmatter 是理解该技能如何在 OpenClaw 中被启用的关键--- name: gifgrep description: Search GIF providers with CLI/TUI, download results, and extract stills/sheets. metadata: openclaw: emoji: requires: bins: [gifgrep] install: - id: brew kind: brew formula: steipete/tap/gifgrep bins: [gifgrep] label: Install gifgrep (brew) - id: go kind: go module: github.com/steipete/gifgrep/cmd/gifgreplatest bins: [gifgrep] label: Install gifgrep (go) ---各字段的作用name: gifgrep技能名与斜杠命令来源无name时回退为目录名见 docs/tools/skills.mdrequires.bins: [gifgrep]声明运行该技能必需的可执行文件。OpenClaw 在加载技能时检查二进制是否存在缺失则把该技能过滤掉——从源码看src/shared/requirements.ts 中的missingBins逻辑正是执行这一检查它读取metadata.requires.bins过滤掉未安装的二进制名只有缺失列表为空时技能才视为就绪install声明两条安装路径供用户在二进制缺失时按需安装——Homebrewbrew install steipete/tap/gifgreptap 配方steipete/tap/gifgrepGo 工具链go install github.com/steipete/gifgrep/cmd/gifgreplatest安装为gifgrep二进制。也就是说该技能不会在gifgrep未安装的机器上对 Agent 暴露避免了文档里会调用、但终端里命令不存在的失配状态。快速上手五种常用命令技能文档给出的 Quick start 覆盖了该工具最核心的用法全部原样继承并补充说明# 1. 搜索并限制结果数量前 5 只猫 GIF gifgrep cats --max 5 # 2. 管道友好的字段输出只取 URL前 5 条 gifgrep cats --format url | head -n 5 # 3. JSON 输出 jq 提取第一个结果的 URL gifgrep search --json cats | jq .[0].url # 4. 进入交互式 TUI 浏览引号内为查询词 gifgrep tui office handshake # 5. 搜索、下载第一条结果并以 url 格式输出下载信息 gifgrep cats --download --max 1 --format url参数速览参数作用位置参数 /search搜索关键词gifgrep cats与gifgrep search cats等价--max N限制返回结果数量--json以 JSON 数组输出结果--format field仅输出指定字段如url便于管道处理--download下载结果到本地tui query子命令进入交互式浏览界面TUI 浏览与终端静态预览TUI 模式gifgrep tui query进入交互式界面适合在多张候选 GIF 中翻选CLI 静态缩略预览追加--thumbs可以在终端内直接渲染 GIF 的静态帧——文档明确注明该能力仅限 Kitty/Ghostty 终端二者支持图像协议且渲染的是静帧而非动画。这一设计取舍值得注意--thumbs是为图像协议终端准备的增强项在普通终端上应回退到纯文本列表 URL 输出的方式。下载与 Finder 揭示--download将搜索结果保存至~/Downloads--reveal在 Finder 中定位并显示最近一次下载的文件macOS 场景。组合使用--max 1 --format url --download可以得到搜索 → 取第一 → 落盘 → 回显 URL的自动化链路适合脚本化抓取单个 GIF。静帧提取与分帧表still / sheet这是gifgrep区别于普通 GIF 下载器的部分也是技能文档重点强调的快速评审能力# 抽取 1.5 秒处的单帧为 PNG gifgrep still ./clip.gif --at 1.5s -o still.png # 均匀采样 9 帧排成 3 列网格输出单张 PNG gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.pngstill按时间戳--at支持1.5s这类秒级写法抽取指定时刻的帧sheet从整段 GIF 中采样多帧拼成单张 PNG 网格图——文档评价其为 great for quick review, docs, PRs, chat适合快速评审、文档、PR、聊天可调参数--frames采样帧数、--cols网格列宽、--padding帧间距。典型场景拿到一段录屏 GIF 后用sheet生成九宫格总览图贴进 PR 描述或把关键帧抽成still.png放进设计文档避免在聊天工具里反复播放动画。数据源Providers与 API Key配置说明--source auto自动选择数据源默认策略--source tenor强制使用 TenorTENOR_API_KEY可选未设置时使用 Tenor 的 demo key--source giphy强制使用 Giphy必须提供GIPHY_API_KEY即 Tenor 开箱即用demo key 兜底Giphy 需要自备 API Key 才能启用。JSON 输出字段与管道集成--json输出的结果数组中每个元素包含以下字段id、title、url、preview_url、tags、width、height配合--format可只输出单一字段二者组合使gifgrep能无缝嵌入 shell 管道如jq .[0].url、head -n 5。对 Agent 而言url/preview_url/ 尺寸字段正是判断这张 GIF 是否满足需求所需的最小信息集。GIF 素材卫生规范Asset Hygiene技能文档专门设了一节GIF asset hygiene这是面向 Agent 的行为约束要求在实际引用动图资源前执行三道校验可达性确认 URL 能成功解析可请求成功类型正确响应Content-Type必须为image/gif确实为动画确认含多帧或循环元数据——文档建议用file、identifyImageMagick或一个小脚本来检查帧数。另外两条使用纪律记录出处与素材一起记录署名attribution/ 许可license/ 来源 URL禁止热链需要本地素材时不要直接热链远程 URL应下载/拷贝进项目并引用本地文件。这套规范保证 Agent 产出的文档或消息中引用的 GIF 不会因远程失效、类型错配或版权缺失而出问题。环境变量调节两个环境变量用于微调渲染行为变量作用GIFGREP_SOFTWARE_ANIM1强制使用软件动画渲染不依赖硬件加速路径GIFGREP_CELL_ASPECT0.5调整终端预览的单元格纵横比几何这两项主要服务于 TUI/终端预览在不同显卡、字体度量下的显示一致性属于进阶调节项。小结该技能在 OpenClaw 技能体系中的位置gifgrep是 OpenClaw 内置技能库中的一个典型外部二进制驱动型技能SKILL.md用 frontmatter 声明二进制依赖与安装方式brew / go 双通道由 src/shared/requirements.ts 的门控逻辑保证技能仅在依赖就绪时暴露给 Agent正文则给出搜索、TUI 预览、下载、静帧/分帧表提取的完整命令集、双供应商 API Key 策略、JSON 管道字段和一套素材卫生检查清单。若要编写类似的自定义技能可参考 docs/tools/creating-skills.md 与 docs/tools/skills.md 中的加载优先级与门控说明。【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考