一、环境准备

1.安装 NVM(Node.js 版本管理器)

(1)下载 NVM 安装包

前往官方 GitHub Releases 地址:https://github.com/coreybutler/nvm-windows/releases(不用接T子),打开界面如下。

选择最新版本1.2.2nvm-setup.exe安装包下载(该版本修复了非 C 盘安装的兼容问题,是目前稳定版)。

(2)执行安装

打开新下载好所在文件夹的nvm-setup.exe所在文件夹。

双击下载的nvm-setup.exe,点击“I accept the agreement”,安装过程一路点击 Next,无需额外修改默认配置,安装程序会自动配置环境变量,到点击“install”最后点击“finish‘即可

(3)验证安装成功

(1)按Win+S搜索PowerShell鼠标右键选择「以管理员身份运行」

(2)输入命令nvm version,若输出1.2.2(对应下载的版本号),则说明 nvm 安装成功。

2. 通过 NVM 安装 Node.js(以 22.22.0 版本为例)

在管理员权限的 PowerShell 中依次执行以下命令,完成 Node.js 安装和启用:

# 安装Node.js 22.x 稳定版本
nvm install 22
# 启用22.22.1版本(安装完成后终端会提示该版本号,按实际提示填写)
nvm use 22.22.1

执行成功后,终端会显示Now using node v22.22.1 (64-bit),此时输入node -v、nvm -vnpm -v可验证 Node.js 、nvm 和 npm 是否正常可用。

如果仍然下载失败,或者网络拦截了下载,也可以手动去官网下载安装:https://nodejs.org/zh-cn/download

3. 安装 Git (OpenClaw 安装过程中需要调用 Git 拉取代码)

(1)下载并安装 Git for Windows

  • 下载后安装包后双击安装,一路默认下一步(安装程序会自动配置环境变量)。

2. 验证 Git 是否安装成功

安装完成后,关闭当前所有 PowerShell 窗口,重新以管理员身份打开,执行:

# 查看 Git 版本(能输出版本号即为成功)
git --version

二、OpenClaw 安装与配置

1. 前置准备(必做!避免执行策略或权限报错)

(1)以管理员身份打开 PowerShell

Win+S搜索 PowerShell → 右键选择「以管理员身份运行」,这是所有操作的前提。

(2)解决执行策略报错(首次运行必做)

执行以下命令,允许当前用户运行远程签名的脚本(OpenClaw 安装脚本需要此权限):

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
  • 执行后会提示确认,输入Y回车即可。

  • 从图可以看到,已经成功执行了 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser 命令,并输入 Y 确认了更改。

这意味着:

  • 你的 PowerShell 执行策略已经更新为 RemoteSigned,仅允许运行本地创建的未签名脚本和来自互联网的签名脚本。
  • 这个更改只作用于当前用户(CurrentUser),不会影响系统其他用户。
  • 现在你可以继续执行 OpenClaw 的安装脚本了。

2. 安装 OpenClaw

在管理员 PowerShell 中执行官方安装命令(复制粘贴即可):

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

安装过程注意事项:

  • 安装会自动拉取项目代码和依赖,过程中可能需要下载 Node.js或其他组件,耐心等待即可;
  • 如果出现「网络超时 / 下载失败」,检查网络(建议关闭代理),重新执行上述命令。

终端显示:

cracks claws Alright, what are we building?
Starting setup...
OpenClaw 2026.3.2 (85377a2) - I'm like tmux: confusing at first, then suddenly you can't live without me.

这表示 OpenClaw 已经成功进入交互模式,正在等待你的下一步指令或初始化配置。

如果不小心关闭了 PowerShell,重新打开后执行:

openclaw onboard --flow quickstart

3. 配置模型

 第一个选择:

I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue? 这一行,选择 Yes 并回车,确认你已理解安全提示。

第二个选择:

当前光标默认在 QuickStart 选项上,直接按回车即可选择快速启动模式(后续可通过 openclaw configure 补充配置)。若你需要更精细的手动配置,可按方向键↓选择 Manual,再回车

第三个选择:

!!!注意:使用国外网络或流量的朋友可以使用这种OpenAI这种的比较流畅,对于大陆用户,多推荐本地类似Kimi这种,当然搭T子也能用OpenAI这种,但网络稳定性不强。

1. OpenAI(GPT-4o / GPT-4 / GPT-3.5)

  • 特点:全球最成熟的大模型生态,工具调用能力强,逻辑推理和多模态能力顶尖。

  • 适合场景:作为核心推理引擎,驱动复杂合规判断、自动生成合规报告、与数据库 / API 深度集成。

  • 注意:API Key 需妥善保管,适合对生态成熟度要求高的项目。


2. Anthropic(Claude 3 Opus/Sonnet/Haiku)

  • 特点:长文本处理能力极强(支持百万级 token),对法律条文、复杂文档的理解和摘要非常出色。

  • 适合场景:化妆品合规文档(如《化妆品监督管理条例》、欧盟 CPNP 法规)的深度解析、长报告生成。

  • 注意:对中文支持略逊于国内模型,但英文法规处理更稳。


