前言¶
做文献综述时，常见的做法是人工在数据库里一篇篇搜、一篇篇读，再手工整理引用关系。这个过程既慢，又容易漏掉相关文献。下面介绍的 Skill 把这一步自动化：它通过 OpenAlex API（免费、无需 API 密钥）检索学术论文，支持按主题、作者、DOI 查找，并能展开引用链、抓取开放获取全文，最后自动生成结构化的文献综述。
需要说明的是，这个 Skill 解决的是「找文献 + 汇总」这一环，不负责论文写作、选题论证或 LaTeX 排版。
这是什么¶
Academic Research 是一个面向学术检索的 Agent Skill，坐标 @clawhub_rogersuperbuilderalpha/academic-research，由 rogersuperbuilderalpha 发布，页面另标注 Built by Topanga — AI Research Consultant。许可证为 MIT-0，当前版本 v1.0.0。它封装了 OpenAlex 学术数据库的查询能力，把「检索 → 去重 → 主题聚类 → 综述合成」做成可直接调用的命令行脚本。
底层数据源是 OpenAlex，收录约 2500 万篇学术作品，全程无需密钥，适合在 Agent 或自动化流程里作为文献检索的一环。
核心功能¶
已核实的能力如下：
- 按主题搜索论文，支持限制返回数量和按引用量排序。
- 按作者搜索。
- 按 DOI 精确查找单篇论文。
- 展开引用链，查看某篇论文的施引文献和参考文献（
--direction both表示双向）。 - 深度读取，抓取摘要及开放获取全文（若可用）。
- 结构化输出，每篇论文返回标题、年份、作者（至多 5 位）、摘要、引用数、DOI、开放获取 URL、来源期刊/会议。
- 自动文献综述：多查询变体检索、去重与相关性+引用排序、主题聚类，并生成 Markdown 综述。
- JSON 输出，便于程序化调用。
安装与启用¶
Skill 基于通用 SKILL.md 格式，通过 ClawHub 生态的 CLI 安装。官方安装命令如下：
npx skills
# 或
openclaw skills install @rogersuperbuilderalpha/academic-research
安装后，Skill 内部提供两个 Python 脚本：scripts/scholar-search.py 用于检索，scripts/literature-review.py 用于综述生成。运行环境需具备 Python 3 与脚本所依赖的 HTTP 库（用于访问 OpenAlex API）。
官方地址：https://api.skillhub.cn/user_b18c475a/academic-research
上游仓库：https://clawhub.ai/rogersuperbuilderalpha/academic-research
典型用法¶
下面的例子来自上游仓库的官方说明。
按主题搜索，限制返回 10 篇：
python3 scripts/scholar-search.py search "transformer architectures" --limit 10
按作者搜索：
python3 scripts/scholar-search.py author "Yann LeCun" --limit 5
按 DOI 查找单篇论文：
python3 scripts/scholar-search.py doi "10.1038/s41586-021-03819-2"
展开某篇论文的引用链（施引与参考文献双向）：
python3 scripts/scholar-search.py citations "10.1038/s41586-021-03819-2" --direction both
深度读取，抓取摘要与全文：
python3 scripts/scholar-search.py deep "10.1038/s41586-021-03819-2"
以 JSON 格式输出，便于程序消费：
python3 scripts/scholar-search.py search "CRISPR" --json
自动生成文献综述，目标 30 篇，写入 review.md：
python3 scripts/literature-review.py "algorithmic literacy in education" --papers 30 --output review.md
该综述脚本支持以下参数：
--papers N：目标文献数量，默认 20。--output FILE：输出文件，默认输出到标准输出。--years 2020-2025：限定发表年份范围。--json：输出结构化 JSON 而非 Markdown。
综述脚本会把检索结果缓存在 /tmp/litreview_cache/ 下，避免重复请求。
适用场景与注意¶
适合的场景：需要快速建立某一主题的文献全景、做引用关系溯源、或为综述报告批量收集与归类文献。由于底层是 OpenAlex，覆盖以英文为主的国际期刊与会议，中文文献覆盖有限。
需要注意的几点：
- OpenAlex 默认按相关性排序；若要按影响力查看，需加
--sort citations。 - 快速分诊建议先 search、再对有希望的命中跑 deep。
- 全文 PDF 需要自行处理：把 DOI 传给 PDF 抽取工具，Skill 本身只负责定位。
- 引用数、开放获取 URL 等字段依赖 OpenAlex 的元数据完整性，部分旧文献可能缺失。
- 综述脚本依赖网络访问 OpenAlex，缓存目录为
/tmp，重启后可能失效。
结尾¶
Academic Research 的价值在于把「找文献」这一步从手工劳动里抽出来，用 OpenAlex 的免费接口完成检索、引用链展开和综述合成。它不覆盖论文写作与排版，只负责到「结构化综述」为止。如果你的流程里缺的是文献检索这一环，可以从官方地址安装试用。
官方地址：https://api.skillhub.cn/user_b18c475a/academic-research
上游仓库：https://clawhub.ai/rogersuperbuilderalpha/academic-research
