x-reader

Universal content reader — fetch and digest content from 7+ platforms.

Installation

# Python venv: ~/.openclaw/venv-xreader
# CLI path: ~/.openclaw/venv-xreader/bin/x-reader

Environment Setup

Obsidian vault path is configured via environment variable:

OBSIDIAN_VAULT=~/Library/Mobile Documents/com~apple~CloudDocs/MyVault

Usage

# Basic fetch
x-reader <url>

# Multiple URLs
x-reader <url1> <url2>

# Login to platform (saves session for browser fallback)
x-reader login xhs

# Show inbox
x-reader list

# Clear inbox
x-reader clear

Supported Platforms

For WeChat Articles

WeChat public accounts require Playwright browser fallback. Run once:

x-reader login xhs  # creates browser session

Then fetch WeChat articles normally:

x-reader https://mp.weixin.qq.com/s/abc123

As Python Library

import asyncio
from x_reader.reader import UniversalReader

async def main():
    reader = UniversalReader()
    content = await reader.read("https://mp.weixin.qq.com/s/abc123")
    print(content.title)
    print(content.content[:200])

asyncio.run(main())

CLI Path

~/.openclaw/venv-xreader/bin/python — Python with x-reader installed

~/.openclaw/venv-xreader/bin/x-reader — x-reader CLI