OpenClaw(MacOS)安装前环境变量设置教程
基于前期本地部署 OpenClaw 的成功经验,本教程聚焦MacOS 系统,从环境检查、核心依赖安装、环境变量配置到验证生效,全程手把手操作,为 OpenClaw 顺利安装和运行打下基础。
一、前置准备
- 终端打开:MacOS 下按下
Command + 空格,输入终端,回车打开(后续所有命令均在终端执行); - 权限确认:确保当前 Mac 账号有管理员权限(执行命令时需输入电脑开机密码,密码输入时终端不显示,直接输入回车即可);
- 网络要求:关闭 VPN/代理,使用直连网络(避免依赖安装、域名解析失败)。
二、核心环境检查(先查再配,避免重复操作)
OpenClaw 运行依赖Node.js、npm、Ollama,且需确认终端执行环境(zsh/bash),先执行以下命令检查现有环境,无需重复安装已存在的依赖。
2.1 检查终端执行环境(MacOS 默认 zsh)
执行命令:
echo $SHELL
- 输出
/bin/zsh:默认 zsh 环境(主流,本教程以 zsh 为例); - 输出
/bin/bash:bash 环境(需将教程中~/.zshrc替换为~/.bash_profile)。
2.2 检查 Node.js & npm(OpenClaw 脚本运行核心)
执行命令:
node -v && npm -v
- 若输出版本号(如
v20.10.0、10.2.3):已安装,跳过【三、1 安装 Node.js&npm】; - 若输出
command not found:未安装,需按后续步骤安装。
2.3 检查 Ollama(本地 AI 模型运行核心)
执行命令:
ollama -v
- 若输出版本号(如
ollama version 0.1.48):已安装,跳过【三、2 安装 Ollama】; - 若输出
command not found:未安装,需按后续步骤安装。
三、核心依赖安装(无则装,有则跳过)
3.1 安装 Node.js & npm(一键安装,含环境变量)
推荐使用Homebrew安装(MacOS 包管理工具,简洁无坑),若未安装 Homebrew,先执行以下命令安装:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Homebrew 安装完成后,执行以下命令安装 Node.js&npm(自动配置基础环境变量,无需手动改):

