名称： grab
描述： 从 URL（推文、X 文章、Reddit、YouTube）下载并归档内容。将媒体、文本、转录稿和 AI 摘要保存到组织有序的文件夹中。
主页： https://github.com/jamesalmeida/grab
when: "用户分享一个 URL 并希望下载/保存/抓取它，或要求下载推文视频、YouTube 视频、Reddit 帖子或任何来自 URL 的媒体时"
examples:
- "grab this https://x.com/..."
- "download this tweet"
- "save this video"
- "grab https://youtube.com/..."
- "grab this reddit post"
标签：
- download
- media
- twitter
- youtube
- reddit
- transcript
- archive
元数据： { "openclaw": { "emoji": "🫳", "requires": { "bins": ["yt-dlp", "ffmpeg", "whisper"] }, "install": [{ "id": "yt-dlp", "kind": "brew", "formula": "yt-dlp", "bins": ["yt-dlp"], "label": "安装 yt-dlp (brew)" }, { "id": "ffmpeg", "kind": "brew", "formula": "ffmpeg", "bins": ["ffmpeg"], "label": "安装 ffmpeg (brew)" }, { "id": "openai-whisper", "kind": "brew", "formula": "openai-whisper", "bins": ["whisper"], "label": "安装 Whisper (brew)" }] } }

grab 🫳

从 URL 下载内容并归档到组织有序的文件夹中。

安装设置

依赖项

brew install yt-dlp ffmpeg openai-whisper

保存位置

首次运行时，grab 会询问文件保存位置（默认：~/Dropbox/ClawdBox/）。
配置保存在 ~/.config/grab/config 中。可随时通过 grab --config 重新配置。

转录（本地 Whisper）

转录通过本地 Whisper（turbo 模型）运行——无需 API 密钥或网络调用。

AI 摘要与智能标题（可选）

设置 OPENAI_API_KEY 环境变量以启用：
- 内容的 AI 生成摘要
- 智能描述性文件夹名称（基于转录稿/图像分析）

不设置该变量，所有功能仍可正常工作——只是不会生成摘要或自动重命名的文件夹。

功能说明

推文（x.com / twitter.com）

• tweet.txt — 推文文本、作者、日期、互动数据
• video.mp4 — 附带的视频（如有）
• image_01.jpg 等 — 附带的图片（如有）
• transcript.txt — 视频自动转录稿（如有视频）
• summary.txt — 视频的 AI 摘要（如有视频）
• 文件夹根据内容描述命名

X 文章

• article.txt — 包含标题、作者、日期的完整文章文本
• summary.txt — 文章的 AI 摘要
• 通过 OpenClaw 浏览器快照处理
• 检测到文章时，脚本以退出码 2 和 ARTICLE_DETECTED:<id>:<url> 退出

Reddit

• post.txt — 标题、作者、子版块、评分、日期、正文
• comments.txt — 热门评论及其作者和评分
• image_01.jpg 等 — 附带的图片或图库（如有）
• video.mp4 — 附带的视频（如有）
• transcript.txt — 视频自动转录稿（如有视频）
• summary.txt — 帖子及讨论的 AI 摘要
• 如果 Reddit JSON API 被阻止（退出码 3），代理将使用 OpenClaw 浏览器

YouTube

• video.mp4 — 视频文件
• description.txt — 视频描述
• thumbnail.jpg — 视频缩略图
• transcript.txt — 音频转录稿
• summary.txt — AI 摘要

输出结构

下载内容按类型组织：

<保存目录>/
  XPosts/
    2026-02-03_拥抱变化-你可以塑造你的生活/
      tweet.txt, video.mp4, transcript.txt, summary.txt
  XArticles/
    2026-01-20_北极烟雾弹/
      article.txt, summary.txt
  Youtube/
    2026-02-03_如何构建一个AI代理/
      video.mp4, description.txt, thumbnail.jpg, transcript.txt, summary.txt
  Reddit/
    2026-02-03_也许-也许-也许/
      post.txt, comments.txt, video.mp4, summary.txt

使用方法

grab <url>              # 下载并归档一个 URL
grab --config           # 重新配置保存目录
grab --help             # 显示帮助信息

系统要求

brew install yt-dlp ffmpeg openai-whisper

转录使用本地 Whisper——无需 API 密钥。
OPENAI_API_KEY 环境变量为可选——启用 AI 摘要和智能文件夹标题。
不设置该变量，媒体下载和转录功能仍可正常工作。