An elegant, auto-refreshing macOS desktop widget that displays WeChat Reading streaks, reading times, current progress, goals, and daily quotes.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install reading-widget
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install reading-widget using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is WeChat Reading Desktop Widget?
The WeChat Reading Desktop Widget is a beautiful, Material 3 styled dark-mode card designed to keep your reading progress and habits front and center on your macOS desktop. By rendering local reading metrics in a sleek 264px borderless floating card, it helps users stay accountable and motivated. Built to leverage the automation power of Openclaw Skills, this tool integrates seamlessly with your local development environment to provide real-time metrics without requiring manual webpage updates.
At its core, this widget relies on a lightweight local Python server and updater script that securely fetches WeChat Reading statistics via API. It handles authentication gracefully, protects your API credentials, and displays a comprehensive breakdown of your reading habits, including continuous reading days, active book progress, monthly reading hours, and dynamically rotated favorite book quotes.
WeChat Reading Desktop Widget Use Cases
- Installing or configuring the desktop widget via automated AI-driven setups with Openclaw Skills.
- Tracking daily, weekly, and yearly reading stats and streaks directly from your macOS desktop.
- Troubleshooting API connection errors, 401 unauthorized calls, or local backend server startup issues.
- Customizing widget themes, Material 3 CSS styles, local update intervals, or quote content exclusions.
- Unloading LaunchAgents and removing tracking services cleanly when optimizing system startup performance.
How WeChat Reading Desktop Widget Works
- Prerequisite Check: The skill looks for
WEREAD_API_KEYconfigured within~/.claw/settings.json(or~/.claude/settings.jsonfor Claude Code environments) to ensure authorized access. - Directory Initialization: Automatically creates a dedicated workspace at
~/Desktop/reading-widget/and populates it with Python backend scripts, local settings templates, and layout files. - Initial Data Fetch: Runs the compiled updater script to download reading metadata from the WeChat Reading API, rendering the first local static copy of
widget.html. - Local HTTP Server Boot: Launches a lightweight Python background server on
127.0.0.1:47900to serve the interactive page, auto-sync files, and handle monthly target modifications. - Web-App Desktop Integration: Launches Google Chrome in borderless app mode (
--app) to display the floating card on the desktop screen.
WeChat Reading Desktop Widget Setup
To deploy and manage this widget using Openclaw Skills, complete the following setup steps:
Step 1: Set Up Authentication
Ensure your WeChat Reading API key is securely saved in your local settings profile. Open your ~/.claw/settings.json file and append the following configuration:
{
"env": {
"WEREAD_API_KEY": "wrk-xxxxxxxx"
}
}
Step 2: Initialize Widget Files
Ensure python3 is installed and run the updater to fetch stats and render your first widget file:
python3 ~/Desktop/reading-widget/update.py
Step 3: Run the Application
Launch the integrated server and open the widget in a borderless Chrome container:
bash ~/Desktop/reading-widget/open-widget.sh
Step 4: Configure Auto-Start on System Boot (Optional)
To keep your stats updated in the background without manual execution, install the provided LaunchAgent configuration:
cp ~/Desktop/reading-widget/com.user.reading-widget.plist ~/Library/LaunchAgents/
# Replace placeholder path and USERNAME within the plist, then load it:
launchctl load ~/Library/LaunchAgents/com.user.reading-widget.plist
WeChat Reading Desktop Widget Data Schema & Taxonomy
The widget organizes code, configurations, and rendered front-end states cleanly inside a single local directory. Here is how files and data streams are laid out:
Directory Layout
| File Name | Purpose / Description |
|---|---|
server.py |
Local Python HTTP server running on port 47900. Synchronizes configurations and serves UI cards. |
update.py |
Logic script that contacts the official APIs, runs data transformations, and outputs widget.html. |
template.html |
Main CSS styling and layout configuration based on Material 3 specifications. |
config.json |
Local metadata storage storing custom monthly reading hours and refresh configurations. |
open-widget.sh |
Shell script ensuring the background server runs prior to starting Chrome's app viewport. |
Metrics Mapping
| Metric Component | Source Endpoint | Description |
|---|---|---|
| Streak Days | /readdata/detail |
Tracked weekly utilizing a minimum threshold of 60 seconds of reading per day. |
| Reading Duration | /readdata/detail |
Today's active duration vs. calculated weekly/yearly averages. |
| Goal Progress | config.json |
Interactive visual progress calculated against your goal hours. |
| Favorite Quotes | /book/bestbookmarks |
Displays community highlights, filtered dynamically through a local phrase blacklist. |
WeChat Reading Desktop Widget Advanced Features
- Interactive Flip Elements: Toggle views seamlessly between daily and weekly stats using responsive CSS transforms with no heavy javascript bundles.
- Direct Goal Updating: Click the goal progress directly on the widget to update, triggering a POST callback that modifies the local JSON file.
- Automatic Data Refresh: Built-in background interval updater fetches fresh server-side API information every 30 minutes seamlessly.
- Quote Content Filtering: Built-in custom string filtering allows users to define words or sentences to exclude from their desktop highlights.
- Automated Boot Automation: Ready-to-go LaunchAgents support automated system service initialization on macOS boot.
SKILL.md
Loading
Related Openclaw Skills
GuanShi Strategy Expert
A professional AI strategic analysis agent that automates portfolio evaluation, growth path design, and execution mapping within the GuanShi multi-agent framework.
GuanShi Competition Expert
An advanced strategic competitive intelligence agent that profiles competitors, maps market positions, and simulates tactical responses.
GuanShi Industry Expert
The GuanShi Industry Expert skill provides AI agents with advanced frameworks to execute deep industry research, calculate addressable market size, and map complex corporate value chains.
GuanShi Market Expert
An expert AI agent skill specialized in deep market insight, user research, segmentation, pricing strategies, and customer journey mapping.
cleanMyMacSkill
An AI-powered cross-platform disk storage analyzer that scans disk usage, segments files into safety tiers, and serves an interactive Apple-style dashboard for one-click cleanup.
Schema Migrator
A database automation tool that validates and executes pending index cleanup operations and migrations based on analyzer recommendations.
Featured*
