科研龙虾 Research-Claw 使用教程

https://github.com/wentorai/Research-Claw

科研龙虾Research-Claw小白超详细使用教程

Research-Claw（科研龙虾）是一款本地运行 的AI科研助手，覆盖文献管理、论文写作、实验复现、科研追踪等全科研流程，所有数据存在本地，仅需LLM API Key即可使用，新手也能快速上手。本教程从安装、配置、核心功能、常见问题全流程讲解，跟着步骤做就能轻松用起来。

一、先了解核心前提

1. 运行方式：全程本地运行，无云端数据回传，论文、笔记、实验数据都在自己电脑上，安全私密。
2. 唯一外部依赖 ：需要LLM API Key（推荐Anthropic Claude/OpenAI，也支持国内中转API，需自行获取）。
3. 平台支持：macOS、Linux、Windows（推荐Docker安装），无需单独安装OpenClaw（科研龙虾已内置）。
4. 许可证 ：个人/学术研究完全免费，商业用途需单独授权，2030年3月12日后自动转为Apache 2.0开源。

二、系统要求（极简，小白无压力）

操作系统	推荐安装方案	必备依赖	可选依赖
macOS/Linux	一键脚本安装	无（Git/Node.js自动装）	无
Windows	Docker一键安装	Docker Desktop	无
大陆网络用户	本地构建Docker	Docker Desktop	代理

关键提醒 ：所有平台都需要LLM API Key，提前准备好再进行后续操作。

三、安装步骤（分平台，复制命令即可）

方案1：macOS/Linux用户「一键脚本安装」（最推荐，1行命令搞定）

1. 打开电脑的终端（macOS在启动台搜索「终端」，Linux直接打开Terminal）；
2. 复制以下命令粘贴到终端，回车执行（首次安装/版本更新/重新启动都用这一条）：

curl -fsSL https://wentor.ai/install.sh | bash

3. 等待脚本自动完成：安装依赖→配置环境→启动科研龙虾，全程无需手动操作。

方案2：全平台「Docker一键安装」（Windows首选，macOS/Linux也可用）

Docker安装跨平台且无需配置系统环境，小白友好，步骤分2步：

第一步：安装Docker Desktop

1. 官网下载对应系统的Docker Desktop：https://www.docker.com/products/docker-desktop/；
2. 安装完成后启动Docker，看到电脑托盘（Windows右下角/macOS右上角）显示「Running」即为启动成功。

第二步：执行Docker安装命令

1. Windows用户：打开「PowerShell」（管理员/普通模式均可），复制以下命令回车：

irm https://wentor.ai/docker-install.ps1 | iex

2. macOS/Linux用户：打开终端，复制以下命令回车：

curl -fsSL https://wentor.ai/docker-install.sh | bash

3. 脚本自动完成：检测Docker→拉取最新镜像→启动容器→打开浏览器，重复运行该命令可直接更新版本，数据不会丢失。

方案3：大陆网络用户「本地构建Docker」（解决官方镜像访问失败）

如果上述Docker命令执行失败，是因为大陆无法直接访问GHCR镜像，用本地构建即可：

1. 打开终端/PowerShell，依次执行以下命令（逐行复制，回车执行）：

# 克隆项目到本地
git clone https://github.com/wentorai/Research-Claw.git
# 进入项目目录
cd Research-Claw
# 本地构建并启动Docker
docker compose up -d --build

2. 该方式内置清华源+npmmirror，无需额外配置代理，大陆网络可正常使用。

四、首次配置（30秒搞定，无需编辑任何文件）

无论哪种安装方式，完成后浏览器会自动打开 科研龙虾地址：http://127.0.0.1:28789，若未自动打开，手动在浏览器输入该地址即可。

首次打开会进入Setup Wizard（配置向导），仅需1步：

1. 在输入框中粘贴你准备好的LLM API Key（Claude/OpenAI/国内中转API均可）；
2. 点击「下一步」，系统自动完成配置，直接进入科研龙虾主界面，无需其他操作。

关键提醒 ：用127.0.0.1而非localhost，Windows上localhost可能解析到IPv6导致连接失败。

五、核心功能使用（小白必学，对话式操作，直接抄指令）

科研龙虾的核心操作是**「自然语言对话」，在主界面「Chat面板」输入指令即可，无需复杂点击，以下是5个最常用的核心功能，附直接可用的指令示例**，小白直接复制修改即可。

功能1：Zotero文献管理（自动分类/加摘要/导出BibTeX）

科研龙虾可双向联动Zotero/EndNote，解决文献堆着不整理的问题，无需额外配置，直接在Chat面板输入指令：

