X-Read 技能

何时使用此技能

当您需要从公开的 X/Twitter 链接中提取文本、媒体链接和基本元数据，但又不想使用 API、创建账户或消耗 Brave 搜索积分时，请使用 x-read。该技能最适合处理线程链接（https://x.com/<用户>/status/<ID>）以及在 X 页面上直接展示内容的文章。

输入参数

• url（必填）：您希望解析的完整永久链接。请包含完整的 https://x.com/... 路径，以便 Puppeteer 浏览器能够直接导航。

执行过程

1. Puppeteer 启动一个沙盒化的 Chromium 实例，使用真实的用户代理，并加载指定的 URL。
2. 脚本等待 article[data-testid="tweet"] 元素出现，捕获主线程（主推文 + 最多三条回复），并提取任何关联的卡片或媒体附件。
3. 媒体以 ![](...) 的 Markdown 格式重新输出，若有 ALT 文本则一并保留；主文章正文将附加在主推文下方。
4. 输出为简洁的 Markdown 摘要，包含线程作者、时间戳、文本、链接和媒体信息，确保 Telegram 聊天内容可读性良好。

输出格式

## 推文线程摘要
来源: <url>

### **主推文** by 显示名称 (@用户名)
*2026-02-21T18:24:00Z*
推文内容 …

**关联文章:** [标题](卡片链接)
**媒体:**
- ![](媒体1)
- ![](媒体2)
---

回复推文遵循相同格式，使用 回复 标题。媒体链接保留 name=large 参数，以获取更高画质。

限制与故障排查

• 该技能仅读取公开可见的推文。若 X 通过登录墙阻止访问，将返回“需要登录”的错误提示。
• 长篇文章有时会使用 article.content 结构，脚本会将该部分内容附加到主推文后，确保仍可获取完整内容。
• 由于使用浏览器渲染，执行时间比 API 调用稍长，预计每条链接耗时 5–10 秒。
• 为获得最佳效果，请保持输入的链接聚焦单一主题，不要一次性提交多个无关链接；建议逐个运行该工具。

测试与安全性

• 该技能为只读模式：不会发布、点赞、发送私信或对 X 进行身份验证。
• 若 X 更新其 DOM 选择器，可检查 index.js 脚本中的 data-testid 属性（如 tweet、tweetText、User-Name、card.wrapper 等）是否需调整。
• 在正式发布前，建议手动运行 openclaw use x-read read_tweet --url <链接> 进行测试，确认输出符合预期。