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

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

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

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

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

执行命令：

• 输出：默认zsh环境（主流，本教程以zsh为例）；
• 输openclaw 安装出：bash环境（需将教程中替换为）。

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

执行命令：

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

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

执行命令：

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

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

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

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

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

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

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

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

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

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

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

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

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

4.3 保存配置文件并关闭

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

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

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

• 若为bash环境，执行。

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

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

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

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

• 若输出，重新执行刷新环境变量即可。

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

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

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

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

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

配置完成后，执行验证，输出即成功。

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

理想输出示例：

1. 不要手动修改系统级环境变量 （如），仅修改用户级配置（/），避免权限问题；
2. 每次修改配置文件后，必须执行，否则环境变量不生效；
3. 安装依赖时关闭VPN/代理，否则会出现”下载超时””域名解析失败”；
4. 密码输入提示 ：终端执行/管理员命令时，输入开机密码无字符显示，直接输入后回车即可，并非输入失败；
5. Homebrew安装失败 ：若提示网络错误，可更换国内源（执行）。

1. 下载OpenClaw源码，解压到固定路径 （推荐，后续不随意移动，避免pm2找不到脚本）；
2. 进入OpenClaw目录，验证Node.js脚本运行环境：

   若输出，说明环境完全适配，可正式配置OpenClaw脚本。

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

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

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