Mac mini 安装OpenClaw

1. 先安装 Node.js

万事开头难，而第一步，就是搭建好 Node.js 这个强大的 JavaScript 运行时环境。用 NVM 来管理 Node.js 版本是个明智的选择，它能让你在不同项目间游刃有余地切换版本。

下载并安装 NVM

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

配置环境

命令执行完毕后，还需要更新一下你的 Shell 配置文件。如果你用的是 Zsh（macOS Catalina 及之后版本的默认 shell），操作如下：

vi ~/.zshrc

#添加以下内容

export NVM_DIR="$HOME/.nvm"

[ -s "/Users/bai/.nvm/nvm.sh" ] && . "/Users/bai/.nvm/nvm.sh"

编辑保存后，别忘了执行 source ~/.zshrc 让配置立即生效。

下载并安装 Node.js

nvm install 24

这里安装的是目前最新的长期支持（LTS）版本之一，稳定性和新特性都有保障。

验证 Node.js 版本

node -v # 打印版本号

验证 npm 版本

npm -v # Should print "11.8.0".

看到版本号正确输出，就说明 Node.js 和自带的包管理器 npm 已经准备就绪了。

2. 安装 pnpm (包管理器)

npm install -g pnpm

pnpm config set registry https://registry.npmmirror.com/

对于 OpenClaw 这类现代项目，强烈推荐使用 pnpm。它不仅安装速度飞快，磁盘空间利用也极为高效。第二行命令是将镜像源切换至国内，能大幅提升后续依赖包的下载速度。

3. 下载 OpenClaw

git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git

cd openclaw-cn

git checkout v2026.2.2-cn

这里我们从 Gitee 的国内镜像仓库克隆项目，速度更理想。克隆完成后，记得切换到指定的中文版本分支，确保教程与代码的一致性。

4. 安装与构建

OpenClaw 是一个功能完备的现代化全栈应用，包含了前后端。因此，首次运行前需要一点时间进行编译构建，这一步必不可少。

安装依赖

pnpm install

进入项目根目录后，首先安装所有项目依赖。得益于 pnpm，这个过程会比传统方式快不少。

构建前端界面

pnpm ui:build

这个命令会编译和打包前端用户界面所需的静态资源。

构建核心服务

pnpm build

接下来，构建后端的核心服务代码，为启动做准备。

启动初始化向导(可选择DeepSeek)

pnpm openclaw onboard --install-daemon

最关键的一步来了。执行这个初始化命令，会启动一个交互式向导。它会引导你完成基础配置，例如设置管理密码、选择 AI 模型提供商等。值得注意的是，在模型选择环节，你可以方便地配置 DeepSeek 等国内优秀的模型。加上 --install-daemon 参数，可以让它以后台服务的形式运行，更符合生产环境的需求。

5. 启动服务 (初始化完成后)

初始化流程顺利走完后，OpenClaw 的核心服务应该已经运行起来了。但如果后续网关服务被关闭，你可以通过以下命令手动重启。

启动网关 (Gateway)

node openclaw.mjs gateway --port 18789 --verbose

网关是处理所有 API 请求的入口，指定端口并添加 --verbose 参数可以获得更详细的运行日志，方便排错。

如果你不小心关闭了浏览器中的管理页面，别担心，不需要重启服务，直接用这个命令就能重新打开。

打开管理面板 (Dashboard)

node openclaw.mjs dashboard

命令执行后，通常会自动在默认浏览器中打开管理后台的登录页面。从这里开始，你就可以尽情配置工作流、管理知识库、体验 AI 智能体的强大能力了。

来源：互联网