A powerful bridge between your personal knowledge management system and your AI agent, enabling programmatic access to Readwise and Reader data.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install readwise
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 readwise 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 Readwise & Reader Integration?
The Readwise and Reader skill provides a comprehensive interface to interact with the Readwise ecosystem directly from your terminal. It allows users to programmatically retrieve highlights from books, search through curated knowledge bases, and manage the Reader inbox. By integrating this into Openclaw Skills, developers and researchers can leverage their existing reading data directly within their AI-powered workflows, transforming static highlights into actionable insights and automated research pipelines.
Readwise & Reader Integration Use Cases
- Retrieving specific book highlights for technical documentation or research papers.
- Automating the capture of web articles into the Reader "later" queue via script.
- Performing cross-source searches across all saved highlights and documents.
- Exporting historical reading data for personal knowledge base synchronization and backup.
How Readwise & Reader Integration Works
- The user authenticates the skill using a secure Readwise API token.
- Commands are issued via Node.js scripts to communicate with the Readwise or Reader REST APIs.
- The skill retrieves metadata, full text, or highlights based on user-defined filters such as date, category, or location.
- Data is returned in a structured JSON format, ready for consumption by AI agents or other CLI tools within the Openclaw Skills environment.
Readwise & Reader Integration Setup
First, obtain your API token from the Readwise access page: https://readwise.io/access_token.
Set the environment variable in your terminal:
export READWISE_TOKEN="your_token_here"
Alternatively, you can add the token to your local configuration at ~/.clawdbot/clawdbot.json under the "env" key. Ensure you have Node.js installed to run the scripts provided in the Openclaw Skills package.
Readwise & Reader Integration Data Schema & Taxonomy
The skill interacts with two primary data objects: Highlights and Documents. Data is returned as JSON with the following structure:
| Object | Key Fields |
|---|---|
| Books | ID, Title, Author, Source, Highlight Count |
| Highlights | ID, Text, Note, Book ID, Created At |
| Reader Docs | ID, URL, Title, Location (new/later/archive), Category |
Readwise & Reader Integration Advanced Features
- Full-text search capabilities across the entire Reader library for quick reference.
- Paginated highlight exports using the updated-after filter for incremental data syncing.
- Categorical filtering for document retrieval across articles, books, podcasts, and more.
- High-speed URL saving to quickly populate your Reader queue for later consumption using Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Telegram Chat to Image
A specialized utility for converting raw Telegram Desktop JSON exports into polished, long screenshot-style images using Openclaw Skills.
Fence Quote Calculator
A precision material takeoff tool for calculating fencing components including posts, rails, pickets, and hardware for wood, vinyl, and aluminum projects.
Seedance 3x3 Optimizer
An AI-powered script optimizer that converts narrative plots into structured 9-segment visual scripts specifically for Seedance video generation.
Reminder Secretary
A natural-language personal assistant that captures events into a git-synced workspace and schedules automated Telegram notifications.
Mac Compute Use
A comprehensive skill for controlling macOS applications and automating GUI interactions through the Accessibility API.
Luma Events Fetcher
A high-efficiency utility to scrape and structure tech event data from lu.ma for any global city without requiring authentication.
Featured*
