首页 > 其他资讯 > npm非全局方式安装小龙虾OpenClaw

npm非全局方式安装小龙虾OpenClaw

时间：26-04-01

一、概述

将npm安装范围限定在项目本地，而非使用全局模式，是构建稳定、可移植开发环境的核心实践。这种方式直接避免了依赖包默认占用系统盘（如C盘）空间，更重要的是，它确保了项目环境与操作系统解耦。即使重装系统或更换工作设备，你的项目配置与依赖也能完整迁移。以下是一套经过实战检验的高效本地安装流程，无需复杂的全局配置即可完成部署。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

目前多数网络教程在处理本地化部署时，常引入不必要的“桥接”或“映射”步骤，导致流程冗长且易错。实际上，遵循npm包管理的本源工作逻辑，直接进行操作更为简洁可靠。本节介绍的直装法不仅步骤最简，也为项目的长期维护与迁移奠定了坚实基础，确保你精心配置的智能体（或类比为“数字助手”）能够随项目整体搬迁，不再受制于特定的系统环境。

二、安装Node.js环境基础

环境要求：Node.js 版本需为 22.22.0 或更高。

建议使用nvm（Node版本管理器）来安装和管理Node.js，它能让你在不同项目间灵活切换运行环境：

# 安装指定大版本的最新Node.js

nvm install 22

# 切换到指定版本

nvm use 22.22.1

# 查看已安装的所有Node.js版本列表

nvm ls

三、部署OpenClaw-CN

1、创建项目目录结构并进行本地安装

首先，在非系统盘（例如D盘或F盘）规划一个清晰的目录结构。建议按以下方式创建：

项目根目录示例：F:\JProduct\OpenClaw

在该根目录下，创建两个关键的子文件夹：

F:\JProduct\OpenClaw\openclaw-cn：存放OpenClaw的程序文件与npm依赖。

F:\JProduct\OpenClaw\openclaw-data：集中存储所有运行时数据、配置文件与工作空间。

接下来，打开命令行工具（cmd），导航至程序目录：
执行OpenClaw-CN的本地安装命令：npm install openclaw-cn@latest

等待npm完成依赖解析与包安装，成功界面将如下所示：

2、配置系统环境变量

此步骤的核心是告知OpenClaw系统其数据存储的位置。通过“系统属性”->“高级”->“环境变量”界面，新建两个系统变量：

OPENCLAW_HOME = F:\JProduct\OpenClaw\openclaw-data

OPENCLAW_STATE_DIR = F:\JProduct\OpenClaw\openclaw-data

3、执行初始化引导程序

安装完成后，进入npm自动生成的`.bin`目录，该目录包含了所有可执行命令。

具体路径示例：F:\JProduct\OpenClaw\openclaw-cn\node_modules\.bin

在cmd中执行：cd F:\JProduct\OpenClaw\openclaw-cn\node_modules\.bin

（网络上许多配置PATH或创建软链接的方法，其根本目的都是便捷地调用此目录下的命令。直接在此目录操作是最高效的方式。）

然后，运行目录中的主程序引导命令。在Windows系统中，执行：openclaw-cn.cmd

跟随命令行中的交互式引导完成基础设置。

当引导程序提示选择AI模型供应商时，根据你的可用API密钥进行选择。以下以选择DeepSeek为例：

根据提示，输入对应平台的有效API密钥。

继续完成剩余的简单配置问答。

4、校准工作空间路径配置

引导配置结束后，需手动校验核心配置文件。打开数据目录下的openclaw.json文件，确认其中的“workspace”路径指向我们预先创建的数据目录，例如：

F:\\JProduct\\OpenClaw\\openclaw-data\\workspace

（注意：JSON配置文件中需使用双反斜杠表示路径）

5、创建一键启动脚本

为提升日常使用效率，可在程序根目录创建一个启动批处理脚本。在路径F:\JProduct\OpenClaw\openclaw-cn下，新建start.bat文件。

使用文本编辑器打开该文件，写入以下脚本内容（请务必根据你的实际安装路径进行修改）：

@echo off
REM OpenClaw-CN启动脚本
echo 启动OpenClaw-CN...
echo.
REM 设置数据目录
set OPENCLAW_HOME=F:\JProduct\OpenClaw\openclaw-data
set OPENCLAW_STATE_DIR=F:\JProduct\OpenClaw\openclaw-data
set OPENCLAW_GATEWAY_MODE=local

REM 进入程序目录
cd /d "F:\JProduct\OpenClaw\openclaw-cn"

REM 调用.bin目录下的可执行文件
call node_modules\.bin\openclaw-cn.cmd %*
REM 或者直接启动网关（根据引导时选择的方式）
call node_modules\.bin\openclaw-cngateway --port 18789

pause

保存文件后，双击运行start.bat脚本。