name: arxiv-paper-searcher
description: 搜索并分析 arXiv 学术论文。默认执行“搜索 + 摘要分析 + 热点统计 + 趋势判断”的完整流程，并立即返回结构化报告。用户确认后，可基于同一检索条件创建 OpenClaw cron 定时监控任务，定期推送最新论文分析。
版本：v1.0.2
用于搜索、整理并分析 arXiv 学术论文的技能。
该技能的默认行为是一次性完成完整流程，也就是搜索 + 分析 + 报告输出。
定时监控不是默认步骤，只有在用户明确同意后才创建。
当用户有以下需求时触发本技能：
触发示例
除非用户明确指定，否则使用以下默认值：
20dateAsia/ShanghaisessionTarget: "current"如果用户只说“查一下某个方向的论文”，应直接执行，不要为了数量或排序方式反复追问。
这是默认模式。用户提供主题后，直接完成搜索与分析，并返回完整报告。
> ✅ 已完成本次 arXiv 论文搜索与分析。
> 如需持续跟踪这一主题，我可以为你创建定时监控任务，按固定时间自动推送最新论文分析。
> 你只要回复“可以”或直接告诉我推送时间即可。
只有在用户明确表示需要持续跟踪时，才进入此模式。
Step 1：确认检索配置
优先复用刚才单次执行时的参数：
若用户明确要求修改，再更新配置。
Step 2：确认推送时间
可引导用户选择常见时间，也支持自定义：
> 好的，我来帮你设置定时推送。
> 你可以直接告诉我一个时间，例如
>
> * 每天早上 9 点
>
> * 每周一上午 9 点
>
> * 每周三晚上 8 点
>
> * 其他你希望的具体时间
Step 3：先保存业务配置
在创建定时任务前，把查询参数保存到技能自己的 config.json：
keywordmax_resultssorttimezone这里的 config.json 只保存业务配置与绑定信息，不充当调度真相源。
Step 4：创建 OpenClaw cron 任务
创建规则：
openclaw cron add/edit/removesessionTarget: "current"isolated~/.openclaw/cron/jobs.jsonStep 5：回写 job 绑定信息
创建成功后，把返回的 jobId 写回技能配置：
job.job_idjob.namejob.enabledjob.session_targetjob.schedule.kindjob.schedule.exprjob.schedule.tzStep 6：告知用户任务已创建成功并提醒会话绑定
用户能得到两层确认：
job_id同时必须补充提醒：
用户后续可以直接说：
处理原则：
config.json 里的 job 快照schedule 但没有 job_id，应视为“仅有旧配置，不代表存在真实定时任务”不要只返回论文链接或标题列表。
只要执行了搜索，就必须继续完成分析和总结。
对于数量、排序、输出格式等非关键信息，优先使用默认值，不要频繁追问。
不要在搜索前就询问是否需要定时。
应先完成本次报告，再询问用户是否希望持续监控。
不能只依赖标题或简单关键词匹配。
每篇论文至少要阅读标题和摘要后再判断研究热点与创新性。
趋势结论基于当前检索结果，不等同于整个领域的完整学术图景。
需要给出合理推断，但不要过度下结论。
OpenClaw cron 才是定时任务的调度真相源。
技能本地 config.json 只负责保存业务配置和 job_id 绑定信息。
对于“在同一个聊天里持续推送论文更新”的场景，默认用 sessionTarget: "current"。
只有在用户明确需要隔离上下文、独立 delivery 或不同投递目标时，才考虑 isolated。
只要成功创建了 sessionTarget: "current" 的监控任务，就必须提醒用户：
从摘要中提取论文主要关注的问题、方法或应用方向，例如：
按以下标准给出 高 / 中 / 低：
提出新架构、新理论、新训练范式，或明显突破现有方法边界
在已有方法上做重要改进，或将成熟方法迁移到新任务并取得较强效果
主要是实验复现、应用验证、工程整合、综述或资源整理
将相近主题聚类归并，统计高频方向，输出 Top 10。
结合论文发布时间、主题分布和方法变化，给出 3 到 5 条趋势判断。
趋势描述应具体，避免泛泛而谈。
## 论文列表
### 1. [Paper Title]
- **作者**：Author A, Author B
- **时间**：2026-03-17
- **关注热点**：xxx、xxx、xxx
- **创新性**：高
- **链接**：arXiv / PDF
### 2. [Paper Title]
- **作者**：...
- **时间**：...
- **关注热点**：...
- **创新性**：中
- **链接**：...
## 热点研究方向 Top 10
1. 方向名称（出现次数）
2. 方向名称（出现次数）
3. ...
## 趋势判断
1. ...
2. ...
3. ...
python ~/.openclaw/workspace/skills/arxiv-paper-searcher/scripts/arxiv_search.py \
-q "ti:gnn OR ti:\"graph neural network\"" \
-m 20 \
-s date \
-o ~/.openclaw/workspace/skills/arxiv-paper-searcher/papers.json
| 参数 | 说明 | 默认值 |
|---|---|---|
| -------------- | ------------------------------------ | ------ |
-q, --query | 搜索关键词，支持 arXiv 查询语法 | 必填 |
-m, --max | 最大返回数量 | 20 |
-o, --output | 输出 JSON 文件路径 | 可选 |
-s, --sort | 排序方式，支持 date、updated、relevance | date |
用户检索配置保存在：
~/.openclaw/workspace/skills/arxiv-paper-searcher/config.json
v1.1 的推荐结构：
{
"schema_version": 2,
"keyword": "ti:gnn OR ti:\"graph neural network\"",
"max_results": 20,
"sort": "date",
"timezone": "Asia/Shanghai",
"job": {
"job_id": "job-123",
"name": "arXiv Monitor · GNN",
"enabled": true,
"session_target": "current",
"schedule": {
"kind": "cron",
"expr": "0 9 * * *",
"tz": "Asia/Shanghai"
},
"bound_at": "2026-04-05T09:00:00+08:00",
"updated_at": "2026-04-05T09:00:00+08:00",
"notes": null
},
"updated_at": "2026-04-05T09:00:00+08:00"
}
创建每日论文监控时，推荐任务形态如下：
{
"name": "arXiv Monitor · GNN",
"schedule": {
"kind": "cron",
"expr": "0 9 * * *",
"tz": "Asia/Shanghai"
},
"sessionTarget": "current",
"payload": {
"kind": "agentTurn",
"message": "请使用当前技能的已保存配置执行一次完整 arXiv 监控流程。检索关键词是 ti:gnn OR ti:\"graph neural network\"。返回数量是 20。排序方式是 date。时区按 Asia/Shanghai 处理。请先搜索最新论文，再基于标题和摘要逐篇分析，最后输出完整结构化报告。报告必须包含论文列表、每篇论文的关注热点、创新性评估、热点研究方向 Top 10，以及 3 到 5 条趋势判断。"
}
}
说明：
sessionTarget: "current" 适合把结果发回创建任务的当前会话isolated + announcejobs.jsonscripts/arxiv_search.pyarXiv 论文搜索脚本
scripts/config_manager.py 查询配置与 job_id 绑定管理
scripts/openclaw_cron_builder.py 构造 cron.add / cron.update JSON 载荷
保存业务配置：
python scripts/config_manager.py --save \
--keyword 'ti:gnn OR ti:"graph neural network"' \
--max 20 \
--sort date \
--timezone Asia/Shanghai
绑定新建的 cron job：
python scripts/config_manager.py --bind-job \
--job-id 'job-123' \
--job-name 'arXiv Monitor · GNN' \
--session-target current \
--schedule-kind cron \
--schedule-expr '0 9 * * *' \
--timezone Asia/Shanghai
解绑本地记录：
python scripts/config_manager.py --unbind-job
构造 cron.add 载荷：
python scripts/openclaw_cron_builder.py \
--build-add \
--session-target current \
--schedule-kind cron \
--cron '0 9 * * *' \
--tz Asia/Shanghai
构造 cron.update 载荷：
python scripts/openclaw_cron_builder.py \
--build-update \
--job-id 'job-123' \
--session-target current \
--schedule-kind cron \
--cron '0 8 * * 1' \
--tz Asia/Shanghai
pip install arxiv
config.json 当成真正的调度器~/.openclaw/cron/jobs.json共 1 个版本