1. 为什么要在 OpenClaw 里接 AMiner 学术检索 Skill如果你正在做科研自动化、文献监控或者学术问答机器人大概率会遇到一个尴尬通用大模型能聊学术但它拿不到实时、结构化的论文与学者数据。你问它「Yann LeCun 最近发了哪些论文」它可能给你编一个看起来很像真的标题。要解决这个问题就得把真实的学术数据源接进你的 Agent 流程里。AMiner 开放平台提供学者画像、论文搜索、引用链、机构研究力、期刊监控、专利检索等接口而 OpenClaw 是一个可以挂载 Skill 的 Agent 运行环境。把两者拼起来你就能在飞书、钉钉这类即时通讯工具里用一句自然语言触发真实的学术 API 调用。这篇要讲的就是 AMiner 开放平台 OpenClaw 的 Skill 集成实践重点放在 API Token 的环境变量写法、可复制的 Skill 配置片段以及一段 python3 调用示例最后跑一次从鉴权到返回结果的完整验证。适合谁看需要把学术数据检索接入自动化流程的开发者已经在用 OpenClaw 但还没接外部数据源的想基于 AMiner 全 API 能力定制自己学术 Skill 的人。前置条件只有一个——本机装好 python3这个 Skill 除了 python3 没有额外依赖。你可以先用python3 --version确认一下输出类似Python 3.10.12就行。整条链路的逻辑其实很朴素OpenClaw 负责识别你的意图Skill 负责把意图翻译成 AMiner 的 API 请求API Token 负责鉴权python3 负责实际发请求和解析返回。任何一环断了你都会看到报错而不是结果。所以下面我会按「配 Token → 装 Skill → 写配置 → 验证 → 排障」的顺序来每一步都给可复制的内容。2. 前置准备AMiner API Token 与 OpenClaw 环境先说 Token。AMiner 开放平台的 API 需要账号充值过一定数量的 Token 才能调用这一步绕不过去。流程是访问 AMiner 控制台登录或注册进入密钥生成页面粘贴生成的密钥到 API Key 输入框填写过期时间点击开始生成然后复制生成的 Token。这里有两个坑必须提前说。第一平台不会保存你的 Token生成后必须立刻复制关掉页面就找不回来了。第二Token 有时效性过期后所有调用都会失败需要定期重新生成并更新环境变量。我建议你把过期时间设得比实际使用周期长一点同时在日历里加个提醒。拿到 Token 后配置到 OpenClaw 的环境变量里。命令是openclaw config set env.vars.AMINER_API_KEY your-api-key把your-api-key换成你刚复制的真实 Token。注意这里一定要手动配置不要让 OpenClaw 帮你自动填避免 Token 在日志或对话记录里泄露。这是官方文档里明确强调的一点我实测下来也确实如此——手动配置最可控。配置完可以用下面的命令确认环境变量写进去了openclaw config get env.vars.AMINER_API_KEY如果输出是你的 Token或者脱敏后的值说明写入成功。如果输出为空或者报 key 不存在说明上一条命令没生效检查一下是不是拼错了AMINER_API_KEY这个变量名大小写要完全一致。接下来是 Skill 本身。项目地址是https://github.com/CanXiangCC/aminer-open-skill.git你可以用 OpenClaw、Coze 或 Defy 安装。在 OpenClaw 里直接对它说你帮我安装一下这个 skill 吧https://github.com/CanXiangCC/aminer-open-skill.gitOpenClaw 会拉取仓库并注册 Skill。安装完成后Skill 会暴露学者信息查询、论文搜索与分析、机构研究力分析、期刊论文监控、学术智能搜索、专利搜索这几类能力。这些能力背后都是 AMiner 开放平台的 APISkill 只是做了一层意图到接口的映射。3. 可复制的 Skill 配置片段与 python3 调用示例这一节是核心给你可以直接抄的配置和代码。先看 Skill 的配置结构。OpenClaw 的 Skill 通常用一个配置文件描述元信息、依赖和入口下面是一个可参考的片段路径按你实际安装位置调整{ name: aminer-data-search, version: 1.0.0, description: AMiner 学术数据检索 Skill支持学者、论文、机构、期刊、专利查询, runtime: python3, entry: aminer_skill.py, env: { AMINER_API_KEY: ${AMINER_API_KEY} }, actions: [ { name: search_scholar, description: 查询学者画像、论文、专利、项目, params: [name] }, { name: search_paper, description: 按标题或关键词搜索论文, params: [query] }, { name: search_patent, description: 搜索专利, params: [query] } ] }关键点是env里引用了${AMINER_API_KEY}这样 Skill 运行时就能从 OpenClaw 的环境变量里读到 Token而不是把密钥硬编码进代码。如果你用的是 TOML 风格的配置等价写法是[skill] name aminer-data-search runtime python3 entry aminer_skill.py [skill.env] AMINER_API_KEY ${AMINER_API_KEY} [[skill.actions]] name search_scholar description 查询学者画像 params [name]两种写法选一种即可取决于你的 OpenClaw 版本支持哪种。配置里出现的三件套要记牢Base URL、Key、Model ID。AMiner 这边 Base URL 是开放平台的 API 地址Key 就是你的AMINER_API_KEYModel ID 在 Skill 场景里对应的是你要调用的具体接口名比如search_scholar。这三者缺一不可后面排障时也主要围绕它们。再给一段 python3 调用示例方便你在不依赖 OpenClaw 的情况下先验证 Token 和接口是否通。这段代码只依赖标准库符合 Skill「除 python3 无额外依赖」的设定import os import json import urllib.request API_KEY os.environ.get(AMINER_API_KEY) BASE_URL https://api.aminer.cn/api def search_scholar(name): if not API_KEY: raise RuntimeError(缺少 token请先配置 AMINER_API_KEY 环境变量) url f{BASE_URL}/search/person?name{urllib.parse.quote(name)} req urllib.request.Request(url) req.add_header(Authorization, fBearer {API_KEY}) req.add_header(Content-Type, application/json) with urllib.request.urlopen(req, timeout15) as resp: return json.loads(resp.read().decode(utf-8)) if __name__ __main__: result search_scholar(Andrew Ng) print(json.dumps(result, ensure_asciiFalse, indent2))运行前先导出环境变量export AMINER_API_KEYyour-api-key python3 aminer_demo.py如果你在 Windows 上用set AMINER_API_KEYyour-api-key或者 PowerShell 的$env:AMINER_API_KEYyour-api-key。这段代码的作用是绕过 OpenClaw直接验证「Token 有效 接口可达 返回可解析」这三件事。如果它能跑通说明底层链路没问题剩下的就是 OpenClaw 的意图识别和 Skill 映射了。4. 验证请求从鉴权到返回结果的完整动作配置写完必须做一次端到端验证否则你永远不知道是 Token 问题、网络问题还是 Skill 映射问题。验证分两层先用 python3 直连验证再在 OpenClaw 里用自然语言验证。第一层跑上面那段aminer_demo.py。预期结果是终端打印出一段 JSON里面包含 Andrew Ng 的学者信息比如姓名、机构、论文数等字段。如果看到{code: 200, ...}或者直接是数据体说明鉴权和请求都通了。如果看到401或Unauthorized说明 Token 无效或过期回控制台重新生成。如果看到缺少 token说明环境变量没读到检查echo $AMINER_API_KEY有没有输出。第二层在 OpenClaw 里验证。安装完 Skill 后在你接入 OpenClaw 的即时通讯工具里比如飞书、钉钉直接发一句帮我查一下 Andrew Ng 的学者信息OpenClaw 会自动识别意图并调用 AMiner API 返回结果。你可以再试几个不同场景确认 Skill 的意图映射覆盖到位场景示例提示词查学者查一下 Yann LeCun 的学者画像搜论文搜索 BERT 相关论文看引用Attention is all you need 这篇论文引用了哪些文章分析机构清华大学的 AI 研究实力如何监控期刊NeurIPS 2023 有哪些论文学术问答最近蛋白质结构预测有什么新进展查专利搜索大语言模型相关专利如果这些提示词都能返回结构化结果说明链路完全跑通。我实测下来最容易出问题的是「看引用」这类需要二次解析的场景因为它依赖前一步返回的论文 ID如果 Skill 没做好参数传递就会返回空结果。遇到这种情况先确认单步查询是否正常再排查 Skill 的参数映射逻辑。验证通过后你还可以基于 AMiner 开放平台的全 API 能力定制自己的 Skill。比如定制特定领域的查询逻辑、添加领域专用的输出格式、组合多个 API 形成更复杂的科研检索任务。这才是这套方案真正的价值——不是用一个现成 Skill而是把它当模板改造成你自己的学术助手。5. 常见报错排查401、缺少 token 与 local proxy failed排障这一节按真实报错来对照你遇到哪个就查哪个。报错一缺少 token或missing token。这是最高频的问题。先确认环境变量配了没有openclaw config get env.vars.AMINER_API_KEY如果为空重新执行openclaw config set env.vars.AMINER_API_KEY your-api-key。如果配置了还是提示缺少 token重启 OpenClaw Gatewayopenclaw gateway restart openclaw doctor --fixdoctor --fix会尝试修复常见的配置问题。重启后如果还不行检查 Skill 配置里的env字段有没有正确引用${AMINER_API_KEY}有时候是 Skill 自己没读到环境变量而不是环境变量没配。报错二401 Unauthorized。这说明 Token 被读到了但服务端不认。原因通常是 Token 过期、Token 复制时带了空格、或者 Token 对应的账号没有充值到可调用的额度。回 AMiner 控制台确认 Token 状态重新生成一个注意复制时不要多选空格或换行。部分 API 需要付费如果账号额度不足也会表现为鉴权失败或权限不足。报错三local proxy failed或连接超时。这类报错指向网络层。先确认本机能正常访问 AMiner 的 API 地址可以用curl -I https://api.aminer.cn/api看返回码。如果是公司内网或防火墙限制需要联系网络管理员放行。注意这里不涉及任何网络工具的使用纯粹是检查你的网络出口是否可达目标域名。报错四reading choices或返回体解析失败。这种报错通常出现在 Skill 拿到 API 返回后解析字段时。AMiner 不同接口返回结构不一样如果 Skill 里写死了某个字段路径换个接口就会解析失败。排查方法是先用 python3 直连打印原始返回确认字段名再对照 Skill 的解析代码。如果返回体是空的检查请求参数有没有拼错比如学者名里的空格有没有做 URL 编码。报错五OAuth 相关错误。如果你在配置里混用了 OAuth 流程和 API Key 流程会出现这类报错。AMiner 开放平台这里用的是 API Token 鉴权不需要 OAuth。检查你的配置里有没有多余的 OAuth 字段删掉即可。三件套 Base URL、Key、Model ID 里Key 就是 API Token不要填成别的凭证。更新 Skill。如果 Skill 有更新直接对 OpenClaw 说帮我更新下 skill 吧https://github.com/CanXiangCC/aminer-open-skill.git各类 OpenClaw 都支持这种更新方式。更新后建议重新跑一次验证请求确认接口映射没有变化。6. 把学术检索接进你的自动化流程链路跑通之后真正的玩法才开始。你可以把这个 Skill 挂到定时任务里做期刊监控比如每天早上自动查一遍 NeurIPS 的最新论文也可以组合多个 API先搜论文再查引用链生成一份领域综述草稿还可以把学者画像查询接到你的 CRM 或知识库里自动补全专家信息。如果你需要更稳定的长期编码和 Agent 运行环境可以了解一下 Coding Plan它更适合把这类 Skill 集成到持续运行的自动化流程里。模型对话入口可以用来快速验证单个查询的返回效果接入文档里有完整的接口说明和参数列表API Keys 页面则是管理你所有密钥的地方。这几个入口按你的实际需求选排障和接入优先看 API Keys 和接入文档验证模型效果用模型对话长期跑 Agent 就上 Coding Plan。最后留一个实用技巧把AMINER_API_KEY的过期时间记在你的密钥管理工具里提前一周提醒自己轮换。Token 过期是这套链路里最隐蔽的故障因为它不会立刻报错而是在某次调用时突然返回 401。养成定期检查和轮换的习惯比事后排障省事得多。