OpenClaw小龙虾安装指南
环境准备
想把OpenClaw玩转起来,先得把环境给搭好了。下面这份清单,是开跑前必须准备好的几样东西,一个都不能少。
项目
要求
Node.js≥ 22.x 操作系统macOS / Linux / Windows (WSL2) 内存≥ 2GB 可用 AI APIClaude 或 OpenAI API Key
安装nodejs(windows)
下载地址:https://nodejs.org/zh-cn/download
第一步,去官网把Node.js的安装包给请下来。直接选择Windows安装程序就行,图个省事。
安装过程没什么技术含量,典型的“下一步”式操作。双击刚下载的安装包,跟着向导一路点下去,直到安装完成,如图所见。
安装pnpm
Node.js就位后,下一步是安装包管理器。这里推荐使用pnpm,速度更快,磁盘空间也更节省。打开你的命令行工具,输入下面这条指令:
zbl@PC-20250326QLDX MINGW64 ~/Desktop$ npm install -g pnpm
added 1 package in 32s
1 package is looking for funding
run `npm fund` for details
npm notice
npm notice New minor version of npm available! 11.9.0 -> 11.11.0
npm notice Changelog: https://github.com/npm/cli/releases/tag/v11.11.0
npm notice To update run: npm install -g npm@11.11.0
npm notice
看到类似这样的输出,就说明pnpm已经成功安装到你的系统里了。
安装openclaw
官方下载地址:https://github.com/openclaw/openclaw
重头戏来了,开始部署OpenClaw本体。建议先在你的硬盘上找一个合适的位置,专门用来存放项目文件。然后,在这个目录下执行克隆命令。
zbl@PC-20250326QLDX MINGW64 /e/AiOps/openclaw$ git clone https://github.com/openclaw/openclaw.git
Cloning into 'openclaw'...
remote: Enumerating objects: 222048, done.
remote: Counting objects: 100% (112/112), done.
remote: Compressing objects: 100% (46/46), done.
Receiving objects:50% (111880/222048), 131.68 MiB | 1.86 MiB/s
项目仓库比较大,下载过程需要一点耐心,喝杯茶的功夫就差不多了。
源码下载完毕后,别急着启动。接下来是经典的“四部曲”构建流程,按顺序执行下面的命令,一步都不能错。
1.进入openclaw目录
cd openclaw
2.安装依赖
pnpm install
3.构建ui组件
pnpm ui:build
4.构建项目应用
pnpm build
每执行完一步,都可以观察一下终端的输出,确保没有报错。这个过程会拉取所有必要的依赖包并完成编译,是让项目跑起来的关键。
OpenClaw初始化配置
启动初始化配置
构建成功,相当于给汽车造好了引擎。现在,让我们来点火并完成首次启动设置。运行初始化命令:
pnpm openclaw onboard --install-daemon
系统会弹出一个交互式向导,引导你完成基础配置。
第一个问题,询问是否安装守护进程。为了让服务更稳定地在后台运行,这里我们选择Yes。
选择默认模型
初始化过程中,有些步骤可以先跳过,后续在图形界面里再细调也不迟。比如第一个关于默认模型的配置界面,直接选跳过就行。
之后,会进入模型供应商的选择。这里提供了多个选项,为了灵活性最大化,建议选择第一个“所有供应商”,这样后续可用的模型范围最广。
接下来是选择具体的默认模型。不用纠结,直接选用系统推荐的第一项,后续随时可以再更换。
使用的工具
工具配置部分也一样。当系统询问选择channel时,同样可以先跳过,把基础服务先跑起来再说。
然后来到搜索供应商的选择界面,根据你的需求或偏好进行选择即可。
安装skill技能
真正的亮点来了——安装Skill。这是OpenClaw扩展能力的关键,相当于给你的AI助手安装各种“应用”或“插件”。当向导问是否安装时,果断选择Yes。
随后会看到一个技能列表。使用空格键可以多选你感兴趣的技能,选好后按回车确认提交。这就好比给新手机安装必备App。
接着是关于是否启用goplaces的询问,根据你的使用场景决定即可。
然后是钩子(Hooks)的启用选项。这个功能主要用于自定义工作流,初期可以先跳过,以后在Web管理界面上配置会更直观。
最后,向导会贴心地询问是否要立即打开Web UI。当然是选择“是”,让我们去看看劳动成果。
看到浏览器弹出了OpenClaw的登录界面,恭喜你,最关键的系统初始化配置已经全部完成了。
至此,OpenClaw的安装和初始设置都已就绪,一个功能完整的本地AI智能体平台已经成功启动。
运行OpenClaw
启动gateway(源码方式启动)
日常开发或测试时,如果你在项目源码目录下,可以通过这条命令启动网关服务:
pnpm openclaw gateway
后台命令行模式(其他方式启动)
如果你已经全局安装了openclaw命令行工具,或者想以后台服务的形式运行,直接在任意路径下使用这个简单命令即可:
openclaw gateway
启动web界面
最后,要启动那个直观的图形化管理后台,运行下面这条命令。之后,你就可以在浏览器里通过可视化界面来管理和使用你的AI智能体了。
pnpm openclaw dashboard



















