OpenParable
Skip to content
← Back to skills

Readwise

Apps & Automation
readwise

Readwise is an Agent Skill for apps & automation published in the sundial-org/awesome-openclaw-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Access Readwise highlights and Reader saved articles

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/sundial-org/awesome-openclaw-skills/blob/HEAD/skills/readwise/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/readwise, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Readwise & Reader Skill

Access your Readwise highlights and Reader saved articles.

Setup

Get your API token from: https://readwise.io/access_token

Set the environment variable:

export READWISE_TOKEN="your_token_here"

Or add to ~/.clawdbot/clawdbot.json under "env".

Readwise (Highlights)

List books/sources

node {baseDir}/scripts/readwise.mjs books [--limit 20]

Get highlights from a book

node {baseDir}/scripts/readwise.mjs highlights [--book-id 123] [--limit 20]

Search highlights

node {baseDir}/scripts/readwise.mjs search "query"

Export all highlights (paginated)

node {baseDir}/scripts/readwise.mjs export [--updated-after 2024-01-01]

Reader (Saved Articles)

List documents

node {baseDir}/scripts/reader.mjs list [--location new|later|archive|feed] [--category article|book|podcast|...] [--limit 20]

Get document details

node {baseDir}/scripts/reader.mjs get <document_id>

Save a URL to Reader

node {baseDir}/scripts/reader.mjs save "https://example.com/article" [--location later]

Search Reader

node {baseDir}/scripts/reader.mjs search "query"

Notes

  • Rate limits: 20 requests/minute for Readwise, varies for Reader
  • All commands output JSON for easy parsing
  • Use --help on any command for options