paper-repo-helper

name	paper-repo-helper
description	论文仓库自动化工具集 — 搜索论文、下载 PDF、生成 README、Git 同步
metadata	{"openclaw":{"requires":{"bins":["uv","git","gh"],"env":["OPENROUTER_API_KEY"]}}}

论文仓库助手工具集

自动化管理 GitHub 论文仓库：OpenAlex + arXiv 搜索 → PDF 下载 → README 生成 → Git 同步。

环境变量

变量	必需	说明
OPENROUTER_API_KEY	是	OpenRouter API Key（用于 banner 图片生成）
GITHUB_TOKEN	否	GitHub Token（gh CLI 认证，可通过 gh auth login 替代）

数据目录

所有工作数据位于 ~/.openclaw/workspace/paper-repos/：

文件/目录	说明
repos.json	全局仓库注册表
<slug>/config.json	仓库配置（标题、分类、语言等）
<slug>/papers.jsonl	论文元数据（JSONL 格式）
<slug>/seen-ids.md	已见 ID（去重）
<slug>/keywords.md	搜索关键词
<slug>/scope.conf	搜索范围配置
<slug>/git-repo/	Git 仓库工作目录

脚本调用

初始化仓库

export PATH=$HOME/.local/bin:$PATH
cd {baseDir}
uv run python3 repo-init.py \
  --slug awesome-gr-papers \
  --title "Awesome Generative Recommendation Papers" \
  --description "A curated list of papers on generative recommendation" \
  --language zh \
  --categories '["Survey", "Semantic IDs", "Architecture", "Others"]' \
  --keywords "generative recommendation,semantic id,generative retrieval"

搜索论文

export PATH=$HOME/.local/bin:$PATH
cd {baseDir}
uv run python3 repo-collect.py \
  --repo-dir ~/.openclaw/workspace/paper-repos/<slug> \
  --limit 20

下载 PDF

export PATH=$HOME/.local/bin:$PATH
cd {baseDir}
uv run python3 repo-download.py \
  --repo-dir ~/.openclaw/workspace/paper-repos/<slug> \
  --git-dir ~/.openclaw/workspace/paper-repos/<slug>/git-repo \
  --max-downloads 20 \
  --proxy http://127.0.0.1:7890

生成 README

export PATH=$HOME/.local/bin:$PATH
cd {baseDir}
uv run python3 repo-readme.py \
  --repo-dir ~/.openclaw/workspace/paper-repos/<slug> \
  --git-dir ~/.openclaw/workspace/paper-repos/<slug>/git-repo \
  --mode generate

Git 同步

export PATH=$HOME/.local/bin:$PATH
cd {baseDir}
uv run python3 repo-sync.py \
  --git-dir ~/.openclaw/workspace/paper-repos/<slug>/git-repo \
  --message "Update papers" \
  --proxy http://127.0.0.1:7890

提取关键词（从已有论文标题分析）

export PATH=$HOME/.local/bin:$PATH
cd {baseDir}
uv run python3 repo-extract-keywords.py \
  --repo-dir ~/.openclaw/workspace/paper-repos/<slug>

脚本输出论文标题的分类统计、高频词汇和建议关键词到 stdout。请基于输出结果用你的领域知识生成精准的搜索关键词，写入 keywords.md。

加 --write-suggestions 可将基础建议自动追加到 keywords.md（仍需你审核确认）。

自动更新（组合脚本）

export PATH=$HOME/.local/bin:$PATH
cd {baseDir}
uv run python3 repo-auto-update.py \
  --base-dir ~/.openclaw/workspace/paper-repos \
  --proxy http://127.0.0.1:7890

生成 Banner 图片

export PATH=$HOME/.local/bin:$PATH
cd {baseDir}
uv run python3 generate_image.py \
  --prompt "A futuristic banner for awesome generative recommendation papers collection" \
  --output ~/.openclaw/workspace/paper-repos/<slug>/git-repo/banner.png \
  --proxy http://127.0.0.1:7890

Cron 配置

Job	调度	说明
paper-repo-update	0 6 * * *	自动更新所有仓库