Mac mini 安装OpenClaw

1. 安装 Node.js 运行时环境

开始部署 OpenClaw 的第一步，是配置 Node.js 开发环境。我们推荐使用 NVM (Node Version Manager) 来安装和管理 Node.js 版本，这样可以灵活地为不同项目切换所需的运行环境，避免版本冲突问题。

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

下载并安装 NVM

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

配置 Shell 环境变量

上述命令执行完成后，需要将 NVM 的路径加入到系统的 Shell 配置文件中。对于 macOS 系统（Catalina 及更新版本默认使用 Zsh），具体操作步骤为：

vi ~/.zshrc

#添加以下内容

export NVM_DIR="$HOME/.nvm"

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

编辑并保存文件后，务必在终端中执行 source ~/.zshrc 命令，使环境变量的配置立刻生效。

通过 NVM 安装 Node.js

nvm install 24

这里我们选择安装 Node.js 24 这个 LTS (长期支持) 版本，它兼顾了稳定性与对现代 JavaScript 特性的支持，是运行 OpenClaw 的理想选择。

检查 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/

为了获得更快的依赖安装速度和更优的磁盘空间管理，我们推荐使用 pnpm 作为 OpenClaw 项目的包管理器。第二条命令将 pnpm 的镜像源设置为国内地址，这将显著提升后续下载依赖包的速度，尤其是在国内网络环境下。

3. 获取 OpenClaw 项目源码

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

cd openclaw-cn

git checkout v2026.2.2-cn

通过 Gitee 上的国内镜像仓库克隆 OpenClaw 中文版项目，访问更加顺畅。克隆到本地后，请切换到指定的版本标签，以确保你使用的代码与当前教程步骤完全匹配，避免因版本差异导致的部署问题。

4. 项目依赖安装与编译构建

OpenClaw 是一个整合了前端用户界面与后端服务的一体化全栈应用。在首次启动前，需要对源代码进行编译和构建，生成可执行的程序。

安装项目依赖包

pnpm install

进入项目根目录后，首先执行此命令来安装所有必要的依赖项。得益于 pnpm 的硬链接机制，此过程相比传统方式更为迅速。

构建前端用户界面

pnpm ui:build

该命令会编译 React、Vue 等前端框架代码，并打包生成静态资源文件，为后续提供 Web 管理界面做好准备。

构建后端核心服务

pnpm build

此步骤将编译 TypeScript 等后端服务代码，构建出最终可运行的 Node.js 应用。

运行首次初始化向导 (支持配置 DeepSeek)

pnpm openclaw onboard --install-daemon

这是部署过程中最关键的一环。执行此命令将启动一个交互式配置向导，引导您完成管理员账户设置、初始密码设定以及最重要的 AI 大语言模型配置。在模型选择部分，您可以便捷地填入 DeepSeek 等国内主流模型的 API 密钥与参数。--install-daemon 参数会将 OpenClaw 注册为系统后台服务，实现开机自启，适合长期稳定运行。

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

成功完成初始化向导后，OpenClaw 的核心服务通常会自动启动。若后续服务因故停止，您可以使用以下命令手动重启相关组件。

启动 API 网关服务 (Gateway)

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

网关是所有外部 API 请求的统一入口。通过指定端口并启用详细日志模式，您可以方便地监控请求状态并进行故障排查。

如果您关闭了浏览器中的管理页面，无需重启整个服务，直接使用下一个命令即可重新打开。

打开 Web 管理控制台 (Dashboard)

node openclaw.mjs dashboard

执行该命令，系统通常会自动在默认浏览器中弹出 OpenClaw 的管理后台登录页。登录后，您便可以全面开始配置 AI 智能体工作流、管理知识库文档、调试提示词工程，体验新一代 AI 应用开发平台的强大功能。