@wentorai/research-plugins 1.4.2 → 1.4.4

package/README.en.md

@@ -0,0 +1,143 @@
+<div align="center">
+
+<img src="assets/logo.png" width="160" alt="Research-Claw · 科研龙虾" />
+
+# The most comprehensive library of AI skills&plugins for academic research
+
+**The brain of Research-Claw — 438 academic skills + 34 API tools**
+
+Plug-and-play research capabilities for [Research-Claw](https://github.com/wentorai/Research-Claw) and 40+ AI agent frameworks
+
+[![npm](https://img.shields.io/npm/v/@wentorai/research-plugins?style=flat-square&color=EF4444&logo=npm)](https://www.npmjs.com/package/@wentorai/research-plugins)
+[![License](https://img.shields.io/badge/license-MIT-3B82F6?style=flat-square)](LICENSE)
+[![Skills](https://img.shields.io/badge/skills-438-EF4444?style=flat-square)](https://www.npmjs.com/package/@wentorai/research-plugins)
+[![Tools](https://img.shields.io/badge/API_tools-34-3B82F6?style=flat-square)](#agent-tools-34)
+
+[🌐 wentor.ai](https://wentor.ai) · [🇨🇳 中文](README.md) · [🦞 Research-Claw](https://github.com/wentorai/Research-Claw) · [🪲 Issues](https://github.com/wentorai/research-plugins/issues)
+
+</div>
+
+---
+
+## Quick Start
+
+### Install (Research-Claw / OpenClaw)
+
+```bash
+openclaw plugins install @wentorai/research-plugins
+```
+
+Installs to `~/.openclaw/extensions/`. Restart the gateway to auto-load all skills + tools.
+
+### Install (Claude Code / Cursor / Windsurf / OpenCode)
+
+```bash
+npx skills add wentorai/research-plugins
+```
+
+> This installs SKILL.md files only (no API tools). Compatible with 41 agent frameworks supporting the skills protocol.
+
+### Uninstall
+
+```bash
+# OpenClaw / Research-Claw — manually remove plugin directory
+rm -rf ~/.openclaw/extensions/research-plugins
+
+# npx skills — manually remove skills directory
+rm -rf .skills/wentorai/research-plugins
+```
+
+> **pnpm projects:** Do not add this as a pnpm dependency and load from `node_modules` via `plugins.load.paths`. pnpm hardlinks are rejected by OpenClaw's security validator. Always use `openclaw plugins install`.
+
+---
+
+## What's Inside
+
+### Academic Skills (438)
+
+Structured SKILL.md guides covering the full research lifecycle, loaded on demand:
+
+| Category | Count | Coverage |
+|:--|:--|:--|
+| **Literature** | 87 | Multi-database search · Citation tracking · Full-text · Open access |
+| **Methodology** | 79 | DID · RDD · IV · Meta-analysis · Systematic review · Grant writing |
+| **Data Analysis** | 68 | Python · R · STATA · Visualization · Panel data · Econometrics |
+| **Writing** | 74 | Paper sections · LaTeX · References · Rebuttal generation |
+| **Domains** | 93 | 16 disciplines: CS · AI/ML · Biomedical · Economics · Law · Physics etc. |
+| **Tools** | 51 | Diagrams · PDF parsing · Knowledge graphs · OCR · Scraping |
+
+Skills use **progressive disclosure**: 6 category entries → 40 subcategory indexes → 438 concrete skills. Agents load on demand, never injecting everything at once.
+
+### Agent Tools (34)
+
+TypeScript wrappers for 18 free academic database APIs, auto-registered as OpenClaw plugin tools:
+
+| Module | Tools | Source |
+|:--|:--|:--|
+| `openalex` | `search_openalex` · `get_work` · `get_author_openalex` | OpenAlex (250M+ works) |
+| `crossref` | `resolve_doi` · `search_crossref` | CrossRef (150M+ DOIs) |
+| `arxiv` | `search_arxiv` · `get_arxiv_paper` | arXiv |
+| `pubmed` | `search_pubmed` · `get_article` | PubMed / NCBI |
+| `unpaywall` | `find_oa_version` | Unpaywall (open access) |
+| `europe-pmc` | `search_europe_pmc` · `get_epmc_citations` · `get_epmc_references` | Europe PMC (33M+) |
+| `opencitations` | `get_citations_open` · `get_references_open` · `get_citation_count` | OpenCitations (2B+ links) |
+| `dblp` | `search_dblp` · `search_dblp_author` | DBLP (7M+ CS records) |
+| `doaj` | `search_doaj` | DOAJ (9M+ OA articles) |
+| `biorxiv` | `search_biorxiv` · `search_medrxiv` · `get_preprint_by_doi` | bioRxiv / medRxiv |
+| `openaire` | `search_openaire` | OpenAIRE (170M+, EU funder filter) |
+| `zenodo` | `search_zenodo` · `get_zenodo_record` | Zenodo |
+| `orcid` | `search_orcid` · `get_orcid_works` | ORCID |
+| `inspire-hep` | `search_inspire` · `get_inspire_paper` | INSPIRE-HEP (physics) |
+| `hal` | `search_hal` | HAL (French open archive) |
+| `osf-preprints` | `search_osf_preprints` | OSF Preprints |
+| `datacite` | `search_datacite` · `resolve_datacite_doi` | DataCite (dataset DOIs) |
+| `ror` | `search_ror` | ROR (research organizations) |
+
+### Curated Resources (6)
+
+Hand-picked resource collections for each skill category. See `curated/` directory.
+
+---
+
+## Architecture
+
+```
+@wentorai/research-plugins
+├── skills/                    ← 438 SKILL.md (6 categories × 40 subcategories)
+│   ├── literature/            ← Search, discovery, full-text, metadata
+│   ├── writing/               ← Composition, citation, LaTeX, polish
+│   ├── analysis/              ← Statistics, econometrics, dataviz
+│   ├── research/              ← Methodology, reviews, grants
+│   ├── domains/               ← 16 academic disciplines
+│   └── tools/                 ← Diagrams, documents, scraping, OCR
+├── src/tools/                 ← 34 API tools (18 modules)
+├── curated/                   ← 6 curated resource lists
+├── catalog.json               ← Full index (462 entries)
+├── index.ts                   ← Plugin entry (OpenClaw Plugin SDK)
+└── openclaw.plugin.json       ← Plugin manifest
+```
+
+**Loading modes:**
+- **Research-Claw / OpenClaw**: Full plugin (skills + API tools) via `openclaw plugins install`
+- **Other agent frameworks**: SKILL.md files only (no API tools) via `npx skills add`
+
+---
+
+## Community Attribution
+
+This project curates, organizes, and enhances publicly available academic resources.
+
+- **Skills** are authored guides based on established research methodologies, public API docs, and widely-used workflows. Where content derives from specific projects, the `source` field in each SKILL.md frontmatter links to the original.
+- **Curated lists** aggregate community resource links for discovery purposes.
+
+All original content is released under the [MIT License](LICENSE). Referenced third-party projects retain their own licenses.
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+[MIT](LICENSE) — Copyright (c) 2026 Wentor AI

package/README.md

@@ -1,176 +1,143 @@
-# @wentorai/research-plugins
+<div align="center">
 
-**[English](#english)** | **[中文](#中文)**
+<img src="assets/logo.png" width="160" alt="科研龙虾 · Research-Claw" />
 
----
-
-<a id="english"></a>
-
-## Research Plugins for Research-Claw
-
-An open-source collection of **438 academic research skills**, **34 agent tools** (18 API modules), and **6 curated resource lists** for [Research-Claw](https://wentor.ai) and other AI coding agents.
-
-Built by [Wentor AI](https://wentor.ai) for the global research community.
+# 最全的学术科研领域技能插件库
 
-### What's Inside
+**科研龙虾的大脑 — 438 个学术技能 + 34 个 API 工具**
 
-| Component | Count | Description |
-|-----------|-------|-------------|
-| **Skills** | 438 | Practical SKILL.md guides covering literature search, academic writing, data analysis, research methods, 16 domain specialties, and productivity tools |
-| **Agent Tools** | 34 | TypeScript API wrappers for 18 academic databases: OpenAlex, CrossRef, arXiv, PubMed, Unpaywall, Europe PMC, OpenCitations, DOAJ, DBLP, bioRxiv/medRxiv, OpenAIRE, Zenodo, ORCID, INSPIRE-HEP, HAL, OSF, DataCite, ROR |
-| **Curated Lists** | 6 | Hand-picked resource collections for each skill category |
+为 [Research-Claw (科研龙虾)](https://github.com/wentorai/Research-Claw) 及 40+ AI Agent 框架提供即插即用的科研能力
 
-> **Note:** 150 MCP server configs were archived in the v1.4.0 audit. See `archived/mcp-configs/` for reference.
+[![npm](https://img.shields.io/npm/v/@wentorai/research-plugins?style=flat-square&color=EF4444&logo=npm)](https://www.npmjs.com/package/@wentorai/research-plugins)
+[![License](https://img.shields.io/badge/license-MIT-3B82F6?style=flat-square)](LICENSE)
+[![Skills](https://img.shields.io/badge/skills-438-EF4444?style=flat-square)](https://www.npmjs.com/package/@wentorai/research-plugins)
+[![Tools](https://img.shields.io/badge/API_tools-34-3B82F6?style=flat-square)](#智能体工具34-个)
 
-### Taxonomy
+[🌐 wentor.ai](https://wentor.ai) · [🇬🇧 English](README.en.md) · [🦞 Research-Claw](https://github.com/wentorai/Research-Claw) · [🪲 Issues](https://github.com/wentorai/research-plugins/issues)
 
-Skills are organized into **6 categories** with **40 subcategories**:
+</div>
 
-| Category | Subcategories | Skills | Description |
-|----------|---------------|--------|-------------|
-| **literature** | search, discovery, fulltext, metadata | 80 | Paper search, citation tracking, open access |
-| **writing** | composition, polish, latex, templates, citation | 64 | Academic writing, LaTeX, reference management |
-| **analysis** | statistics, econometrics, wrangling, dataviz | 46 | Statistical methods, data cleaning, visualization |
-| **research** | methodology, deep-research, paper-review, automation, funding | 53 | Research design, systematic reviews, grant writing |
-| **domains** | 16 disciplines (CS, AI/ML, biomedical, chemistry, economics, finance, law, physics, math, ecology, etc.) | 147 | Domain-specific research methods and tools |
-| **tools** | diagram, document, code-exec, scraping, knowledge-graph, ocr-translate | 48 | Diagrams, PDF parsing, reproducible code, OCR |
+---
 
-### Install
+## 快速开始
 
-#### As OpenClaw Plugin (Recommended)
+### 安装（Research-Claw / OpenClaw 用户）
 
 ```bash
 openclaw plugins install @wentorai/research-plugins
 ```
 
-This installs the plugin to `~/.openclaw/extensions/` where OpenClaw auto-discovers it. Skills and agent tools are loaded automatically.
-
-> **Note for satellite/pnpm projects:** Do not add this package as a `pnpm` dependency and load it from `node_modules` via `plugins.load.paths`. pnpm's content-addressable store uses hardlinks, which OpenClaw's security validator rejects (`unsafe plugin manifest path`). Always use `openclaw plugins install` instead.
+插件安装到 `~/.openclaw/extensions/`，重启 gateway 后自动加载所有技能 + 工具。
 
-#### As Skills Collection (Claude Code, Cursor, Windsurf, OpenCode)
+### 安装（Claude Code / Cursor / Windsurf / OpenCode 用户）
 
 ```bash
 npx skills add wentorai/research-plugins
 ```
 
-#### Via npm
-
-```bash
-npm install @wentorai/research-plugins
-```
-
-### Agent Tools
-
-34 tool functions across 18 academic API modules, registered automatically when used as an OpenClaw plugin. All APIs are free and open:
-
-| Module | Tools | API |
-|--------|-------|-----|
-| `openalex` | `search_openalex`, `get_work`, `get_author_openalex` | OpenAlex (250M+ works) |
-| `crossref` | `resolve_doi`, `search_crossref` | CrossRef (150M+ DOIs) |
-| `arxiv` | `search_arxiv`, `get_arxiv_paper` | arXiv |
-| `pubmed` | `search_pubmed`, `get_article` | PubMed / NCBI |
-| `unpaywall` | `find_oa_version` | Unpaywall |
-| `europe-pmc` | `search_europe_pmc`, `get_epmc_citations`, `get_epmc_references` | Europe PMC (33M+) |
-| `opencitations` | `get_citations_open`, `get_references_open`, `get_citation_count` | OpenCitations (2B+ links) |
-| `doaj` | `search_doaj` | DOAJ (9M+ OA articles) |
-| `dblp` | `search_dblp`, `search_dblp_author` | DBLP (7M+ CS records) |
-| `biorxiv` | `search_biorxiv`, `search_medrxiv`, `get_preprint_by_doi` | bioRxiv / medRxiv |
-| `openaire` | `search_openaire` | OpenAIRE (170M+, EU funder filter) |
-| `zenodo` | `search_zenodo`, `get_zenodo_record` | Zenodo |
-| `orcid` | `search_orcid`, `get_orcid_works` | ORCID |
-| `inspire-hep` | `search_inspire`, `get_inspire_paper` | INSPIRE-HEP (physics) |
-| `hal` | `search_hal` | HAL (French open archive) |
-| `osf-preprints` | `search_osf_preprints` | OSF Preprints |
-| `datacite` | `search_datacite`, `resolve_datacite_doi` | DataCite (dataset DOIs) |
-| `ror` | `search_ror` | ROR (research organizations) |
-
-### Community Attribution
-
-This project curates, organizes, and enhances publicly available academic resources from across the open-source ecosystem. We are grateful to the researchers, developers, and open-source communities whose work makes this collection possible.
-
-- **Skills** are authored guides based on established research methodologies, public API documentation, and widely-used academic workflows. Where content is derived from specific open-source projects, the `source` field in each SKILL.md frontmatter links to the original.
-- **Curated Lists** aggregate links to community resources and are provided for discovery purposes.
+> 此方式仅安装 SKILL.md 技能文件（无 API 工具），适用于 41 个支持 skills 协议的 Agent 框架。
 
-All original content in this repository is released under the [MIT License](LICENSE). Third-party projects referenced retain their own licenses.
+### 卸载
 
-### Contributing
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on adding skills and curated resources.
+```bash
+# OpenClaw / Research-Claw — 手动删除插件目录
+rm -rf ~/.openclaw/extensions/research-plugins
 
-### License
+# npx skills — 手动删除技能目录
+rm -rf .skills/wentorai/research-plugins
+```
 
-[MIT](LICENSE) -- Copyright (c) 2026 Wentor AI
+> **pnpm 项目注意**：请勿将本包作为 `pnpm` 依赖并通过 `plugins.load.paths` 从 `node_modules` 加载。pnpm 的硬链接机制会被 OpenClaw 安全校验拒绝 (`unsafe plugin manifest path`)。请始终使用 `openclaw plugins install`。
 
 ---
 
-<a id="中文"></a>
-
-## Research-Claw 科研插件集
-
-一个开源的学术科研资源集合，包含 **438 个科研技能**、**34 个智能体工具**（18 个 API 模块）和 **6 个精选资源列表**，为 [Research-Claw (科研龙虾)](https://wentor.ai) 及其他 AI 编程助手而构建。
-
-由 [Wentor AI](https://wentor.ai) 为全球科研社区打造。
-
-### 包含内容
-
-| 组件 | 数量 | 说明 |
-|------|------|------|
-| **技能 (Skills)** | 438 | 涵盖文献检索、学术写作、数据分析、研究方法、16 个学科领域及生产力工具的实用指南 |
-| **智能体工具** | 34 | 封装 18 个学术数据库 API 的 TypeScript 工具：OpenAlex、CrossRef、arXiv、PubMed、Unpaywall、Europe PMC、OpenCitations、DOAJ、DBLP、bioRxiv/medRxiv、OpenAIRE、Zenodo、ORCID、INSPIRE-HEP、HAL、OSF、DataCite、ROR |
-| **精选列表** | 6 | 按分类整理的优质资源推荐 |
-
-> **注意**：150 个 MCP 服务器配置已在 v1.4.0 审计中归档。参见 `archived/mcp-configs/`。
-
-### 分类体系
+## 包含什么
+
+### 学术技能（438 个）
+
+覆盖科研全流程的结构化 SKILL.md 指南，按需自动加载：
+
+| 类别 | 技能数 | 覆盖范围 |
+|:--|:--|:--|
+| **文献** (literature) | 87 | 多库联搜 · 引文追踪 · 全文获取 · 开放获取 |
+| **研究方法** (research) | 79 | DID · RDD · IV · 元分析 · 系统综述 · 基金申请 |
+| **数据分析** (analysis) | 68 | Python · R · STATA · 可视化 · 面板数据 · 计量经济 |
+| **学术写作** (writing) | 74 | 论文各章节 · LaTeX · 参考文献 · 审稿意见回复 |
+| **学科领域** (domains) | 93 | 16 个学科：CS · AI/ML · 生物医学 · 经济 · 法学 · 物理 等 |
+| **效率工具** (tools) | 51 | 流程图 · PDF 解析 · 知识图谱 · OCR · 爬虫 |
+
+技能通过 **渐进式加载** 机制工作：6 个类别入口 → 40 个子分类索引 → 438 个具体技能。Agent 按需加载，不会一次性注入全部内容。
+
+### 智能体工具（34 个）
+
+直连 18 个免费学术数据库 API 的 TypeScript 工具，作为 OpenClaw 插件自动注册：
+
+| 模块 | 工具 | 数据源 |
+|:--|:--|:--|
+| `openalex` | `search_openalex` · `get_work` · `get_author_openalex` | OpenAlex (250M+ 作品) |
+| `crossref` | `resolve_doi` · `search_crossref` | CrossRef (150M+ DOI) |
+| `arxiv` | `search_arxiv` · `get_arxiv_paper` | arXiv |
+| `pubmed` | `search_pubmed` · `get_article` | PubMed / NCBI |
+| `unpaywall` | `find_oa_version` | Unpaywall (开放获取) |
+| `europe-pmc` | `search_europe_pmc` · `get_epmc_citations` · `get_epmc_references` | Europe PMC (33M+) |
+| `opencitations` | `get_citations_open` · `get_references_open` · `get_citation_count` | OpenCitations (2B+ 引用) |
+| `dblp` | `search_dblp` · `search_dblp_author` | DBLP (7M+ CS 文献) |
+| `doaj` | `search_doaj` | DOAJ (9M+ OA 文章) |
+| `biorxiv` | `search_biorxiv` · `search_medrxiv` · `get_preprint_by_doi` | bioRxiv / medRxiv |
+| `openaire` | `search_openaire` | OpenAIRE (170M+, EU 资助筛选) |
+| `zenodo` | `search_zenodo` · `get_zenodo_record` | Zenodo |
+| `orcid` | `search_orcid` · `get_orcid_works` | ORCID |
+| `inspire-hep` | `search_inspire` · `get_inspire_paper` | INSPIRE-HEP (高能物理) |
+| `hal` | `search_hal` | HAL (法国开放档案) |
+| `osf-preprints` | `search_osf_preprints` | OSF Preprints |
+| `datacite` | `search_datacite` · `resolve_datacite_doi` | DataCite (数据集 DOI) |
+| `ror` | `search_ror` | ROR (研究机构) |
 
-技能按 **6 大类别** 和 **40 个子分类** 组织：
+### 精选资源（6 套）
 
-| 类别 | 子分类 | 技能数 | 覆盖范围 |
-|------|--------|--------|---------|
-| **文献 (literature)** | 检索、发现、全文获取、元数据 | 80 | 论文搜索、引文追踪、开放获取 |
-| **写作 (writing)** | 写作、润色、LaTeX、模板、引用 | 64 | 学术写作、LaTeX 排版、参考文献管理 |
-| **分析 (analysis)** | 统计、计量经济、数据处理、可视化 | 46 | 统计方法、数据清洗、图表制作 |
-| **研究 (research)** | 方法论、深度研究、论文评审、自动化、基金 | 53 | 研究设计、系统综述、基金申请 |
-| **学科 (domains)** | 16 个学科方向 | 147 | 各学科专属研究方法与工具 |
-| **工具 (tools)** | 图表、文档、代码执行、爬虫、知识图谱、OCR | 48 | 流程图、PDF 解析、可复现代码、OCR 翻译 |
+每个技能类别附带一套手工精选的优质资源列表，见 `curated/` 目录。
 
-### 安装方式
+---
 
-#### 作为 OpenClaw 插件（推荐）
+## 架构
 
-```bash
-openclaw plugins install @wentorai/research-plugins
 ```
-
-插件会安装到 `~/.openclaw/extensions/`，OpenClaw 自动发现并加载所有技能和工具。
-
-> **pnpm 项目注意**：请勿将本包作为 `pnpm` 依赖并通过 `plugins.load.paths` 从 `node_modules` 加载。pnpm 的内容寻址存储使用硬链接 (nlink > 1)，会被 OpenClaw 安全校验拒绝 (`unsafe plugin manifest path`)。请始终使用 `openclaw plugins install`。
-
-#### 作为技能集合 (Claude Code, Cursor, Windsurf, OpenCode)
-
-```bash
-npx skills add wentorai/research-plugins
+@wentorai/research-plugins
+├── skills/                    ← 438 SKILL.md (6 类别 × 40 子分类)
+│   ├── literature/            ← 文献检索/追踪/获取
+│   ├── writing/               ← 学术写作/引用/LaTeX
+│   ├── analysis/              ← 数据分析/统计/可视化
+│   ├── research/              ← 研究方法/综述/基金
+│   ├── domains/               ← 16 学科领域
+│   └── tools/                 ← 效率工具/图表/OCR
+├── src/tools/                 ← 34 API 工具 (18 模块)
+├── curated/                   ← 6 套精选资源列表
+├── catalog.json               ← 全量索引 (462 entries)
+├── index.ts                   ← 插件入口 (OpenClaw Plugin SDK)
+└── openclaw.plugin.json       ← 插件清单
 ```
 
-#### 通过 npm
+**加载方式**：
+- **Research-Claw / OpenClaw**：作为完整插件加载（技能 + API 工具），通过 `openclaw plugins install`
+- **其他 Agent 框架**：仅加载 SKILL.md 文件（无 API 工具），通过 `npx skills add`
 
-```bash
-npm install @wentorai/research-plugins
-```
+---
 
-### 社区致谢与声明
+## 社区致谢
 
-本项目对互联网上公开可用的学术资源进行了遴选、整理和增强。我们感谢所有使这个集合成为可能的研究者、开发者和开源社区。
+本项目对互联网上公开可用的学术资源进行了遴选、整理和增强。
 
-- **技能** 是基于成熟研究方法、公开 API 文档和广泛使用的学术工作流编写的实用指南。凡内容源自特定开源项目的，每个 SKILL.md 的 frontmatter 中 `source` 字段均标注了原始链接。
-- **精选列表** 汇集社区资源链接，仅供发现和参考之用。
+- **技能** 基于成熟研究方法、公开 API 文档和广泛使用的学术工作流编写。凡内容源自特定开源项目的，SKILL.md frontmatter 中 `source` 字段标注了原始链接。
+- **精选列表** 汇集社区资源链接，仅供发现和参考。
 
-本仓库中的所有原创内容均以 [MIT 许可证](LICENSE) 发布。引用的第三方项目保留其各自的许可证。
+所有原创内容以 [MIT 许可证](LICENSE) 发布。引用的第三方项目保留各自许可证。
+
+---
 
-### 参与贡献
+## 贡献
 
-请查阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解添加技能和精选资源的指南。
+请查阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解添加技能和资源的指南。
 
-### 许可证
+## 许可证
 
-[MIT](LICENSE) -- Copyright (c) 2026 Wentor AI
+[MIT](LICENSE) — Copyright (c) 2026 Wentor AI

package/openclaw.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "research-plugins",
-  "version": "1.4.0",
+  "version": "1.4.3",
   "name": "Research Plugins",
   "description": "438 academic research skills, 34 agent tools across 18 API modules & 6 curated lists for Research-Claw",
   "skills": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wentorai/research-plugins",
-  "version": "1.4.2",
+  "version": "1.4.4",
   "type": "module",
   "description": "438 academic research skills, 34 agent tools across 18 API modules, and 6 curated lists for Research-Claw and AI agents",
   "keywords": [

package/skills/literature/search/arxiv-api/SKILL.md

@@ -24,12 +24,21 @@ The API is free to use with no authentication required. It supports complex bool
 
 No authentication required. The arXiv API is fully open. However, users must respect the rate limit of 3 requests per second. Excessive usage may result in temporary IP-based blocking. Including a descriptive User-Agent header is considered good practice.
 
-## Core Endpoints
+## Using the `search_arxiv` Tool
+
+**IMPORTANT:** When calling the `search_arxiv` tool, use parameter name `query` (NOT
+`search_query`). The raw API uses `search_query`, but the tool wrapper accepts `query`.
+
+```
+search_arxiv({ query: "ti:transformer AND cat:cs.CL", sort_by: "submittedDate" })
+```
+
+## Core Endpoints (Raw API Reference)
 
 ### Query: Search for Articles
 
 - **URL**: `GET http://export.arxiv.org/api/query`
-- **Parameters**:
+- **Parameters** (raw API — the `search_arxiv` tool wraps these automatically):
   | Param | Type | Required | Description |
   |-------|------|----------|-------------|
   | search_query | string | Yes | Query string using arXiv field prefixes (ti, au, abs, cat, id) |

package/src/tools/arxiv.ts

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
-import { toolResult, trackedFetch, isTrackedError } from "./util.js";
+import { toolResult, trackedFetch, isTrackedError, validEnum, validParam } from "./util.js";
 
 const BASE = "https://export.arxiv.org/api/query";
 
@@ -103,17 +103,30 @@ export function createArxivTools(
           Type.String({ description: "Sort order: 'ascending' or 'descending'" }),
         ),
       }),
-      execute: async (input: {
+      execute: async (_toolCallId: string, input: {
         query: string;
         max_results?: number;
         sort_by?: string;
         sort_order?: string;
       }) => {
+        const query = validParam(input?.query);
+        if (!query) {
+          return toolResult({
+            error:
+              "query parameter is required and must not be empty. " +
+              "Use the tool parameter 'query' (not 'search_query'). " +
+              "Example: search_arxiv({ query: \"ti:transformer AND cat:cs.CL\" })",
+          });
+        }
+
+        const SORT_BY = ["relevance", "lastUpdatedDate", "submittedDate"] as const;
+        const SORT_ORDER = ["ascending", "descending"] as const;
+
         const params = new URLSearchParams({
-          search_query: input.query,
+          search_query: query,
           max_results: String(Math.min(input.max_results ?? 10, 50)),
-          sortBy: input.sort_by ?? "relevance",
-          sortOrder: input.sort_order ?? "descending",
+          sortBy: validEnum(input.sort_by, SORT_BY, "relevance"),
+          sortOrder: validEnum(input.sort_order, SORT_ORDER, "descending"),
         });
 
         const tracked = await trackedFetch("arxiv", `${BASE}?${params}`, undefined, 15_000);
@@ -150,7 +163,7 @@ export function createArxivTools(
           description: "arXiv paper ID, e.g. '2301.00001' or '2301.00001v2'",
         }),
       }),
-      execute: async (input: { arxiv_id: string }) => {
+      execute: async (_toolCallId: string, input: { arxiv_id: string }) => {
         if (!input?.arxiv_id) {
           return toolResult({ error: 'arxiv_id parameter is required (e.g., "2301.00001" or "2301.00001v2")' });
         }

package/src/tools/biorxiv.ts

@@ -1,6 +1,6 @@
 import { Type } from "@sinclair/typebox";
 import type { OpenClawPluginApi, OpenClawPluginToolContext } from "openclaw/plugin-sdk";
-import { toolResult, trackedFetch, isTrackedError } from "./util.js";
+import { toolResult, trackedFetch, isTrackedError, validEnum, validParam } from "./util.js";
 
 const BASE = "https://api.biorxiv.org";
 
@@ -23,16 +23,17 @@ export function createBiorxivTools(
           Type.Number({ description: "Pagination offset (default 0, each page returns up to 100)" }),
         ),
       }),
-      execute: async (input: { interval: string; cursor?: number }) => {
-        if (!input?.interval) {
+      execute: async (_toolCallId: string, input: { interval: string; cursor?: number }) => {
+        const interval = validParam(input?.interval);
+        if (!interval) {
           return toolResult({ error: 'interval parameter is required (date range in YYYY-MM-DD/YYYY-MM-DD format, e.g. "2026-03-01/2026-03-18")' });
         }
         // Validate date range format — bioRxiv API only accepts YYYY-MM-DD/YYYY-MM-DD
-        if (!/^\d{4}-\d{2}-\d{2}\/\d{4}-\d{2}-\d{2}$/.test(input.interval)) {
-          return toolResult({ error: `Invalid interval format "${input.interval}". Must be YYYY-MM-DD/YYYY-MM-DD (e.g. "2026-03-01/2026-03-18")` });
+        if (!/^\d{4}-\d{2}-\d{2}\/\d{4}-\d{2}-\d{2}$/.test(interval)) {
+          return toolResult({ error: `Invalid interval format "${interval}". Must be YYYY-MM-DD/YYYY-MM-DD (e.g. "2026-03-01/2026-03-18")` });
         }
-        const cursor = input.cursor ?? 0;
-        const tracked = await trackedFetch("biorxiv", `${BASE}/details/biorxiv/${input.interval}/${cursor}/json`, undefined, 30_000);
+        const cursor = input?.cursor ?? 0;
+        const tracked = await trackedFetch("biorxiv", `${BASE}/details/biorxiv/${interval}/${cursor}/json`, undefined, 30_000);
         if (isTrackedError(tracked)) return tracked;
         const data = await tracked.res.json();
 
@@ -76,15 +77,16 @@ export function createBiorxivTools(
           Type.Number({ description: "Pagination offset (default 0)" }),
         ),
       }),
-      execute: async (input: { interval: string; cursor?: number }) => {
-        if (!input?.interval) {
+      execute: async (_toolCallId: string, input: { interval: string; cursor?: number }) => {
+        const interval = validParam(input?.interval);
+        if (!interval) {
           return toolResult({ error: 'interval parameter is required (date range in YYYY-MM-DD/YYYY-MM-DD format, e.g. "2026-03-01/2026-03-18")' });
         }
-        if (!/^\d{4}-\d{2}-\d{2}\/\d{4}-\d{2}-\d{2}$/.test(input.interval)) {
-          return toolResult({ error: `Invalid interval format "${input.interval}". Must be YYYY-MM-DD/YYYY-MM-DD (e.g. "2026-03-01/2026-03-18")` });
+        if (!/^\d{4}-\d{2}-\d{2}\/\d{4}-\d{2}-\d{2}$/.test(interval)) {
+          return toolResult({ error: `Invalid interval format "${interval}". Must be YYYY-MM-DD/YYYY-MM-DD (e.g. "2026-03-01/2026-03-18")` });
         }
-        const cursor = input.cursor ?? 0;
-        const tracked = await trackedFetch("medrxiv", `${BASE}/details/medrxiv/${input.interval}/${cursor}/json`, undefined, 30_000);
+        const cursor = input?.cursor ?? 0;
+        const tracked = await trackedFetch("medrxiv", `${BASE}/details/medrxiv/${interval}/${cursor}/json`, undefined, 30_000);
         if (isTrackedError(tracked)) return tracked;
         const data = await tracked.res.json();
 
@@ -124,11 +126,11 @@ export function createBiorxivTools(
           Type.String({ description: "Server: 'biorxiv' or 'medrxiv' (default: biorxiv)" }),
         ),
       }),
-      execute: async (input: { doi: string; server?: string }) => {
+      execute: async (_toolCallId: string, input: { doi: string; server?: string }) => {
         if (!input?.doi) {
           return toolResult({ error: 'doi parameter is required (e.g., "10.1101/2024.01.15.575123")' });
         }
-        const server = input.server ?? "biorxiv";
+        const server = validEnum(input.server, ["biorxiv", "medrxiv"] as const, "biorxiv");
         const doi = input.doi.replace(/^https?:\/\/doi\.org\//, "");
         const tracked = await trackedFetch(server, `${BASE}/details/${server}/${doi}/na/json`, undefined, 15_000);
         if (isTrackedError(tracked)) return tracked;