OpenClaw 在 MacOS 系统下的安装环境配置涉及 Node.js、npm、Ollama 等核心依赖的安装与全局环境变量设置。教程涵盖终端环境检查、Homebrew 包管理工具使用、配置文件修改及生效验证步骤。重点包括通过 .zshrc 或 .bash_profile 添加路径，确保命令全局可调用，以及安装 pm2 和 ngrok 实现进程管理和公网穿透。最终通过版本检查确认环境就绪，为后续 OpenClaw 脚本运行奠定基础。
本教程聚焦 MacOS 系统，从环境检查、核心依赖安装、环境变量配置到验证生效，全程操作指导，为 OpenClaw 顺利安装和运行打下基础。
Command + 空格，输入 终端，回车打开（后续所有命令均在终端执行）；OpenClaw 运行依赖 Node.js、npm、Ollama，且需确认终端执行环境（zsh/bash），先执行以下命令检查现有环境，无需重复安装已存在的依赖。
执行命令：
echo $SHELL
/bin/zsh：默认 zsh 环境（主流，本教程以 zsh 为例）；/bin/bash：bash 环境（需将教程中 ~/.zshrc 替换为 ~/.bash_profile）。执行命令：
node -v && npm -v
v20.10.0、10.2.3）：已安装，跳过【三、1 安装 Node.js&npm】；command not found：未安装，需按后续步骤安装。执行命令：
ollama -v
ollama version 0.1.48）：已安装，跳过【三、2 安装 Ollama】；command not found：未安装，需按后续步骤安装。推荐使用 Homebrew 安装（MacOS 包管理工具，简洁无坑），若未安装 Homebrew，先执行以下命令安装：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Homebrew 安装完成后，执行以下命令安装 Node.js&npm（自动配置基础环境变量，无需手动改）：
brew install node
安装完成后，重新执行 node -v && npm -v 验证，输出版本号即成功。
执行官方一键安装命令（自动配置环境变量，支持全局调用 ollama 命令）：
curl -fsSL https://ollama.com/install.sh | sh
安装完成后，执行 ollama -v 验证，输出版本号即成功；
额外操作：提前拉取一个模型（如 GPT-OSS:20B），避免后续 OpenClaw 调用时等待，执行：
ollama pull gpt-oss:20b
OpenClaw 运行需确保 Node.js、npm、Ollama、pm2（后续安装）的命令全局可调用，Homebrew 安装的依赖已自动配置基础环境变量，本步骤主要做补全配置 + 验证 + 永久生效，避免后续出现 command not found 错误。
执行命令（直接打开 zsh 核心配置文件，无则自动创建）：
open -a TextEdit ~/.zshrc
touch ~/.zshrc 创建文件后，重新执行上述命令。在打开的文本编辑窗口中，将以下内容粘贴到文件末尾（确保原有内容不删除，仅追加）：
# 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"
按下 Command + S 保存，直接关闭文本编辑窗口（必须保存，否则配置失效）。
回到终端，执行以下命令，让刚配置的环境变量立即生效（无需重启终端/电脑）：
source ~/.zshrc
source ~/.bash_profile。安装 pm2（进程管理工具，让 OpenClaw 后台持久运行）和 ngrok（公网穿透，实现企业微信双向交互），并验证其环境变量是否生效。
执行命令（全局安装，自动适配已配置的环境变量）：
npm install -g pm2
安装完成后，执行以下命令验证环境变量（输出版本号即生效）：
pm2 -v
command not found，重新执行 source ~/.zshrc 刷新环境变量即可。执行命令（Homebrew 安装，自动配置环境变量）：
brew install ngrok/ngrok/ngrok
安装完成后，执行以下命令验证（输出版本号即生效）：
ngrok -v
提前配置 ngrok authtoken（避免后续启动报错 ERR_NGROK_4018）：
终端执行命令（替换为自己的 authtoken）：
ngrok config add-authtoken 你的 ngrokauthtoken
配置完成后，执行 ngrok config check 验证，输出 Valid configuration file 即成功。
执行以下一站式验证命令，所有依赖均输出版本号，说明环境变量配置 100% 成功，可正式安装 OpenClaw：
# 验证终端环境
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
/etc/profile），仅修改用户级配置（~/.zshrc/~/.bash_profile），避免权限问题；source 配置文件，否则环境变量不生效；sudo/管理员命令时，输入开机密码无字符显示，直接输入后回车即可，并非输入失败；/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"）。/Users/你的用户名/Desktop/openclaw-main，后续不随意移动，避免 pm2 找不到脚本）；进入 OpenClaw 目录，验证 Node.js 脚本运行环境：
cd /Users/你的用户名/Desktop/openclaw-main
node -e "console.log('OpenClaw 环境准备成功')"
若输出 OpenClaw 环境准备成功，说明环境完全适配，可正式配置 OpenClaw 脚本。
本教程完成了 OpenClaw 在 MacOS 下运行的全量环境依赖安装 + 环境变量永久配置 + 全量验证，核心关键点：
环境配置成功后，后续仅需修改 OpenClaw 脚本中的核心配置，即可通过 pm2 启动 OpenClaw，实现「本地 Ollama+OpenClaw」的完整联动。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online