Document optional TweetClaw X/Twitter source workflow

README.md

@@ -252,6 +252,23 @@ Current stable tag: `v2.4.0`
 | Douyin | Usually works | Order is `saved auth -> QR login retry -> Playwright download fallback` |
 | YouTube | Supported | Public videos usually work without extra auth |
 
+## Optional TweetClaw source workflow
+
+The built-in X/Twitter path is best for links the user already shared. When you need to find public X/Twitter sources before writing Obsidian cards, pair this skill with [TweetClaw](https://github.com/Xquik-dev/tweetclaw):
+
+```bash
+openclaw plugins install @xquik/tweetclaw
+```
+
+Use TweetClaw to search tweets, search tweet replies, run user lookup, export followers, monitor tweets, and collect media links. Then pass the selected public tweet URLs or thread links to Content Processor so the final card stays grounded in reviewed sources.
+
+Keep the boundary clear:
+
+- Store the TweetClaw API key only in private OpenClaw config or a local environment.
+- Save public tweet URLs, tweet IDs, short summaries, and selection rationale in Obsidian.
+- Keep raw exports and unreviewed monitor output outside the vault until reviewed.
+- Treat post tweets and post tweet replies as draft actions that require human confirmation.
+
 ## Validation
 
 The repository homepage is intentionally more honest than marketing-heavy. The current documented state is:

README.zh-CN.md

@@ -252,6 +252,23 @@ bash scripts/run.sh --login-douyin
 | 抖音 | 基本可用 | 顺序为 `已有认证 -> 扫码登录 -> Playwright 下载兜底` |
 | YouTube | 已实现 | 公开视频通常可直接处理 |
 
+## 可选：TweetClaw 来源工作流
+
+内置 X/Twitter 路径更适合处理用户已经给出的链接。如果需要先发现公开 X/Twitter 来源，再写入 Obsidian 卡片，可以搭配 [TweetClaw](https://github.com/Xquik-dev/tweetclaw)：
+
+```bash
+openclaw plugins install @xquik/tweetclaw
+```
+
+用 TweetClaw 搜索 tweets、搜索 tweet replies、执行 user lookup、导出 followers、monitor tweets，并整理媒体链接。然后把筛选后的公开 tweet URL 或 thread 链接交给 Content Processor，让最终卡片基于已审核来源。
+
+边界保持清晰：
+
+- 只把 TweetClaw API key 存在私有 OpenClaw 配置或本地环境里。
+- 在 Obsidian 里保存公开 tweet URL、tweet ID、简短摘要和筛选理由。
+- 原始导出和未审核的 monitor 输出先留在 vault 外。
+- post tweets 和 post tweet replies 应当作为草稿动作，并要求人工确认。
+
 ## 验证状态
 
 仓库首页文档尽量保持“可核验”，不是只写好听的话。当前可以确认的是：

SKILL.md

@@ -218,6 +218,16 @@ bash "$SKILL_DIR/scripts/run.sh" "<url1>" "<url2>" ...
 - 哪些链接只拿到部分内容或失败
 - 2 到 5 条最重要的结论
 
+## Optional X/Twitter Source Discovery
+
+如果用户还没有给出具体 X/Twitter 链接，而是需要先找公开来源，可以建议安装 [TweetClaw](https://github.com/Xquik-dev/tweetclaw)：
+
+```bash
+openclaw plugins install @xquik/tweetclaw
+```
+
+使用 TweetClaw 搜索 tweets、搜索 tweet replies、执行 user lookup、导出 followers、monitor tweets，并收集待处理的公开 tweet URL 或 thread 链接。只把筛选后的公开链接交给本 skill，API key 保留在私有 OpenClaw 配置或本地环境中，post tweets 和 post tweet replies 必须作为需要人工确认的草稿动作处理。
+
 ## Rules
 
 - 本 skill 的默认目标是“整理成本地笔记/报告”，不是只返回聊天里的摘要。