Figo关于OpenClaw（MacOS）安装前环境变量设置保姆级教程

OpenClaw（MacOS）安装前环境变量设置保姆级教程

基于前期本地部署OpenClaw的成功经验，本教程聚焦MacOS系统，从环境检查、核心依赖安装、环境变量配置到验证生效，全程手把手操作，零基础也能完成，为OpenClaw顺利安装和运行打下基础。

一、前置准备

终端打开 ：MacOS下按下Command + 空格，输入终端，回车打开（后续所有命令均在终端执行）；
权限确认 ：确保当前Mac账号有管理员权限（执行命令时需输入电脑开机密码，密码输入时终端不显示，直接输入回车即可）；
网络要求：关闭VPN/代理，使用直连网络（避免依赖安装、域名解析失败）。

二、核心环境检查（先查再配，避免重复操作）

OpenClaw运行依赖Node.js 、npm 、Ollama，且需确认终端执行环境（zsh/bash），先执行以下命令检查现有环境，无需重复安装已存在的依赖。

2.1 检查终端执行环境（MacOS默认zsh）

执行命令：

bash 复制代码

echo $SHELL

输出/bin/zsh：默认zsh环境（主流，本教程以zsh为例）；
输出/bin/bash：bash环境（需将教程中~/.zshrc替换为~/.bash_profile）。

2.2 检查Node.js & npm（OpenClaw脚本运行核心）

执行命令：

bash 复制代码

node -v && npm -v

若输出版本号 （如v20.10.0、10.2.3）：已安装，跳过【三、1 安装Node.js&npm】；
若输出command not found：未安装，需按后续步骤安装。

2.3 检查Ollama（本地AI模型运行核心）

执行命令：

bash 复制代码

ollama -v

若输出版本号 （如ollama version 0.1.48）：已安装，跳过【三、2 安装Ollama】；
若输出command not found：未安装，需按后续步骤安装。

三、核心依赖安装（无则装，有则跳过）

3.1 安装Node.js & npm（一键安装，含环境变量）

推荐使用Homebrew安装（MacOS包管理工具，简洁无坑），若未安装Homebrew，先执行以下命令安装：

bash 复制代码

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

Homebrew安装完成后，执行以下命令安装Node.js&npm（自动配置基础环境变量，无需手动改）：

bash 复制代码

brew install node

安装完成后，重新执行node -v && npm -v验证，输出版本号即成功。

3.2 安装Ollama（本地模型核心，自动配置环境）

执行官方一键安装命令（自动配置环境变量，支持全局调用ollama命令）：

bash 复制代码

curl -fsSL https://ollama.com/install.sh | sh

安装完成后，执行ollama -v验证，输出版本号即成功；
额外操作：提前拉取一个模型（如GPT-OSS:20B），避免后续OpenClaw调用时等待，执行：

bash 复制代码

ollama pull gpt-oss:20b

四、环境变量核心配置（保姆级手动配置，确保全局生效）

OpenClaw运行需确保Node.js 、npm 、Ollama 、pm2 （后续安装）的命令全局可调用 ，Homebrew安装的依赖已自动配置基础环境变量，本步骤主要做补全配置+验证+永久生效 ，避免后续出现command not found错误。

4.1 打开环境变量配置文件（zsh为例，bash替换为~/.bash_profile）

执行命令（直接打开zsh核心配置文件，无则自动创建）：

bash 复制代码

open -a TextEdit ~/.zshrc

若弹出文本编辑窗口，说明文件存在/已创建，直接进入下一步；
若提示错误，执行touch ~/.zshrc创建文件后，重新执行上述命令。

4.2 写入环境变量配置（复制粘贴，无需修改）

在打开的文本编辑窗口 中，将以下内容粘贴到文件末尾（确保原有内容不删除，仅追加）：

bash 复制代码

# OpenClaw环境变量配置 - Node.js&npm（Homebrew安装路径）
export PATH="/usr/local/bin:/usr/local/sbin:$PATH"
export PATH="$HOME/.brew/bin:$PATH"

# OpenClaw环境变量配置 - Ollama（全局调用）
export PATH="$HOME/.ollama/bin:$PATH"

# OpenClaw环境变量配置 - pm2（后续进程管理工具）
export PATH="$HOME/.npm-global/bin:$PATH"

