Readwise阅读管理

技能简介

连接 Readwise 服务，读取你的书籍高亮标注和 Reader 保存的文章。支持按书籍、时间筛选标注，管理稍后读列表。

能做什么

• 列出所有做过标注的书籍和来源
• 提取单本书的全部高亮内容
• 搜索跨书籍的标注文本
• 批量导出标注数据（支持时间过滤）
• 查看 Reader 中保存的文章列表
• 获取单篇文章的完整内容
• 将网页链接保存到 Reader
• 在 Reader 库中搜索文章

使用说明

安装前提：需要 Node.js 环境。

1. 获取 API Token
访问 https://readwise.io/access_token 生成个人令牌。

2. 配置环境变量
执行以下命令或在 ~/.clawdbot/clawdbot.json 的 env 字段中添加：

export READWISE_TOKEN="your_token_here"

3. 常用命令示例

列出最近标注的书籍：

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

获取指定书籍的高亮：

node {baseDir}/scripts/readwise.mjs highlights --book-id 123

搜索标注内容：

node {baseDir}/scripts/readwise.mjs search "关键词"

查看 Reader 稍后读列表：

node {baseDir}/scripts/reader.mjs list --location later

保存网页到 Reader：

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

各命令支持 --help 查看完整参数。

输入与输出

见下方输入与输出表格。

项目	内容
输入	READWISE_TOKEN 环境变量；书籍ID、搜索词、时间范围等可选参数；Reader 位置/类型过滤条件；待保存的 URL 字符串
输出	JSON 格式的书籍列表、高亮标注、搜索结果、Reader 文档列表及详情、操作状态
适用人群	Readwise 订阅用户、需要自动化笔记整理的研究者、构建阅读工作流的开发者
不包含	标注的编辑删除功能、账户注册付费流程、非 Readwise 数据源、PDF 全文解析

 

风险提示

• Readwise API 限流：每分钟 20 次请求，超出可能暂时封禁
• Reader API 限流策略不固定，高频调用需注意回退
• Token 泄露将导致个人阅读数据暴露，勿提交到代码仓库
• 导出大量数据时建议分批次并添加 updated-after 参数

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/refrigerator/readwise/SKILL.md
来源类型：GitHub 仓库