weread

What This Skill Does

The weread skill provides a powerful command-line interface for interacting with WeChat Reading (微信读书). It serves as a bridge between your personal reading data stored on the platform and your local machine. With this tool, you can seamlessly authenticate via QR code, browse your bookshelf, and programmatically extract reading notes, highlights, and reviews. Whether you are a researcher building a knowledge base, a student aggregating lecture material, or an avid reader wanting to back up your literary journey, this tool automates the tedious process of manual copying and pasting.

Installation

To integrate this functionality into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/z233/weread Ensure you have the necessary environment dependencies, such as jq, installed on your system if you intend to perform advanced data filtering and batch processing.

Use Cases

• Knowledge Management: Automatically sync your highlights into your Obsidian or Notion vaults using the exported Markdown files.
• Daily Review: Build an automated daily routine that pushes yesterday's reading highlights to your productivity dashboard or desktop notifications.
• Archive & Backup: Maintain a local, offline archive of all your reading annotations, ensuring your intellectual assets are preserved even if cloud services change their access policies.
• Data Analytics: Analyze your reading habits, such as finding which books have the most engagement or monitoring the growth of your reading notes over time by piping JSON outputs into analytical tools.

Example Prompts

1. "Can you fetch all my highlights from 'The Psychology of Money' and save them to a markdown file?"
2. "Show me all the notes I made yesterday across any book on my WeChat Reading bookshelf."
3. "List my last 5 books read and extract all highlights from the most recently updated one."

Tips & Limitations

• Authentication: Always run weread login first. If you experience errors, use weread whoami to verify that your session cookie is still valid.
• Efficiency: When processing multiple books, use the --json flag combined with jq. This avoids manual parsing and allows for sophisticated data pipelines.
• Data Privacy: This tool handles your personal WeChat Reading session data. Ensure you are using it in a secure environment and are aware that it accesses your private reading records.
• Formatting: The tool outputs clean Markdown by default, making it ideal for integration with static site generators or personal knowledge management apps.