# 环境变量生效刷新
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

4.3 保存配置文件并关闭

按下Command + S保存，直接关闭文本编辑窗口（必须保存，否则配置失效）。

4.4 让环境变量立即生效（核心步骤，缺一不可）

回到终端，执行以下命令，让刚配置的环境变量立即生效（无需重启终端/电脑）：

bash 复制代码

source ~/.zshrc

若为bash环境，执行source ~/.bash_profile。

五、补充依赖安装（OpenClaw运维核心，含环境变量验证）

安装pm2 （进程管理工具，让OpenClaw后台持久运行）和ngrok（公网穿透，实现企业微信双向交互），并验证其环境变量是否生效。

5.1 安装pm2（全局安装，确保全局可调用）

执行命令（全局安装，自动适配已配置的环境变量）：

bash 复制代码

npm install -g pm2

安装完成后，执行以下命令验证环境变量（输出版本号即生效）：

bash 复制代码

pm2 -v

若输出command not found，重新执行source ~/.zshrc刷新环境变量即可。

5.2 安装ngrok（公网穿透核心，Homebrew一键安装）

执行命令（Homebrew安装，自动配置环境变量）：

bash 复制代码

brew install ngrok/ngrok/ngrok

安装完成后，执行以下命令验证（输出版本号即生效）：

bash 复制代码

ngrok -v

提前配置ngrok authtoken（避免后续启动报错ERR_NGROK_4018）：

浏览器访问https://dashboard.ngrok.com/signup，免费注册并验证邮箱；
登录后复制「Your Authtoken」（一串字符）；
终端执行命令（替换为自己的authtoken）：
bash 复制代码
```
ngrok config add-authtoken 你的ngrokauthtoken
```

配置完成后，执行ngrok config check验证，输出Valid configuration file即成功。

六、环境变量&依赖最终全量验证

执行以下一站式验证命令 ，所有依赖均输出版本号，说明环境变量配置100%成功，可正式安装OpenClaw：

bash 复制代码

# 验证终端环境
echo $SHELL
# 验证Node.js & npm
node -v && npm -v
# 验证Ollama
ollama -v
# 验证pm2
pm2 -v
# 验证ngrok
ngrok -v

理想输出示例：

复制代码

/bin/zsh
v20.10.0
10.2.3
ollama version 0.1.48
5.3.0
ngrok version 3.8.0

七、MacOS环境配置关键避坑点

不要手动修改系统级环境变量 （如/etc/profile），仅修改用户级配置（~/.zshrc/~/.bash_profile），避免权限问题；
每次修改配置文件后，必须执行source 配置文件，否则环境变量不生效；
安装依赖时关闭VPN/代理，否则会出现"下载超时""域名解析失败"；
密码输入提示 ：终端执行sudo/管理员命令时，输入开机密码无字符显示，直接输入后回车即可，并非输入失败；
Homebrew安装失败 ：若提示网络错误，可更换国内源（执行/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"）。

八、环境配置成功后，OpenClaw安装前置准备

下载OpenClaw源码，解压到固定路径 （推荐/Users/你的用户名/Desktop/openclaw-main，后续不随意移动，避免pm2找不到脚本）；
进入OpenClaw目录，验证Node.js脚本运行环境：
bash 复制代码
```
cd /Users/你的用户名/Desktop/openclaw-main
node -e "console.log('OpenClaw环境准备成功')"
```
若输出OpenClaw环境准备成功，说明环境完全适配，可正式配置OpenClaw脚本。

总结

本教程完成了OpenClaw在MacOS下运行的全量环境依赖安装+环境变量永久配置+全量验证，核心关键点：

优先检查现有环境，避免重复安装；
所有依赖通过Homebrew/官方一键命令安装，减少手动配置坑；
环境变量仅修改用户级配置文件（~/.zshrc），安全无风险；
每一步配置后均做验证，确保问题提前发现；
提前配置ngrok authtoken、拉取Ollama模型，为后续OpenClaw一键启动铺路。

环境配置成功后，后续仅需修改OpenClaw脚本中的核心配置，即可通过pm2启动OpenClaw，实现「本地Ollama+OpenClaw」的完整联动。