示例指令（按需修改）：

• 基础分类：Zotero「未分类」里的文献帮我按主题分类，每篇加一句话摘要
• 精准拆分：Zotero「未分类」的文献按主题分类，Others组超10篇同主题的再拆分成子组
• 导出引用：把Zotero里「LLM Reasoning」组的文献导出为BibTeX格式，保存到桌面

操作效果：

系统会自动读取Zotero文献→聚类分析→创建收藏集→添加摘要，完成后同步回Zotero，全程无需手动操作。

功能2：自动生成组会材料（定时推送，睡醒就能用）

设置后可定时自动汇总研究进展，生成组会汇报材料，推送到你的微信/飞书/QQ/钉钉，示例指令：

每周五早上8点，自动汇总我一周的研究进展，生成组会汇报材料，通过飞书推送到我的手机

操作效果：

系统会在指定时间自动整理工作区文件/实验笔记/文献阅读记录，生成结构化汇报材料，直接推送到你指定的IM工具，无需敲任何命令。

功能3：论文写作辅助（从框架到初稿，自动加引用）

无需从空白页开始写，科研龙虾会按你的研究方向构建论文框架、撰写各章节，自动匹配参考文献，示例指令（按需修改论文标题）：

示例指令：

• 构建框架：开始写论文「Multi-Agent Debate for Factual Reasoning」，先帮我构建完整的论文框架
• 撰写章节：基于刚才的框架，帮我写Related Work章节，要求2000词左右，引用相关高被引文献
• 调整内容：把刚才写的Method章节里的2.3小节改成「Multi-Agent Collaboration & Consensus」，重新修改内容

操作效果：

撰写完成后，内容会自动保存到本地工作区（如~/research/paper/02_related.md），BibTeX引用文件同步生成，直接复制到LaTeX/Word即可。

功能4：7×24科研雷达（追踪最新文献，实时推送）

设置关键词/学者/期刊，系统后台持续扫描arXiv/OpenAlex等学术数据库，有新成果第一时间推送给你，示例指令：

帮我追踪arXiv上「LLM Agent」和「RAG」相关的最新论文，还有学者Yann LeCun的新成果，有更新直接推送到我的QQ

操作效果：

新论文/新成果上线后，系统会自动抓取摘要+链接，推送到你指定的IM工具，不在电脑前也不会错过重要研究。

功能5：本地GPU自动复现论文（一键跑实验，自动解决环境问题）

无需手动配置conda/CUDA，输入论文的arXiv编号，系统自动克隆仓库、配置环境、运行实验，示例指令：

帮我跑一下arXiv:2406.12345这篇论文的实验，结果保存到桌面的results文件夹

操作效果：

系统会自动检测本地GPU/CUDA版本，遇到版本不兼容会自动切换，实验完成后结果保存到指定路径，若运行失败会提示问题原因，甚至可帮你给论文作者写邮件请教。

六、Dashboard六大面板介绍（快速找功能，不迷路）

科研龙虾的主界面是专门为科研设计的Dashboard，支持暖色Paper/暗色Terminal双主题切换，共6个核心面板，功能清晰，小白一眼就能懂：

面板名称	核心功能（小白怎么用）
Chat	对话主界面，输入所有指令的地方，支持21种结构化输出（告别纯文本）
文献库	管理本地所有论文，支持全文检索/标签/批注/引用图谱，一键打开PDF
任务	分层管理科研任务，分4级优先级，48小时截止日期自动预警，避免忘事
工作区	管理所有科研文件，Git自动追踪每一次修改，支持版本历史回滚（误删可恢复）
监控	可视化配置科研雷达（关键词/学者/期刊）、定时任务（组会材料），一键开启/关闭
设置	修改API Key/切换LLM模型/配置IM推送/主题切换，所有操作在浏览器完成，无需改文件

七、日常常用操作（启动/更新/备份，命令直接用）

7.1 源码安装（macOS/Linux）常用命令

打开终端，进入科研龙虾目录（cd ~/research-claw），执行以下命令：

pnpm serve   # 推荐启动方式（修改配置后自动重启）
pnpm health  # 检查运行状态（是否正常启动）
pnpm backup  # 备份本地数据库（重要，定期执行）
pnpm test    # 运行单元测试（检测是否有故障）

7.2 Docker安装（全平台）常用命令

打开终端/PowerShell，直接执行，无需进入目录：

docker restart research-claw  # 重启科研龙虾容器
docker stop research-claw     # 停止科研龙虾
docker ps                     # 查看容器运行状态（是否正常）
curl http://127.0.0.1:28789/healthz  # 检测端口是否正常（返回{"ok":true}即为正常）

