OpenClaw for macOS: 完整本地化部署指南（2026.2.6-3 版本）

一、文档说明

本文档面向 macOS 系统用户，从基础环境搭建（Node.js 安装） 到 OpenClaw 完整部署，再到问题排查、残余清理，提供全流程标准化操作，适配 OpenClaw 2026.2.6-3 版本，最终实现 DeepSeek 模型的稳定调用。
二、部署前置条件

1. 系统要求

• 操作系统：macOS 10.15+（本文以 MacBook Air (M系列/Intel) 为例）
  
• 权限：拥有终端管理员权限（可执行 sudo 命令）
  
• 网络：能正常访问 DeepSeek API（国内网络直接支持）
  

2. 预期成果

• 完成 Node.js 环境搭建（v24.13.0 及以上）；
  
• OpenClaw 网关正常启动，端口 18789 可访问；
  
• OpenClaw UI 能调用 DeepSeek 模型并返回对话结果。
  

三、基础环境搭建（Node.js 安装）

OpenClaw 基于 Node.js 运行，需先完成 Node.js 安装与版本验证。
步骤1：安装 Homebrew（macOS 包管理器，推荐）

若已安装 Homebrew，跳过此步骤；未安装则执行：

1. /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

复制代码

✅ 验证安装：

1. brew -v

复制代码

输出 Homebrew 4.x.x 即安装成功。
步骤2：安装 Node.js

通过 Homebrew 安装稳定版 Node.js（自动适配 v24+）：

1. brew install node

复制代码

✅ 验证安装与版本：

1. # 查看 Node.js 版本node -v# 查看 npm 版本（Node.js 自带）npm -v

复制代码

• ✅ 输出 node v24.13.0 及以上、npm 10.x.x 即符合要求；
  
• ❌ 若版本过低，执行 brew upgrade node 升级。
  

步骤3：配置 npm 全局路径（可选，避免权限报错）

1. # 创建全局目录mkdir -p ~/.npm-global# 配置 npm 全局路径npm config set prefix '~/.npm-global'# 将全局路径加入环境变量（永久生效）echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc# 生效环境变量source ~/.zshrc

复制代码

✅ 验证配置：

1. npm config get prefix

复制代码

输出 ~/.npm-global 即配置成功。
四、OpenClaw 完整部署流程

步骤1：安装 OpenClaw 包

通过 npm 全局安装 OpenClaw：

1. npm install -g openclaw

复制代码

✅ 验证安装路径：

1. ls ~/.npm-global/lib/node_modules/openclaw

复制代码

输出 OpenClaw 相关文件（如 dist、package.json）即安装成功。
步骤2：OpenClaw 配置文件初始化与修改

OpenClaw 核心配置文件为 ~/.openclaw/openclaw.json，需确保语法合法且适配 DeepSeek 模型。
2.1 初始化配置目录（首次部署）

1. mkdir -p ~/.openclaw

复制代码

2.2 备份原有配置（若有）

1. if [ -f ~/.openclaw/openclaw.json ]; then  mkdir -p ~/.openclaw/backup  cp ~/.openclaw/openclaw.json ~/.openclaw/backup/openclaw.json.bakfi

复制代码

2.3 写入适配 DeepSeek 的无错配置（核心）

执行以下命令，直接写入预验证的合法配置（替换占位符为真实信息）：
[code]cat > ~/.openclaw/openclaw.json

感谢分享，下载保存了，貌似很强大