← 返回 Skills 市场
1201
总下载
1
收藏
22
当前安装
1
版本数
在 OpenClaw 中安装
/install x-reader
功能描述
Fetch, transcribe, and analyze content from URLs, files, or transcripts across multiple platforms, providing personalized, multi-dimensional insights.
安全使用建议
This skill generally does what it claims, but it has several privacy and storage implications you should consider before installing:
- Third‑party transmission: The skill uses external services (r.jina.ai, api.groq.com, api.fxtwitter.com, and wsrv.nl) to fetch/convert content and proxy images. Fetching/transcribing will send the target URL and/or audio to those services. If that is sensitive, do not provide GROQ_API_KEY or use those fallbacks.
- Session files and credentials: The login flow saves Playwright storage_state JSON files (cookies/localStorage) under ~/.x-reader/sessions and will use them for browser fetch fallbacks. Those files contain authentication tokens; the code attempts to set 0o600 permissions but you should verify permissions and only save sessions for accounts you trust being accessed by this tool.
- Optional secrets: TG_API_ID and TG_API_HASH (Telegram) and GROQ_API_KEY are only needed for those optional features. Only set them if you know why and trust the code/service.
- Local subprocesses and tooling: The skill runs yt-dlp/ffmpeg and Playwright (if installed). These are normal for media transcription but will execute external binaries — install from trusted sources and run in an environment you control.
- Traceability: The registry metadata didn't include homepage/source, but the SKILL.md/README reference a GitHub repo. If you plan to use this, verify the upstream repo, review recent commits, and prefer installing from a pinned commit or direct GitHub source you inspected.
Recommendations:
1. Review the code (especially calls that POST to external APIs and the login/session saving code) yourself or in an isolated environment.
2. If you are concerned about data exposure, avoid supplying GROQ_API_KEY or Telegram credentials and prefer Jina/Local fallbacks (note: Jina also sends URLs to r.jina.ai).
3. Run the tool in a container or VM if you want to limit persistence and network egress.
4. Inspect and confirm file locations (INBOX_FILE, SESSION_DIR, OBSIDIAN_VAULT) and ensure they are acceptable. Manually set restrictive permissions on session files after login.
5. If you need an offline/self-hosted option, consider replacing remote services (Jina/Groq/FxTwitter/wsrv.nl) with self‑hosted components before using with sensitive data.
If you want, I can highlight every place in the repository that transmits data externally or writes session files so you can inspect those calls in detail.
功能分析
Type: OpenClaw Skill
Name: x-reader
Version: 0.2.0
The skill is classified as suspicious due to several risky capabilities and potential vulnerabilities, despite implementing notable security safeguards. The `SKILL.md` instruction 'Local file | Read file directly' presents a prompt injection risk, potentially allowing an AI agent to be tricked into reading arbitrary local files if not properly sandboxed. Additionally, while `utils/storage.py` has strong path validation for Markdown output, the `INBOX_FILE` path (defaulting to `unified_inbox.json` or configurable via environment variable) lacks similar robust path traversal protection, potentially allowing an attacker to overwrite an arbitrary file. The skill also performs external network calls, executes `yt-dlp` via `subprocess.run`, and handles sensitive authentication sessions, though these operations are mitigated by a robust `utils/url_validator.py` for SSRF prevention, safe `subprocess.run` usage, and permission setting for session files. There is no clear evidence of intentional malicious behavior like data exfiltration or backdoor installation.
能力评估
Purpose & Capability
The code implements a universal content reader (fetchers for YouTube, Bilibili, WeChat, X/Twitter, Telegram, RSS, Xiaohongshu, etc.) which matches the skill description. Optional credentials and tools referenced (TG_API_ID/TG_API_HASH for Telegram, GROQ_API_KEY for Whisper, Playwright/yt-dlp/ffmpeg) are appropriate for the declared features. However the registry metadata lists no source/homepage while the README/SKILL.md point to a GitHub repo (https://github.com/runesleo/x-reader) — a mismatch in the package metadata/registry visibility that reduces traceability.
Instruction Scope
Runtime instructions and code will: fetch remote pages; upload audio to the Groq Whisper API (api.groq.com) if GROQ_API_KEY is provided; request content via Jina Reader (r.jina.ai) which sends target URLs to that service; use FxTwitter/fxtwitter.com and wsrv.nl image proxy for certain fetches; run yt-dlp/ffmpeg subprocesses; open headless/visible browsers and save Playwright storage_state JSON session files (cookies/localStorage) under ~/.x-reader/sessions; and read/write an inbox JSON and optionally write into an Obsidian vault. These behaviors involve transmitting user-supplied content and URLs to third parties and storing sensitive session cookies on disk — all of which are within the skill's stated purpose but are important privacy/security considerations that the SKILL.md does not strongly call out as risks.
Install Mechanism
This is instruction-only in the registry (no automated install spec), but the package includes a full Python implementation with optional dependencies: Playwright, Telethon, yt-dlp, ffmpeg, and calls subprocesses. There is no arbitrary remote download/install step in the registry spec, which lowers supply‑chain risk, but the skill expects you to install third‑party tools that will be executed locally.
Credentials
The skill itself does not declare required env vars in the registry, but the code and README reference several sensitive environment variables (TG_API_ID, TG_API_HASH, TG_SESSION_PATH, GROQ_API_KEY). Those are logically required only for the corresponding optional features (Telegram fetch, Whisper transcription), so they are proportionate to functionality — however these secrets enable network access (Telethon and Groq API) and the skill also saves session files containing cookies. Additionally, some fetch paths proxy images through wsrv.nl and use r.jina.ai and fxtwitter.com; using those services will reveal the target URLs/content to third parties. The skill should explicitly warn users that content and URLs may be transmitted to these external services before they provide keys or save sessions.
Persistence & Privilege
The skill does not request 'always: true' and it does not modify other skills. It will create and write files (inbox JSON, optional Obsidian file, and Playwright storage_state session files under ~/.x-reader/sessions). Saving browser sessions (cookies/localStorage) and inbox files is normal for this kind of tool but grants persistent access to authentication tokens if users save sessions — the code makes an effort to set file permissions (0o600) but users should verify file locations and permissions.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install x-reader - 安装完成后,直接呼叫该 Skill 的名称或使用
/x-reader触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.2.0
x-reader 0.2.0
- Added detailed SKILL.md documentation outlining triggers, analysis pipeline, output modes, and customization options.
- Clarified supported platforms for content extraction and transcription, with toolchains for each type (web, file, transcript).
- Introduced customizable multi-dimensional analysis with guidance for domain-specific adaptation.
- Defined best practices for actionable, sourced analysis with ROI consideration.
- Listed dependencies and provided links for source code and issue tracking.
元数据
常见问题
X Reader 是什么?
Fetch, transcribe, and analyze content from URLs, files, or transcripts across multiple platforms, providing personalized, multi-dimensional insights. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1201 次。
如何安装 X Reader?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install x-reader」即可一键安装,无需额外配置。
X Reader 是免费的吗?
是的,X Reader 完全免费(开源免费),可自由下载、安装和使用。
X Reader 支持哪些平台?
X Reader 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 X Reader?
由 Yujun(@lifecn)开发并维护,当前版本 v0.2.0。
推荐 Skills