7.3 版本更新（所有平台通用，1行命令）

科研龙虾的更新超简单，直接重新执行安装命令即可，数据会自动持久化，不会丢失：

• macOS/Linux源码安装：重新执行一键脚本
• Docker安装：重新执行对应的Docker安装命令

八、小白常见问题排查（解决99%的使用问题）

问题1：Docker安装后，浏览器访问127.0.0.1:28789失败

解决步骤：

1. 检查Docker是否启动：托盘显示「Running」，若未启动则手动启动；
2. 检测端口：执行curl http://127.0.0.1:28789/healthz，返回{"ok":true}即为端口正常；
3. 重启容器：执行docker restart research-claw，等待1分钟后重新访问。

问题2：输入API Key后，系统提示「无效/连接失败」

解决步骤：

1. 检查API Key是否复制完整（无空格/无缺失）；
2. 若用OpenAI/Claude，确认账号有余额、地区未被限制；
3. 大陆网络用户：在Docker Desktop→Settings→Resources→Proxies中配置HTTP/HTTPS代理，重启Docker后重试。

问题3：安装后，原有OpenClaw无法正常启动（端口/命令冲突）

解决步骤（两步恢复，无需卸载科研龙虾）：

1. 打开终端，删除CLI包装器：

rm -f ~/.local/bin/openclaw

2. 清除shell环境变量：

grep -n "OPENCLAW_CONFIG_PATH\|# Research-Claw" ~/.zshrc ~/.bashrc ~/.bash_profile 2>/dev/null

3. 找到输出结果中带「Research-Claw」的行，手动删除后，重启终端 ，原有OpenClaw即可正常使用，科研龙虾通过pnpm serve启动，两者可并存。

问题4：Windows PowerShell执行Docker命令时，提示「权限不足」

解决步骤：

1. 右键「PowerShell」，选择「以管理员身份运行」；
2. 重新执行Docker安装命令，即可正常运行。

九、卸载科研龙虾（分平台，可保留数据）

若无需使用，可按以下步骤卸载，可选是否保留本地数据（论文/笔记/任务）。

9.1 源码安装（macOS/Linux）卸载

打开终端，逐行执行以下命令：

# 停止运行进程
pkill -f "openclaw.*gateway" 2>/dev/null
# 删除项目目录
rm -rf ~/research-claw
# 删除本地数据（可选，不执行则保留数据）
rm -rf ~/.research-claw
# 删除CLI包装器
rm -f ~/.local/bin/openclaw

最后编辑~/.zshrc/~/.bashrc，删除带「OPENCLAW_CONFIG_PATH」和「Research-Claw」的行，重启终端即可。

9.2 Docker安装（全平台）卸载

打开终端/PowerShell，逐行执行：

# 停止并删除容器
docker stop research-claw && docker rm research-claw
# 删除镜像
docker rmi ghcr.io/wentorai/research-claw:latest
# 删除本地数据（可选，不执行则保留数据）
docker volume rm rc-config rc-data rc-workspace rc-state

Docker安装无需额外清理，不会修改系统环境。

9.3 Windows WSL2手动安装卸载

打开PowerShell，执行以下命令：

# 停止并删除WSL2内的科研龙虾
wsl -e bash -c "pkill -f 'openclaw.*gateway' 2>/dev/null; rm -rf ~/research-claw ~/.research-claw"
# 清理环境变量
wsl -e bash -c "sed -i '/OPENCLAW_CONFIG_PATH/d;/Research-Claw/d' ~/.bashrc 2>/dev/null"

若WSL2仅用于科研龙虾，可执行wsl --unregister Ubuntu完全卸载WSL2（会删除WSL2内所有数据）。

十、小白必看注意事项

1. 数据安全 ：所有数据本地存储，SQLite数据库+Git版本控制，定期执行pnpm backup/手动备份工作区，防止数据丢失；
2. 本地GPU加速：若电脑有NVIDIA GPU，确保安装了CUDA驱动，科研龙虾会自动调用GPU，提升实验复现/论文撰写速度；
3. 技能扩展：科研龙虾内置438个学术技能，覆盖16个学科，无需手动配置，安装时自动加载；
4. IM推送配置：在「设置面板」配置飞书/QQ/钉钉/Telegram的推送机器人，即可接收科研雷达/组会材料提醒；
5. 问题反馈 ：使用中遇到问题，可在GitHub项目页（https://github.com/wentorai/Research-Claw）提交Issue，作者会及时回复。