SuperAPI AI Directory
Partner中文AI newsFavorites
Skillsopenclaw-research-paper-push-skill

openclaw-research-paper-push-skill

Writing & research

View repository

Updated 10-16 09:59

About this skill

OpenClaw Research Paper Push Skill

Skill by ara.so — Hermes Skills collection.

An OpenClaw AgentSkill that creates scheduled research paper alerts using OpenAlex API and OpenClaw's cron functionality. Monitors journals, conferences, and topics, then generates concise daily Chinese summaries of newly published papers.

What it does

  • Scheduled monitoring: Create cron-based subscriptions for research topics and venues
  • OpenAlex integration: Query real academic papers without API key requirements
  • Smart filtering: Match papers by research topics, journal names, or conferences
  • Deduplication: Track papers by DOI, OpenAlex ID, or title to avoid duplicates
  • State management: Persist last_checked timestamps locally
  • Chinese summaries: Generate daily digests with title, authors, venue, date, link, matched topics, and relevance scores

Installation

This is an OpenClaw AgentSkill. Install via ClawHub:

clawhub install research-paper-push

Or clone the repository:

git clone https://github.com/ZJunCher/openclaw-research-paper-push-skill.git
cd openclaw-research-paper-push-skill

Requirements

  • OpenClaw with AgentSkill and cron support
  • Python 3.x
  • Internet access for OpenAlex API
  • Optional: curl for environments without Python HTTPS support
  • Optional: Set OPENALEX_MAILTO environment variable for polite API usage
export OPENALEX_MAILTO="your-email@example.com"

Core script

All functionality is in scripts/manage_papers.py. Available commands:

  • add - Create a new subscription
  • list - Show all subscriptions
  • update - Modify an existing subscription
  • remove - Delete a subscription
  • test - Run a test query against OpenAlex
  • run - Execute a saved subscription immediately

Creating subscriptions

Basic subscription

python scripts/manage_papers.py add \
  --to "<recipient-id>" \
  --time "09:00" \
  --timezone "Asia/Shanghai" \
  --journals "NeuroImage,Medical Image Analysis,IEEE TMI" \
  --topics "Alzheimer,MCI,dynamic functional connectivity"

Multi-topic subscription

python scripts/manage_papers.py add \
  --to "<recipient-id>" \
  --time "08:30" \
  --timezone "UTC" \
  --journals "Nature Neuroscience,Human Brain Mapping,Cerebral Cortex" \
  --topics "graph neural network,rs-fMRI,fMRI,brain networks,neuroimaging"

Parameters

  • --to: Recipient identifier for OpenClaw notification
  • --time: Daily execution time (HH:MM format)
  • --timezone: Timezone for scheduling (e.g., "Asia/Shanghai", "America/New_York", "UTC")
  • --journals: Comma-separated journal/venue names (partial matching supported)
  • --topics: Comma-separated research topics for filtering

Managing subscriptions

List all subscriptions

python scripts/manage_papers.py list

Output shows subscription ID, recipient, schedule, journals, and topics.

Update a subscription

python scripts/manage_papers.py update \
  --id "1" \
  --time "10:00" \
  --journals "NeuroImage,Brain" \
  --topics "Alzheimer,connectivity,fMRI"

Remove a subscription

python scripts/manage_papers.py remove --id "1"

Testing queries

Before creating a subscription, test your filters:

python scripts/manage_papers.py test \
  --since "2026-01-01" \
  --limit 10 \
  --journals "NeuroImage,Human Brain Mapping" \
  --topics "Alzheimer,MCI,dynamic functional connectivity,rs-fMRI"

Test parameters

  • --since: Start date for paper search (YYYY-MM-DD format)
  • --limit: Maximum number of results to return
  • --journals: Same as subscription
  • --topics: Same as subscription

The test command performs a real OpenAlex query and shows how many papers match your criteria.

Running subscriptions manually

Execute a saved subscription on demand:

python scripts/manage_papers.py run --id "1" --limit 10

This is useful for:

  • Testing subscription output before scheduling
  • Backfilling papers since last check
  • Debugging filter criteria

OpenAlex query patterns

The skill queries OpenAlex with:

# Date-based filtering
from_publication_date = "YYYY-MM-DD"

# Full-text search for topics
search = "Alzheimer OR MCI OR dynamic functional connectivity"

# Venue filtering
filter = "primary_location.source.display_name:NeuroImage OR primary_location.source.display_name:Medical Image Analysis"

# Sorting by publication date (newest first)
sort = "publication_date:desc"

# Pagination
per_page = 100

Data storage

Local subscription state is stored in:

