OpenClaw(小龙虾)Windows 配置指南-----研究生文献整理版

适用于:全新 Windows 10/11 电脑,目标用途:前沿文献收集与分析


第一步:安装基础环境

OpenClaw 运行依赖 Node.js 和 Git,全新电脑需要先装这两样东西。

1.1 安装 Git

  1. 打开浏览器,访问 https://git-scm.com/downloads/win
  2. 下载 Windows 版安装包
  3. 双击运行,一路点 Next → 最后点 Install
  4. 安装完成后,按 Win + R,输入 cmd 回车,输入以下命令验证:
git --version

看到版本号即成功。

1.2 安装 Node.js

  1. 访问 https://nodejs.org/
  2. 下载 LTS 版本(必须 ≥ 22,当前 LTS 一般满足要求)
  3. 双击安装,一路默认即可
  4. 重新打开 cmd,验证:
node -v
npm -v

两个都显示版本号即成功。

提示:如果 Node.js 版本低于 22,去官网下载最新的 Current 版本。


第二步:安装 OpenClaw

方式一:一键脚本安装(推荐)

Win + X,选择 终端PowerShell(以管理员身份运行)。

如果提示"在此系统上禁止运行脚本",先执行:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

然后执行安装脚本:

iwr -useb https://openclaw.ai/install.ps1 | iex

脚本会自动检测环境、安装 OpenClaw,并启动配置向导。

方式二:手动 npm 安装

如果一键脚本因网络问题失败,可以手动安装:

# 设置国内镜像(加速下载)
npm config set registry https://registry.npmmirror.com

# 全局安装 OpenClaw
npm i -g openclaw

# 验证安装
openclaw --version

如果 openclaw 命令未识别:重启 PowerShell;或者运行 npm config get prefix 查看路径,把该路径手动添加到系统环境变量 PATH 中。


第三步:初始化配置

安装完成后运行:

openclaw onboard

会进入交互式配置向导,按以下步骤操作:

3.1 风险确认

提示是否了解 OpenClaw 的系统权限风险 → 选择 YES

3.2 选择模式

选择 QuickStart(快速开始)

3.3 选择 AI 模型供应商

这是最关键的一步。OpenClaw 本身不含 AI 模型,需要接入外部大模型 API。

国内推荐(直连,无需科学上网):

供应商 新用户福利 推荐理由
通义千问(Qwen) 每个模型 100 万 tokens 免费 模型能力强,官方直接支持
MiniMax 新用户 15 元额度 性价比高
硅基流动(SiliconFlow) 认证后 16 元奖励 支持多种开源模型
阿里云百炼 有免费额度 企业级稳定

选择一个供应商后,去对应平台注册账号 → 获取 API Key → 粘贴到配置向导中。

以通义千问为例:访问 https://dashscope.console.aliyun.com/ → 注册/登录 → 找到 API Key 管理 → 创建并复制 API Key。

3.4 选择模型

推荐选择带 Vision 能力的模型(能看图),如:

  • qwen-plus(通用任务,性价比高)
  • qwen-max(复杂任务,质量更好但更贵)

3.5 选择聊天通道

你可以选择接入飞书、钉钉、企业微信等,也可以先选 Skip for now,直接用本地网页界面。

3.6 安装 Skills

建议先选 No,后面手动按需安装。

3.7 Hooks 和 Gateway

  • Enable hooks → Skip for now
  • Gateway 服务 → 选 RestartInstall

配置完成后,浏览器会自动打开 http://127.0.0.1:18789/chat,这就是你的 OpenClaw 本地控制台。


第四步:验证运行

在 PowerShell 中运行:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw doctor 全部显示绿色 OK 就说明一切正常。

打开浏览器访问 http://127.0.0.1:18789/chat ,试着发一条消息(比如"你好"),如果收到回复,说明配置成功。


第五步:安装文献搜索相关 Skills

这是让 OpenClaw 具备文献收集和分析能力的关键。

