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 应用开发平台的强大功能。
相关攻略
如何通过 OpenClaw 实现 Chrome 浏览器自动化操控 在软件开发与自动化测试领域,持续学习是常态。本文旨在详细介绍如何利用 OpenClaw 连接并控制一个已开启的 Chrome 浏览器实例,实现点击、文本输入、文件上传、页面滚动、屏幕截图以及执行 JavaScript 等自动化操作。整
项目概述 你是否希望将强大的 AI 助手带入日常聊天?本教程将指导你完成搭建流程,让你能在 QQ 上直接调用 OpenClaw 智能助手,实现无门槛的 AI 对话体验。 架构说明 ┌─────────────┐ ┌──────────────┐ ┌─────────────┐ │ QQ 用户 │ ─
一 下载并安装Node js,全程保持默认设置 首先,请前往Node js官方网站的下载中心:https: nodejs org zh-cn download。根据您的操作系统(Windows Mac Linux)下载对应的安装程序。运行安装向导时,整个过程非常简单,您只需连续点击“下一步”按钮
1 为什么你需要一个飞书机器人? 在当前的团队协作场景中,重复性的通知与提醒工作往往消耗大量精力。你是否也面临这些困扰:每周需要反复催促同事提交周报;每天手动在群聊中发布晨会提醒;项目状态更新后,不得不逐一告知相关人员。这些任务虽看似简单,却极易因人为疏忽而遗漏,成为团队效率提升的隐形障碍。 飞书
工作中数据格式混乱如何高效解决?经纬度格式转换实战指南 在进行黄河流域生态保护或任何涉及空间数据的项目时,最令人头疼的问题莫过于数据格式不统一。尤其是在处理各地上报的经纬度坐标时,同一个字段常常混杂着度分秒(DMS)、十进制度(DD)等多种写法,数据清洗工作费时费力。本文将深入探讨如何利用WorkB
热门专题
热门推荐
微软战略转向:Win11内置应用将全面重构,告别网页套壳以提升性能 你是否感觉Windows 11某些应用响应迟缓,或是内存占用异常偏高?最新消息或许值得关注。据官方透露,微软正调整其应用开发战略,将逐步减少对网页技术的依赖,转而启动大规模原生应用重构计划。这一重大决策,标志着此前推广的“网页化”开
《红色沙漠》全支线任务图文攻略与深度解析 在开放世界大作《红色沙漠》中,丰富多样的支线任务是游戏体验不可或缺的一环。许多玩家初次接触时,可能会对任务系统感到困惑。实际上,每个支线都有其独特的设计思路与完成技巧。例如任务“图尔纳里的请求”,其核心玩法侧重于资源收集与体力劳动,你需要按照指示完成特定的伐
知名破解组织宣布成功突破《EA Sports FC 26》四重防护系统 近日,游戏安全领域传来重磅消息:因屡次攻破高级加密而声名鹊起的破译团队DenuvOwO,正式对外宣告已成功放出针对《EA Sports FC 26》的最新破解方案。该方案直接破解了游戏核心的Denuvo虚拟机加密技术,一石激起千
快速部署指南:基于DeepSeek与飞书的Ubuntu虚拟机镜像,30分钟完成私有AI助手搭建 你是否希望在本地快速搭建一个集成DeepSeek大模型能力、并能通过飞书机器人便捷调用的AI开发环境?我们提供的基于WSL2的Ubuntu预配置虚拟机镜像,正是为你量身打造的“一站式AI应用解决方案”。本
《绝地求生》全新“物品狩猎”躲猫猫模式正式上线:玩法宣传片深度解析 《绝地求生》重磅更新,备受期待的趣味玩法“物品狩猎”模式现已正式推出。这一全新的躲猫猫玩法究竟有何独特之处?官方已发布完整版宣传视频,为玩家们详细揭秘核心规则与对战策略。想要抢先了解新模式的玩家,可以通过本文的介绍一探究竟。 最新发





