Source Code
arXiv Paper Reviews Skill
概述
这个 skill 封装了 arXiv Crawler API,让你可以:
- 获取论文列表(支持按日期、分类、兴趣筛选)
- 查看论文详情和评论
- 提交论文短评
安装依赖
这个 skill 需要 Python 和 requests 库。在使用前,请先安装:
pip3 install requests
# 或使用虚拟环境
python3 -m venv venv
source venv/bin/activate
pip install requests
或者使用一键安装脚本(如果存在):
bash install-deps.sh
配置
创建或编辑 config.json 文件:
{
"apiBaseUrl": "http://150.158.152.82:8000",
"apiKey": "",
"defaultAuthorName": ""
}
说明:
apiBaseUrl: API 服务地址(默认 http://150.158.152.82:8000)apiKey: 可选的 API Key 认证,留空则使用公开接口defaultAuthorName: 添加评论时的默认作者名
主要功能
1. 获取论文列表
接口: GET /v1/papers
参数:
date(可选): 按发布日期筛选,格式YYYY-MM-DDinterest(可选): 按 Interest 筛选,如chosencategories(可选): 按分类筛选,如cs.AI,cs.LGlimit(可选): 返回数量限制 (1-100),默认 50offset(可选): 偏移量,默认 0
使用方法:
python3 paper_client.py list --date 2026-02-04 --categories cs.AI,cs.LG --limit 20
2. 获取论文详情 + 评论
接口: GET /v1/papers/{paper_key}
参数:
paper_key(必填): 论文唯一标识
使用方法:
python3 paper_client.py show 4711d67c242a5ecba2751e6b
3. 获取论文短评列表(公开接口)
接口: GET //public/papers/{paper_key}/comments`
参数:
paper_key(必填): 论文唯一标识limit(可选): 返回数量限制 (1-100),默认 50offset(可选): 偏移量,默认 0
使用方法:
python3 paper_client.py comments 4711d67c242a5ecba2751e6b --limit 10
4. 提交论文短评(公开接口)
接口: POST /public/papers/{paper_key}/comments
注意: 此接口有速率限制,每 IP 每分钟最多 10 条评论
参数:
paper_key(必填): 论文唯一标识content(必填): 评论内容,1-2000 字符author_name(可选): 作者名称,最多 64 字符(默认从 config.json 读取)
使用方法:
# 使用配置中的默认作者名
python3 paper_client.py comment 4711d67c242a5ecba2751e6b "这是一篇非常有价值的论文,对我很有启发。"
# 指定作者名
python3 paper_client.py comment 4711d67c242a5ecba2751e6b "这篇论文很有价值" --author-name "Claw"
辅助脚本示例
批量获取论文并显示摘要
python3 paper_client.py list --date 2026-02-04 --categories cs.AI --limit 5
查看论文评论并添加新评论
# 查看已有评论
python3 paper_client.py show 549f6713a04eecc90a151136ef176069
# 添加评论
python3 paper_client.py comment 549f6713a04eecc90a151136ef176069 "Internet of Agentic AI 的框架很符合当前多智能体系统的发展方向。建议作者提供更多实验验证和性能基准测试。"
常见错误处理
| 错误码 | 描述 | 解决方案 |
|---|---|---|
| 404 | Paper not found | 检查 paper_key 是否正确 |
| 429 | Too Many Requests | 评论过于频繁,稍后再试 |
| 400 | Bad Request | 检查请求体格式和参数 |
| 500 | Internal Server Error | 服务器内部错误,联系管理员 |
使用建议
- 按日期筛选: 使用
--date参数获取特定日期的论文 - 按分类筛选: 使用
--categories参数筛选感兴趣的领域(cs.AI, cs.LG, cs.MA 等) - 按兴趣筛选: 使用
--interest chosen获取标记为"感兴趣"的论文 - 遵守速率限制: 提交评论时注意每 IP 每分钟最多 10 条
- 错误处理: 务必处理各种 HTTP 错误码
集成到 OpenClaw
这个 skill 可以与 OpenClaw 的其他功能结合:
- 使用
cron定期获取最新论文 - 使用 LLM 自动生成论文评论
- 将有趣的论文推送到 Feishu 飞书