OpenClaw 使用教程

Ai4Scholar 插件把 Semantic Scholar、PubMed、Google Scholar、arXiv、bioRxiv、medRxiv 六个学术平台接入 OpenClaw。配置完成后，直接在对话中描述科研任务，Agent 就可以调用相应工具。

本页按 Ai4Scholar 0.6.11 整理，包含 35 个工具，并提供可选的 Scholar Mode 和文献管理快捷命令。插件可在 ClawHub 或 npm 查看。

快速导航

准备工作

1. 安装并配置好 OpenClaw，确保已经能够与 Agent 正常对话。
2. 登录 Ai4Scholar，在 API Key 管理 中创建或复制自己的密钥。
3. 检查 OpenClaw 和 Node.js 版本是否满足插件要求。

在终端查看版本：

openclaw --version
node --version
npm --version

新版本的要求以 npm 插件说明和 OpenClaw 安装文档为准。示例中的 YOUR_API_KEY 是占位符，请在本地配置中替换，不要把真实密钥发送到聊天里。

安装与配置

安装插件

在运行 OpenClaw 的机器上执行：

openclaw plugins install clawhub:ai4scholar

也可以明确选择 npm 作为安装来源，两种方式选一种即可：

openclaw plugins install npm:ai4scholar

如果安装器要求确认来源，核对包名和来源后按提示继续。安装来源、兼容性与本地安装包的说明见 OpenClaw 插件安装文档。

保存 API Key

在运行 Gateway 的用户目录中，编辑 ~/.openclaw/.env，加入以下一行；如果文件已经存在，保留原有内容：

AI4SCHOLAR_API_KEY=YOUR_API_KEY

macOS / Linux 可将该文件设为仅当前用户读写：

chmod 600 ~/.openclaw/.env

Windows 对应的文件通常位于 %USERPROFILE%\.openclaw\.env。如果 Gateway 运行在服务器、容器或另一个系统用户下，需要修改该运行环境实际使用的配置目录。

配置插件

编辑 ~/.openclaw/openclaw.json，把下面的 ai4scholar 项合并到已有的 plugins.entries 中，保留其他插件和模型配置：

{
  "plugins": {
    "entries": {
      "ai4scholar": {
        "enabled": true,
        "config": {
          "apiKey": "${AI4SCHOLAR_API_KEY}"
        }
      }
    }
  }
}

这里的 ${AI4SCHOLAR_API_KEY} 是环境变量引用，保持原样即可；真实 Key 填在上一步的 .env 文件中。

重新加载 Gateway

修改环境变量文件后，重启 Gateway 以读取新的 Key：

openclaw gateway restart

如果 Gateway 尚未启动，使用 openclaw gateway start。前台运行的实例需要在原终端停止后重新启动。

让 OpenClaw 协助配置

也可以先把 Key 保存到上面的 .env 文件，再向 OpenClaw 发送以下请求：

请帮我安装 Ai4Scholar 插件，使用命令 openclaw plugins install clawhub:ai4scholar。
API Key 已保存在 Gateway 用户的 ~/.openclaw/.env 中，变量名是 AI4SCHOLAR_API_KEY。
请在 openclaw.json 的 plugins.entries.ai4scholar 中启用插件，
将 config.apiKey 配置为环境变量引用 ${AI4SCHOLAR_API_KEY}，保留原有配置。
不要读取或展示密钥内容。完成后重启 Gateway，并检查插件是否加载成功。

具体执行能力取决于当前 Agent 的工具权限；也可以按前面的步骤手动完成。

验证是否成功

先查看插件列表和运行时注册信息：

openclaw plugins list
openclaw plugins inspect ai4scholar --runtime --json

确认 ai4scholar 已启用，且没有注册错误。0.6.11 版本应注册 35 个工具；这一步检查的是命令行进程中的加载情况，还需要在实际对话中验证一次调用。

回到 OpenClaw，发送：

请使用 Ai4Scholar 的 search_semantic 搜索近三年关于蛋白质结构预测的论文，
返回 5 篇论文的标题、年份、简短摘要和来源链接。

看到实际工具调用和论文结果后，说明当前对话中的插件与 API Key 已可用。arXiv、bioRxiv、medRxiv 的直接检索工具不依赖 Ai4Scholar API Key，因此只测试这些来源不能验证 Key 是否配置正确。

Scholar Mode

Scholar Mode 会向 Agent 添加学术工具使用提示，帮助它选择论文检索、阅读和引用工具。这是可选功能，普通工具调用不需要启用它。

希望开启时，在同一个插件配置项中加入 hooks，并启用 config.scholarMode：

{
  "plugins": {
    "entries": {
      "ai4scholar": {
        "enabled": true,
        "hooks": {
          "allowConversationAccess": true
        },
        "config": {
          "apiKey": "${AI4SCHOLAR_API_KEY}",
          "scholarMode": true
        }
      }
    }
  }
}

如果已设置 hooks.allowPromptInjection: false，Scholar Mode 不会启用。保存配置后按 OpenClaw 的加载提示操作，再开始一轮对话。

工具清单

以下是 0.6.11 版本的 35 个工具。新版本的清单可通过 openclaw plugins inspect ai4scholar --runtime --json 查看。

论文搜索

论文详情

引用与参考文献

作者信息

论文推荐

PDF 链接与全文阅读

0.6.11 已移除旧的 download_by_doi 工具。read_by_doi 用于全文提取，不会发送 PDF 附件；需要 PDF 时，可使用相应来源的链接工具。

文献自动标注

科研绘图

快捷命令

