openclaw小白安装指南(本地部署基础篇)

OpenClaw本地部署

一、安装准备

官方地址：https://nodejs.org/zh-cn

推荐下载 LTS 长期支持版（页面上显眼的那个版本，比如当前的 20.x 系列），稳定性强，适合开发 / 生产环境。页面会自动识别你的系统（Windows / Mac / Linux）。

或者使用命令行安装：

winget install OpenJS.NodeJS.LTS

brew install node

sudo apt updatesudo apt install -y nodejs npm

说明：不同 Linux 发行版安装命令会有差异；以上命令适用于 Debian / Ubuntu 系。

Git 官方下载地址：https://git-scm.com/

网站会自动识别你的操作系统，Windows 点「Download for Windows」，Mac / Linux 对应右侧的下载入口；Windows 建议选 64 位版本，安装时都采用默认选项即可。

或者使用命令行安装：

winget install --id Git.Git -e --source winget

brew install git

sudo apt updatesudo apt install -y git

说明：Mac OS 通常会在首次使用 Git 时提示安装命令行工具；如果系统里已经有 Git，也可以不重复安装。

安装完成后，打开命令行（Windows 用 CMD / PowerShell，Mac / Linux 用 Terminal 终端），分别输入以下命令，能显示版本号就是安装成功：

node -vnpm -v

git --version

注意：这里提供稳定版2026.3.13版本的安装指令。最新版的2026.3.23版，插件和通讯频道还未完全适配。需要更新的，可等openclaw版本稳定，并且第三方插件对应升级完成后再做升级操作。

npm i -g openclaw@2026.3.13

注意：安装时如果出现权限错误，需要加上sudo，获取管理员权限。

sudo npm install -g openclaw@2026.3.13

sudo npm install -g openclaw@2026.3.13

安装完成后，验证openclaw版本。

openclaw version

如果出现openclaw版本号，则表示安装成功。

终端中输入命令，启动openclaw。

openclaw onboard

启动openclaw：方向键选择Yes，然后回车。

选择QuickStart，快速开始。

选择模型提供商：这里以MiniMax为例

选择模型认证方式：可选网页认证或API Key认证

特别说明：MiniMax有国内版和国际版区别，国内版选择带CN的，国际版选带Global的。

这里选的是API Key认证方式，直接把在MiniMax申请的API Key粘贴进来之后回车，然后选择默认模型（Default Model），回车即可完成模型设置。

后面的Channel、Web search、Skills、Hooks，全部选择跳过，完成配置后，再来分别处理这些。有的项目新手暂时用不上，这里就不展开了。

到这一步，openclaw龙虾的基础配置就完成了，可以启动了。选择Open the Web UI，先在本机的浏览器里，和你的龙虾打个招呼吧。

正确启动龙虾了，给它取个名字，也给它一些基础设定，然后告诉它应该怎么称呼你。现在，你的养虾之旅正式开启。

后面我们会继续介绍如何接入不同的Channel，打通微信、QQ、飞书等IM软件。请持续关注。