5.1 启用核心工具

在控制台(Dashboard)中,确保以下内置工具已开启:

  • web_search:网页搜索(基于 Brave Search)
  • web_fetch:抓取网页内容
  • browser:浏览器自动化(可以操作网页)
  • read / write:文件读写
  • exec:执行系统命令

5.2 安装推荐 Skills

在 PowerShell 中执行:

# 深度搜索技能(多源并行搜索 + 内容提取)
# 需要先安装 Python 依赖
pip install requests trafilatura beautifulsoup4 lxml

# 从 GitHub 克隆搜索技能
mkdir -p ~/.openclaw/workspace/_repos
git clone https://github.com/blessonism/openclaw-search-skills.git ~/.openclaw/workspace/_repos/openclaw-search-skills

# 链接到 skills 目录
cd ~/.openclaw/workspace/skills
# Windows 下用 mklink(需管理员权限):
mklink /D search-layer "%USERPROFILE%\.openclaw\workspace\_repos\openclaw-search-skills\search-layer"
mklink /D content-extract "%USERPROFILE%\.openclaw\workspace\_repos\openclaw-search-skills\content-extract"

5.3 配置搜索 API Key(可选但推荐)

~/.openclaw/credentials/search.json 中配置额外搜索源,提升搜索质量:

{
  "exa": "your-exa-api-key",
  "tavily": "your-tavily-api-key"
}
  • Exa:https://exa.ai/ (学术搜索能力强)
  • Tavily:https://tavily.com/ (AI 优化的搜索引擎)

Brave Search 由 OpenClaw 内置的 web_search 工具自动管理,不需要单独配置。

5.4 其他实用 Skills

# 文件系统管理(让 AI 能读写本地文件)
npx clawhub@latest install file-system-manager

# 摘要生成(支持 URL 和本地文件)
npx clawhub@latest install summarize

第六步:用起来——文献收集实战

配置完成后,在聊天界面直接用自然语言下达指令即可。

示例指令:

帮我搜索最近一个月关于"大语言模型在药物发现中的应用"的前沿论文,
整理成一个表格,包含:论文标题、作者、发表时间、期刊、主要发现,
保存为 Markdown 文件到桌面。
去 Google Scholar 搜索 "transformer protein folding 2025",
找出引用量最高的 5 篇论文,给我一个简要综述。
每天早上 9 点自动搜索 arXiv 上关于 "multimodal learning" 的新论文,
把摘要翻译成中文,发送到我的飞书。

常用命令速查

命令 用途
openclaw onboard 重新进入配置向导
openclaw dashboard 打开网页控制台
openclaw gateway start 启动网关服务
openclaw gateway restart 重启网关服务
openclaw update 更新到最新版本
openclaw skills list 查看已安装的技能
openclaw doctor 检查系统健康状态
npx clawhub search <关键词> 搜索可用技能

安全提醒

  1. 不要在主力机上给过多权限:如果电脑上有敏感的科研数据,建议限制 OpenClaw 的文件访问范围
  2. 安装 Skill 前先检查源码:优先使用官方认证或高星标的技能
  3. API Key 保密:不要把 API Key 分享给他人或发到公开群组
  4. AI 输出需要人工审核:大模型存在幻觉问题,生成的文献综述务必核实原文

常见问题

Q:安装脚本下载失败/超时?
A:设置国内 npm 镜像:npm config set registry https://registry.npmmirror.com,然后重试。

Q:openclaw 命令找不到?
A:重启 PowerShell。如果仍然不行,运行 npm config get prefix 获取路径,添加到系统环境变量 PATH。

Q:API 调用报错或无响应?
A:检查网络连接是否正常、API Key 是否正确、账户额度是否充足。

Q:Token 消耗太快怎么办?
A:在配置中为不同任务设置不同模型。日常对话用便宜的小模型,复杂分析再用大模型。定期在控制台检查用量。

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