🐦 推特视频下载器

专为中文用户打造的 Twitter/X 视频下载工具。支持下载高清视频、GIF、音频，提供批量下载功能。

⚠️ 中国大陆用户须知

Twitter/X 在中国大陆被封锁，必须使用代理才能下载！

使用前请确保您已开启代理工具（如 Clash、V2RayN、Shadowsocks 等）。

✨ 功能特性

• ✅ 下载 Twitter/X 视频（MP4 格式）
• ✅ 下载 GIF（自动转为 MP4）
• ✅ 提取音频（MP3 格式）
• ✅ 多清晰度支持：360p、480p、720p、1080p、2K、4K、8K
• ✅ 批量下载多个视频
• ✅ 查看视频信息（标题、作者、播放量等）

🚀 使用方法

基础下载（海外用户）

# 下载最佳质量
clawhub run twitter-video-downloader -- "https://x.com/user/status/1234567890"

# 下载指定清晰度
clawhub run twitter-video-downloader -- "URL" --quality 1080

# 仅下载音频 MP3
clawhub run twitter-video-downloader -- "URL" --audio-only

中国大陆用户（必须使用代理）

# 使用 HTTP 代理（Clash 默认端口）
clawhub run twitter-video-downloader -- \
  "https://x.com/user/status/1234567890" \
  --proxy http://127.0.0.1:7890

# 使用 SOCKS5 代理
clawhub run twitter-video-downloader -- \
  "https://x.com/user/status/1234567890" \
  --proxy socks5://127.0.0.1:1080

批量下载

clawhub run twitter-video-downloader -- \
  --proxy http://127.0.0.1:7890 \
  "https://x.com/user1/status/123" \
  "https://x.com/user2/status/456" \
  "https://x.com/user3/status/789"

查看视频信息

clawhub run twitter-video-downloader -- info "https://x.com/user/status/123"

# 带代理
clawhub run twitter-video-downloader -- info "https://x.com/user/status/123" --proxy http://127.0.0.1:7890

🔧 常用代理配置

代理工具	HTTP 代理地址	SOCKS5 代理地址
Clash	http://127.0.0.1:7890	socks5://127.0.0.1:7890
Clash Verge	http://127.0.0.1:7897	socks5://127.0.0.1:7897
V2RayN	http://127.0.0.1:10809	socks5://127.0.0.1:10808
Shadowsocks	-	socks5://127.0.0.1:1080
Surge	http://127.0.0.1:6152	socks5://127.0.0.1:6153

📁 下载位置

• 视频：~/Downloads/twitter-videos/
• 音频：~/Downloads/twitter-audio/

🔗 支持的链接格式

• https://twitter.com/username/status/1234567890
• https://x.com/username/status/1234567890
• https://mobile.twitter.com/username/status/1234567890

⚡ 参数说明

参数	说明	示例
--quality, -q	视频清晰度：best, 1080, 720, 480, 360	-q 1080
--audio-only, -a	仅下载音频 MP3	-a
--proxy, -p	代理地址（大陆用户必填）	-p http://127.0.0.1:7890
--output, -o	自定义输出目录	-o /path/to/download

🛠️ 安装依赖

此工具需要 yt-dlp 和 ffmpeg，OpenClaw 会自动检查并提示安装。

❓ 常见问题

Q: 下载失败怎么办？
A: 请检查代理是否开启，使用 --proxy 参数指定代理地址。

Q: 如何确认代理正常工作？
A: 在终端运行 curl -x http://127.0.0.1:7890 https://x.com -I，如果返回 200 说明代理正常。

Q: 下载的视频在哪里？
A: 默认保存在 ~/Downloads/twitter-videos/ 目录。

Q: 支持下载私密账号的视频吗？
A: 不支持。只能下载公开账号的公开推文视频。

📝 示例场景

# 场景 1：下载马斯克的一条推文视频
clawhub run twitter-video-downloader -- \
  "https://x.com/elonmusk/status/1234567890" \
  --proxy http://127.0.0.1:7890

# 场景 2：下载为 1080p 高清
clawhub run twitter-video-downloader -- \
  "https://x.com/user/status/123" \
  --proxy http://127.0.0.1:7890 \
  --quality 1080

# 场景 3：只提取音频
clawhub run twitter-video-downloader -- \
  "https://x.com/user/status/123" \
  --proxy http://127.0.0.1:7890 \
  --audio-only

⚠️ 免责声明

• 请遵守当地法律法规
• 仅下载您有权下载的内容
• 尊重原创作者的版权

---

Made with ❤️ for Chinese users