3. Moonshot AI(Kimi K2.5)

  • 特点:国内头部大模型,中文理解和长文本能力顶尖,对国内法规条文的适配性好,响应速度快。

  • 适合场景:国内化妆品合规审查、成分表自动解析、中文合规报告生成。

  • 注意:数据合规性更有保障,适合面向国内市场的 SaaS 产品。


4. MiniMax

  • 特点:国内多模态大模型,在文本生成和对话交互上表现不错,生态相对轻量化。

  • 适合场景:作为辅助模型,用于客服式合规咨询、简单合规问答。

  • 注意:在复杂推理场景下不如头部模型。


5. Mistral AI

  • 特点:欧洲大模型,开源生态活跃,在代码生成和工具调用上有优势。

  • 适合场景:适合需要本地化部署、对数据隐私要求极高的场景。

  • 注意:中文支持一般,更适合技术栈偏欧洲的项目。


6. Google(Gemini)

  • 特点:多模态能力突出,图像 / 视频理解强,适合需要结合产品图片进行合规分析的场景。

  • 适合场景:化妆品包装标签合规检查、成分图片识别。

  • 注意:国内访问和 API 稳定性需要额外考虑。


7. xAI(Grok)

  • 特点:主打实时信息和互联网数据整合,风格更 “敢言”,适合需要结合最新舆情的场景。

  • 适合场景:合规舆情监控、消费者反馈分析。

  • 注意:在严肃合规推理上不如传统大模型稳定。


8. Qianfan(百度文心千帆)

  • 特点:国内企业级大模型平台,提供丰富的行业模型和工具链,对国内法规适配好。

  • 适合场景:企业级合规 SaaS,需要对接国内监管系统、本地化部署。

  • 注意:生态更偏向国内企业服务,API 调用成本可控。


9. Qwen(阿里云通义千问)

  • 特点:国内大模型,在多模态和行业知识库方面有优势,支持灵活的微调。

  • 适合场景:化妆品成分知识库构建、合规问答机器人。

  • 注意:与阿里云生态深度绑定,适合已有阿里云基础设施的项目。


10. BytePlus / Volcano Engine(字节火山引擎)

  • 特点:字节系大模型服务,在实时数据处理和高并发场景下表现突出。

  • 适合场景:需要高并发合规查询、实时数据更新的 SaaS 平台。

  • 注意:更偏向技术基础设施,模型本身的推理能力需结合具体版本评估。

  •  在当前的 Model/auth provider 选择界面,确认光标在 Moonshot AI(Kimi K2.5) 上,直接按 回车键 确认选择。

第四个选择:

这是 OpenClaw 工具的模型认证配置界面,用于选择 Moonshot AI (Kimi K2.5) 的认证方式。

各选项说明与选择建议

选项 适用场景 获取方式
Kimi API key (.ai) 国际版服务,面向海外用户 访问 Kimi 国际版平台获取
Kimi API key (.cn) 国内版服务,面向中国大陆用户(最常用) 访问 Kimi 开放平台 → 「API 密钥」→ 新建密钥
Kimi Code API key (subscription) 付费订阅用户,享有更高配额和优先级 登录 Kimi 会员中心 → 「API 权益」→ 生成 Code API 密钥
Back 返回上一级菜单 -
  • 中国大陆用户(无付费订阅):优先选择 Kimi API key (.cn),这是最通用的选项。
  • 海外用户:选择 Kimi API key (.ai)
  • 付费订阅用户:选择 Kimi Code API key (subscription) 以获得更好的服务。

选择后回车。

第五个选择:

  • 确认当前选项:光标默认在 Paste API key now 上,直接按 回车键 确认。

第六个选择:

  • 粘贴密钥:粘贴你的 API Key(API Key 我用的 硅基流动的 API,有新用户试用额度,后续金额不够可根据自己需求充值)
sk-w*******************************************urwm (个人API密钥)

第七个选择:

  • 想继续用当前的 moonshot/kimi-k2.5:Keep current (moonshot/kimi-k2.5) 或直接选下面的 moonshot/kimi-k2.5
  • 想换别的模型:Enter model manually,然后输入模型名。

第八个选择:

  • 接着配置通讯工具,虽然官方这里直接可以选飞书,但官方文档明确建议 Windows 通过 WSL2 运行,并且提到原生 Windows 未测试、更容易出问题。所以这里先跳过,后续再安装。

第九个选择:

  • Yes :这一步是推荐操作,不配置会影响后续功能正常运行;配置后能让系统完全跑通,避免后面报错;选 Yes 后按回车键确认即可。

第十个选择:

  • [•] Skip for now,暂时跳过先把核心功能跑通,后续需要再配。

  • 空格键“space”提交。

4. 访问 OpenClaw Web 端

浏览器会自动打开控制台。后续你也可以直接访问:http://127.0.0.1:18789/   

这就是OpenClaw Web 端:

  • 发消息测试,有回复就说明安装成功。
Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