data/
  subscriptions.json   # All subscription configs
  paper_history.json   # Deduplication tracking
  last_checked.json    # Timestamp state

Important: Do not commit data/*.json files to version control. Add to .gitignore:

data/*.json

Common patterns

Monitoring specific research areas

# AD/MCI neuroimaging
python scripts/manage_papers.py add \
  --to "<recipient-id>" \
  --time "09:00" \
  --timezone "Asia/Shanghai" \
  --journals "NeuroImage,Alzheimer's & Dementia,Brain" \
  --topics "Alzheimer,mild cognitive impairment,amyloid,tau,neurodegeneration"

# Graph neural networks for brain analysis
python scripts/manage_papers.py add \
  --to "<recipient-id>" \
  --time "09:00" \
  --timezone "Asia/Shanghai" \
  --journals "Medical Image Analysis,IEEE TPAMI,NeuroImage" \
  --topics "graph neural network,brain network,connectome,graph learning"

Conference paper tracking

python scripts/manage_papers.py add \
  --to "<recipient-id>" \
  --time "09:00" \
  --timezone "America/New_York" \
  --journals "MICCAI,CVPR,NeurIPS,ICCV" \
  --topics "medical image analysis,brain segmentation,registration"

Weekly digest pattern

For less frequent updates, use the run command via external cron:

# In system crontab: Run every Monday at 9 AM
0 9 * * 1 cd /path/to/skill && python scripts/manage_papers.py run --id "1" --limit 50

Output format

The skill generates Chinese summaries with:

  • Title (Title): Paper title
  • Author (Authors): Author list
  • Journal/Conference (Venue): Publication venue
  • Publication Date (Date): Publication date
  • Link (Link): DOI or OpenAlex URL
  • Matched Topic (Matched topics): Which subscription topics matched
  • Relevance (Relevance): Match count or score

Example output structure:

### 论文1
- 标题: Dynamic Functional Connectivity in Alzheimer's Disease
- 作者: Zhang A, Li B, Wang C
- 期刊: NeuroImage
- 发表日期: 2026-05-10
- 链接: https://doi.org/10.1016/...
- 匹配主题: Alzheimer, dynamic functional connectivity
- 相关度: 2/5

Troubleshooting

No papers returned

  • Check date range: OpenAlex may have indexing delays. Use --since a few days earlier.
  • Verify journal names: Use exact or partial names as they appear in OpenAlex (e.g., "NeuroImage" not "Neuroimage").
  • Broaden topics: Try fewer or more general search terms.

HTTPS/SSL errors

If running in embedded Python without HTTPS:

# The script falls back to curl automatically
# Ensure curl is available:
which curl

Rate limiting

OpenAlex is generous but set polite headers:

export OPENALEX_MAILTO="your-email@example.com"

The script automatically adds a User-Agent and respects rate limits.

Duplicate papers

The skill tracks papers by:

  1. DOI (primary)
  2. OpenAlex ID (secondary)
  3. Title hash (fallback)

If duplicates appear, check data/paper_history.json for state corruption.

Subscription not running

Verify OpenClaw cron is active:

# Check OpenClaw cron status
openclaw cron status

# Manually trigger
python scripts/manage_papers.py run --id "1"

Advanced usage

Custom date ranges

# Last 7 days
python scripts/manage_papers.py test \
  --since "$(date -d '7 days ago' +%Y-%m-%d)" \
  --limit 20 \
  --journals "Nature,Science" \
  --topics "neuroimaging"

Combining multiple subscriptions

Create separate subscriptions for different research areas:

# Subscription 1: Alzheimer's research
python scripts/manage_papers.py add --to "<recipient-1>" --time "09:00" --journals "..." --topics "Alzheimer,MCI"

# Subscription 2: Deep learning methods
python scripts/manage_papers.py add --to "<recipient-2>" --time "10:00" --journals "..." --topics "deep learning,CNN,transformer"

Filtering by publication type

OpenAlex returns all types by default. For articles only, the script focuses on papers with DOIs and publication dates.

Integration with OpenClaw workflows

This skill is designed for OpenClaw's AgentSkill ecosystem. Once installed:

  1. OpenClaw cron manager schedules subscriptions
  2. At scheduled time, the skill queries OpenAlex
  3. Results are filtered and deduplicated
  4. Chinese summary is generated
  5. Notification is sent to recipient via OpenClaw messaging

Contributing

Repository: https://github.com/ZJunCher/openclaw-research-paper-push-skill

Report issues or suggest improvements via GitHub Issues.

License

MIT-0 — Free to use, modify, and distribute.