openclaw mac 配置更新版
参考
本指南的核心部署方案基于名为《OpenClaw for macOS: 完整本地化部署指南(2026.2.6-3 版本)》的第三方文档。原文在前2.4小节前的流程具备良好的可操作性。为确保在常见macOS环境下部署成功,我们针对后续步骤中遇到的潜在代码执行问题,对相关命令和配置点进行了必要的校验与修正。
参考来源:OpenClaw for macOS: 完整本地化部署指南(2026.2.6-3 版本) - 小白跃升坊 - 博客园
一、文档说明
这是一份面向macOS用户的OpenClaw应用部署手册。我们将从零开始,逐步完成运行环境配置、核心服务部署、接口验证及问题诊断的全过程。流程基于OpenClaw 2026.2.6-3版本调优,最终目标是在你的本地设备上,建立一个能稳定连接并调用DeepSeek API的功能性网关。
二、部署前置条件
1. 系统要求
- 操作系统:macOS Catalina (10.15) 或更新版本(兼容Apple Silicon M芯片与Intel处理器的MacBook Air/Pro系列)。
- 权限要求:需要具备终端的管理员权限(能够执行
sudo命令)。 - 网络环境:确保能够正常访问DeepSeek官方API。当前该服务在国内网络环境下可直连,无需设置代理。
2. 预期成果
- 完成Node.js运行环境搭建,版本不低于v24.13.0。
- 在本地成功启动OpenClaw网关服务,并通过指定端口(默认18789)进行访问。
- 通过OpenClaw的Web用户界面,完成对DeepSeek模型的调用测试,并获取完整的对话响应。
三、基础环境搭建(Node.js 安装)
OpenClaw的运行依赖于Node.js。因此,部署的第一步是确保你的系统安装了兼容版本的Node.js。以下步骤将引导你完成环境准备。
步骤1:安装 Homebrew(macOS 包管理器,推荐)
此步骤为可选项,但强烈建议执行。Homebrew能极大简化macOS上的软件安装与依赖管理过程,为后续操作提供便利。若你的系统已安装Homebrew,请直接跳至下一步。
打开终端应用,复制并执行以下安装命令:
/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"
✅ 安装验证:
安装完毕后,在终端中输入以下命令以验证安装成功:
brew -v
如果终端返回类似Homebrew 4.x.x的版本信息,则表明Homebrew已就绪。
步骤2:安装 Node.js
通过Homebrew安装Node.js是最为便捷的方式,它会自动处理版本兼容性与依赖关系(当前默认会安装v24或更高版本)。
在终端中执行安装命令:
brew install node
✅ 安装验证与版本检查:
安装完成后,请按顺序执行以下两条命令,验证Node.js及其包管理器npm的安装状态,并核对版本号:
# 查看 Node.js 版本
node -v
# 查看 npm 版本
npm -v
请确认node -v输出的版本号不低于24.13.0。至此,基础运行环境配置完成。