跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashNode.jsWeChatAI

OpenClaw MacOS 安装前环境变量配置指南

OpenClaw 在 MacOS 系统下的安装环境配置涉及 Node.js、npm、Ollama 等核心依赖的安装与全局环境变量设置。教程涵盖终端环境检查、Homebrew 包管理工具使用、配置文件修改及生效验证步骤。重点包括通过 .zshrc 或 .bash_profile 添加路径,确保命令全局可调用,以及安装 pm2 和 ngrok 实现进程管理和公网穿透。最终通过版本检查确认环境就绪,为后续 OpenClaw 脚本运行奠定基础。

奇形怪状发布于 2026/3/26更新于 2026/10/25103 浏览

OpenClaw(MacOS)安装前环境变量设置

本教程聚焦 MacOS 系统,从环境检查、核心依赖安装、环境变量配置到验证生效,全程操作指导,为 OpenClaw 顺利安装和运行打下基础。

一、前置准备

  1. 终端打开:MacOS 下按下 Command + 空格,输入 终端,回车打开(后续所有命令均在终端执行);
  2. 权限确认:确保当前 MacOS 账号有管理员权限(执行命令时需输入电脑开机密码,密码输入时终端不显示,直接输入回车即可);
  3. 网络要求:关闭 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(自动配置基础环境变量,无需手动改):

brew install node

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

3.2 安装 Ollama(本地模型核心,自动配置环境)

执行官方一键安装命令(自动配置环境变量,支持全局调用 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 错误。

4.1 打开环境变量配置文件(zsh 为例,bash 替换为 ~/.bash_profile)

执行命令(直接打开 zsh 核心配置文件,无则自动创建):

open -a TextEdit ~/.zshrc
  • 若弹出文本编辑窗口,说明文件存在/已创建,直接进入下一步;
  • 若提示错误,执行 touch ~/.zshrc 创建文件后,重新执行上述命令。
4.2 写入环境变量配置(复制粘贴,无需修改)

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

# 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 让环境变量立即生效(核心步骤,缺一不可)

回到终端,执行以下命令,让刚配置的环境变量立即生效(无需重启终端/电脑):

source ~/.zshrc
  • 若为 bash 环境,执行 source ~/.bash_profile。

五、补充依赖安装(OpenClaw 运维核心,含环境变量验证)

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

5.1 安装 pm2(全局安装,确保全局可调用)

执行命令(全局安装,自动适配已配置的环境变量):

npm install -g pm2

安装完成后,执行以下命令验证环境变量(输出版本号即生效):

pm2 -v
  • 若输出 command not found,重新执行 source ~/.zshrc 刷新环境变量即可。
5.2 安装 ngrok(公网穿透核心,Homebrew 一键安装)

执行命令(Homebrew 安装,自动配置环境变量):

brew install ngrok/ngrok/ngrok

安装完成后,执行以下命令验证(输出版本号即生效):

ngrok -v

提前配置 ngrok authtoken(避免后续启动报错 ERR_NGROK_4018):

  1. 浏览器访问 https://dashboard.ngrok.com/signup,免费注册并验证邮箱;
  2. 登录后复制「Your Authtoken」(一串字符);

终端执行命令(替换为自己的 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

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

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

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

  1. 下载 OpenClaw 源码,解压到固定路径(推荐 /Users/你的用户名/Desktop/openclaw-main,后续不随意移动,避免 pm2 找不到脚本);

进入 OpenClaw 目录,验证 Node.js 脚本运行环境:

cd /Users/你的用户名/Desktop/openclaw-main
node -e "console.log('OpenClaw 环境准备成功')"

若输出 OpenClaw 环境准备成功,说明环境完全适配,可正式配置 OpenClaw 脚本。

总结

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

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

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

目录

  1. OpenClaw(MacOS)安装前环境变量设置
  2. 一、前置准备
  3. 二、核心环境检查(先查再配,避免重复操作)
  4. 2.1 检查终端执行环境(MacOS 默认 zsh)
  5. 2.2 检查 Node.js & npm(OpenClaw 脚本运行核心)
  6. 2.3 检查 Ollama(本地 AI 模型运行核心)
  7. 三、核心依赖安装(无则装,有则跳过)
  8. 3.1 安装 Node.js & npm(一键安装,含环境变量)
  9. 3.2 安装 Ollama(本地模型核心,自动配置环境)
  10. 四、环境变量核心配置(手动配置,确保全局生效)
  11. 4.1 打开环境变量配置文件(zsh 为例,bash 替换为 ~/.bash_profile)
  12. 4.2 写入环境变量配置(复制粘贴,无需修改)
  13. OpenClaw 环境变量配置 - Node.js&npm(Homebrew 安装路径)
  14. OpenClaw 环境变量配置 - Ollama(全局调用)
  15. OpenClaw 环境变量配置 - pm2(后续进程管理工具)
  16. 环境变量生效刷新
  17. 4.3 保存配置文件并关闭
  18. 4.4 让环境变量立即生效(核心步骤,缺一不可)
  19. 五、补充依赖安装(OpenClaw 运维核心,含环境变量验证)
  20. 5.1 安装 pm2(全局安装,确保全局可调用)
  21. 5.2 安装 ngrok(公网穿透核心,Homebrew 一键安装)
  22. 六、环境变量&依赖最终全量验证
  23. 验证终端环境
  24. 验证 Node.js & npm
  25. 验证 Ollama
  26. 验证 pm2
  27. 验证 ngrok
  28. 七、MacOS 环境配置关键避坑点
  29. 八、环境配置成功后,OpenClaw 安装前置准备
  30. 总结

更多推荐文章

查看全部
  • 解决 JavaScript 浮点数精度丢失与金额分摊难题
  • JavaSE 多线程:JUC 核心组件介绍
  • 解决复杂查询难题:通过 Self-querying Prompting 优化 RAG 系统效率
  • JavaScript 中 =、== 和 === 的区别与使用建议
  • 长亭 Xray Web 漏洞扫描器实战指南
  • Android 开发常用开源库推荐与技术解析
  • 基于 OpenClaw 与 Claude 的自动化写作工作流实践
  • 安路 FPGA 下载器驱动安装与测试指南
  • 无人机红外照片处理中的温度校准与精度优化策略
  • OpenAI Codex 终端 AI 编程助手安装与配置指南
  • YOLO 结合大模型的多场景智能检测系统架构与实践
  • Visual C++运行库一键安装方案:解决 DLL 缺失错误
  • GitHub Copilot 使用体验与实战场景分析
  • AIGC 中的变分自编码器(VAE)原理与 PyTorch 实战
  • 2023 年数据分析行业发展前景与高薪领域分析
  • 哈希算法原理与实战:从 SHA-0 到应用场景详解
  • 基于 Java 和 Leaflet 的湖南省道路长度 WebGIS 系统构建
  • Huobao Drama 开源短剧生成平台:从剧本到视频
  • JDK 17 新特性整理
  • 使用 cpolar 内网穿透实现 OpenClaw 远程访问

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online