在 OpenClaw 聊天中使用以下命令管理文献。文献管理命令要求当前发送者已获得 OpenClaw 授权。

使用示例

搜索论文

帮我搜索近三年 CRISPR 在肿瘤免疫治疗中的研究进展，
优先查 PubMed，列出论文标题、发表年份、主要结论和来源链接。

查看论文与引用网络

帮我查询 DOI 为 10.1038/s41586-021-03819-2 的论文详情，
再找出引用它的代表性论文，说明这些工作的研究方向。

阅读全文

请通过 DOI 10.1038/s41586-021-03819-2 获取论文全文，
总结 Methods 部分，并区分论文原文结论与你的分析。

付费论文的全文访问取决于运行 OpenClaw 的机器是否具有机构订阅或其他合法访问权限；开放获取论文可优先使用对应来源的阅读工具。

自动添加引用

请使用 auto_cite 为下面的 Introduction 添加引用，采用 IEEE 格式，
并返回参考文献列表和 BibTeX：
 
（在这里粘贴需要标注的学术文本）

绘制科研图

帮我画一张 CRISPR-Cas9 基因编辑机制示意图，
标注 Cas9、guide RNA 和目标 DNA，适合用于论文配图。

需要修改已有图片时，先在对话中发送图片，再描述希望调整的结构、标注、配色或风格。

MCP 云端接入

如果只需要云端学术检索，也可以使用 Ai4Scholar 的 SSE 服务。它与本页的插件是两种接入方式；工具范围以云端服务实际返回的列表为准，Scholar Mode 和上述快捷命令由插件提供。

在支持内置 MCP 客户端的 OpenClaw 版本中：

1. 打开 Control UI 的 Settings → MCP → Add server。
2. 名称填写 ai4scholar，传输方式选择 SSE。
3. 服务地址填写 https://mcp.ai4scholar.net/sse。
4. 在该服务的配置编辑区域设置请求头：名称为 Authorization，值为 Bearer YOUR_API_KEY，替换占位符并保留 Bearer 后的空格。
5. 保存并启用服务，再检查连接状态：

openclaw mcp doctor ai4scholar --probe

当前 OpenClaw 将 MCP 服务保存在 mcp.servers 中。不要直接套用其他客户端的顶层 mcpServers 配置。版本差异与配置字段见 OpenClaw MCP 文档；更多客户端的步骤见本站 MCP 云端 SSE 接入教程。

常见问题

安装后提示 plugin not found 或看不到工具

1. 执行 openclaw plugins list，确认插件安装在 Gateway 使用的同一运行环境中。
2. 检查 plugins.entries.ai4scholar.enabled 是否为 true，以及插件配置中是否有正确的 apiKey 引用。
3. 如果使用了 plugins.allow，确认其中包含 ai4scholar，并检查是否被 plugins.deny 禁用。
4. 用 openclaw plugins inspect ai4scholar --runtime --json 查看具体加载错误。若是版本不兼容，先按插件要求更新 OpenClaw 和 Node.js。

搜索失败或结果为空

• 认证错误：检查 Gateway 用户的 .env 文件和 config.apiKey 引用，修改环境变量后重启 Gateway。
• 网络错误：检查运行 OpenClaw 的机器能否访问 Ai4Scholar 和所选文献来源。
• 正常返回但没有结果：放宽关键词、年份或筛选条件，尝试英文关键词或另一数据源。
• 提示额度不足：在 Ai4Scholar 中查看余额与用量。

全文读取失败或文本质量不好

付费论文需要相应的访问权限。没有机构订阅时，可优先选择开放获取论文，或使用 arXiv、bioRxiv、medRxiv 等来源。

扫描版 PDF、图片中的文字和复杂排版可能影响全文提取。遇到缺失内容时，打开 PDF 原文核对；工具能够找到论文元数据，不代表一定能获取全文。

Windows 安装时出现 spawn EINVAL

先执行 node --version 和 npm --version，确认版本符合要求，且 npm 能在当前终端中运行。更新 OpenClaw 后重试安装。

如果 npm 调用仍在安装过程中失败，可以在 PowerShell 中先下载 npm 安装包，再交给 OpenClaw 安装：

npm pack ai4scholar

记录命令输出的 .tgz 文件名，然后安装该文件。例如下载的是 0.6.11：

openclaw plugins install .\ai4scholar-0.6.11.tgz

文件名应与实际下载版本一致。安装完成后，继续本页的 API Key 配置与验证步骤。若是 Node.js 或 OpenClaw 版本不兼容，下载本地安装包也不能跳过版本要求。

如何更新插件

通过 ClawHub 或 npm 安装的插件可以执行：

openclaw plugins update ai4scholar
openclaw plugins inspect ai4scholar --runtime --json

更新会沿用已记录的安装来源；如 OpenClaw 提示需要重启，再执行 openclaw gateway restart。通过本地压缩包安装的插件，需要下载新包，并按安装器提示更新。

从旧版本升级到 0.6.11 时，移除自定义提示词和工具列表中对 download_by_doi 的引用。插件不会自行安装更新，旧配置中的 autoUpdate 字段已不再生效。

计费与帮助

插件调用 Ai4Scholar 的搜索、引用、绘图等服务时，按对应服务规则消耗积分；OpenClaw 中使用的模型费用另行计算。当前价格见定价页面，余额和调用记录可在登录后的账户页面查看。

使用中遇到问题，可通过问题反馈提交插件版本、OpenClaw 版本和错误信息，提交前移除 API Key。插件发布信息见 ClawHub 与 npm。