Tools
Ai4scholar
Forked AI4Scholar plugin for OpenClaw with local fixes
Install
openclaw plugins install ai4scholar
Configuration Example
{
"plugins": {
"entries": {
"ai4scholar": {
"enabled": true,
"config": {
"apiKey": "<your-api-key>"
}
}
}
}
}
README
# AI4Scholar
**Multi-source academic literature search, management, and analysis plugin for [OpenClaw](https://github.com/openclaw/openclaw).**
Powered by [ai4scholar.net](https://ai4scholar.net).
## What It Does
AI4Scholar gives your OpenClaw agent direct access to **6 academic platforms** through **36 built-in tools**.
### Platforms
| Platform | Coverage |
|----------|----------|
| **Semantic Scholar** | 200M+ papers across all fields |
| **PubMed** | Biomedical & life sciences |
| **Google Scholar** | Broad academic search |
| **arXiv** | Physics, CS, math, biology preprints |
| **bioRxiv** | Biology preprints |
| **medRxiv** | Health sciences preprints |
### Tools (36)
**Search (9)**
| Tool | Platform | Description |
|------|----------|-------------|
| `search_semantic` | Semantic Scholar | Search papers with year filtering |
| `search_pubmed` | PubMed | Biomedical papers, date range + sorting |
| `search_google_scholar` | Google Scholar | Broad academic search via ai4scholar proxy |
| `search_arxiv` | arXiv | Preprints search |
| `search_biorxiv` | bioRxiv | Biology preprints by category + date |
| `search_medrxiv` | medRxiv | Health preprints by category + date |
| `search_semantic_snippets` | Semantic Scholar | Full-text snippet search (~500 word excerpts) |
| `search_semantic_bulk` | Semantic Scholar | Bulk search, up to 1000 results with pagination |
| `search_semantic_paper_match` | Semantic Scholar | Exact title matching |
**Paper Details & Batch (4)**
| Tool | Description |
|------|-------------|
| `get_semantic_paper_detail` | Paper metadata by ID (DOI, arXiv ID, PMID, etc.) |
| `get_pubmed_paper_detail` | PubMed paper metadata by PMID |
| `get_semantic_paper_batch` | Batch paper details (up to 500) |
| `get_pubmed_paper_batch` | Batch PubMed details |
**Citations & References (4)**
| Tool | Description |
|------|-------------|
| `get_semantic_citations` | Papers citing the given paper |
| `get_semantic_references` | Papers referenced by the given paper |
| `get_pubmed_citations` | PubMed citation lookup |
| `get_pubmed_related` | PubMed related papers |
**Authors (5)**
| Tool | Description |
|------|-------------|
| `search_semantic_authors` | Search authors by name |
| `get_semantic_author_detail` | Author profile (h-index, papers, citations) |
| `get_semantic_author_papers` | All papers by an author |
| `get_semantic_author_batch` | Batch author details (up to 1000) |
| `get_semantic_paper_authors` | All authors of a paper |
**Recommendations (2)**
| Tool | Description |
|------|-------------|
| `get_semantic_recommendations` | Recommend papers from positive/negative examples |
| `get_semantic_recommendations_for_paper` | Similar papers for a single paper |
**PDF Download & Full-Text Reading (10)**
| Tool | Description |
|------|-------------|
| `download_semantic` | Open access PDF URL from Semantic Scholar |
| `read_semantic_paper` | Download + extract full text (Semantic Scholar) |
| `download_arxiv` | arXiv PDF URL |
| `read_arxiv_paper` | Download + extract full text (arXiv) |
| `download_biorxiv` | bioRxiv PDF URL |
| `download_medrxiv` | medRxiv PDF URL |
| `read_biorxiv_paper` | Download + extract full text (bioRxiv) |
| `read_medrxiv_paper` | Download + extract full text (medRxiv) |
| `download_by_doi` | Download PDF by DOI (supports institutional access) |
| `read_by_doi` | Download + extract full text by DOI |
**Auto-Citation (1)**
| Tool | Description |
|------|-------------|
| `auto_cite` | One-click citation annotation: add real references to academic text (IEEE/APA/Vancouver/Nature styles) |
**Scientific Drawing (1)**
| Tool | Description |
|------|-------------|
| `sci_draw` | AI-powered scientific figure generation (text-to-image, edit, style transfer, SVG, critique) |
### Slash Commands
| Command | Description |
|---------|-------------|
| `/library` | List downloaded papers in the active project |
| `/projects` | List all literature projects |
| `/reading-list` | Show the reading list |
## Install
### From npm (recommended)
```bash
openclaw plugins install ai4scholar
```
After installation, **restart the gateway**:
```bash
openclaw gateway stop && openclaw gateway start
```
### Update
```bash
openclaw plugins update ai4scholar
```
### Verify
```bash
openclaw plugins list
# Should show: ai4scholar (enabled)
```
## Configuration
Set your API key in `openclaw.json`:
```json
{
"plugins": {
"entries": {
"ai4scholar": {
"enabled": true,
"config": {
"apiKey": "<your-api-key>"
}
}
}
}
}
```
Get your API key at [ai4scholar.net](https://ai4scholar.net?src=openclaw).
## Usage
Just talk to your OpenClaw agent:
```
Search for recent papers on CRISPR in cancer immunotherapy
```
```
Read the full text of arXiv:2401.12345 and summarize the Methods section
```
```
Add citations to this Introduction paragraph: <paste text>
```
```
Give me a literature survey on protein folding methods since 2020
```
For detailed usage, visit [ai4scholar.net](https://ai4scholar.net?src=openclaw).
## Project Structure
```
ai4scholar/
โโโ src/
โ โโโ tools/
โ โ โโโ api-client.ts # HTTP client for ai4scholar.net
โ โ โโโ semantic-scholar.ts # 17 Semantic Scholar tools
โ โ โโโ pubmed.ts # 5 PubMed tools
โ โ โโโ google-scholar.ts # Google Scholar search
โ โ โโโ arxiv.ts # 3 arXiv tools
โ โ โโโ biorxiv.ts # 6 bioRxiv/medRxiv tools
โ โ โโโ doi-download.ts # 2 DOI-based download tools
โ โ โโโ auto-cite.ts # Auto-citation via ai4scholar API
โ โ โโโ sci-draw.ts # Scientific figure generation
โ โ โโโ pdf-utils.ts # PDF download & text extraction
โ โ โโโ result.ts # Tool result helpers
โ โ โโโ params.ts # Parameter parsing
โ โโโ hooks/
โ โ โโโ scholar-mode.ts # Scholar mode system prompt
โ โโโ commands.ts # Slash commands
โโโ openclaw.plugin.json
โโโ index.ts
```
## License
MIT
tools
Comments
Sign in to leave a comment