Mac 上安装 OpenClaw：一篇搞定（含 zsh / bash 环境变量与避坑）
目标读者：第一次在 macOS 上安装 OpenClaw 的同学
特点：步骤短、坑点全、装完能跑
一、环境准备（Mac）
先确认基础环境：
建议：
• 芯片：Apple Silicon（arm64）或 Intel 都可
• Node.js：建议使用较新 LTS（推荐 20+）
• npm：跟随 Node 更新即可
如果没有 Node，推荐用 nvm 安装（方便多版本切换）。
二、安装 OpenClaw
GPT plus 代充 只需 145
安装后验证：
如果看到版本号和帮助信息，说明安装成功。
三、重点：mac 默认 zsh，为什么你配了 bash 却不生效？
很多教程会让你改 ~/.bashrc 或 ~/.bash_profile，但macOS 终端默认 shell 是 zsh，所以你改了 bash 文件，zsh 会“看不见”。
1）先确认当前 shell
GPT plus 代充 只需 145
• 如果输出 /bin/zsh：你应改 ~/.zshrc
• 如果输出 /bin/bash：你应改 ~/.bashrc 或 ~/.bash_profile
2）把 npm 全局 bin 加到 PATH（以 zsh 为例）
假设返回 /opt/homebrew 或你自定义目录，把它的 bin 加进 PATH：
GPT plus 代充 只需 145
生效：
再测：
GPT plus 代充 只需 145
四、初始化与运行（最小可用）
如果服务未运行，再看网关状态：
GPT plus 代充 只需 145
常用命令：
五、常见问题（高频）
1）zsh: command not found: openclaw
原因：PATH 没配到当前 shell。
排查顺序：
GPT plus 代充 只需 145
2）全局安装报权限错误（EACCES）
不要乱用 sudo npm -g。推荐两种方案：
• 用 nvm 管理 Node（首选）
• 或配置 npm 全局目录到用户目录，再把该目录 bin 加入 PATH
3）装了但命令版本不对 / 命令冲突
看是否有多个路径命中（旧版本残留）。
解决思路：清理旧路径、保证 PATH 顺序正确、重新安装一次。
4）网关起不来 / 状态异常 先看：
GPT plus 代充 只需 145
再尝试：
若仍失败，建议记录报错日志（尤其端口占用、权限、网络问题）。
六、我自己的安装建议（省时间版）
- 用 nvm 装 Node（避免权限坑）
- 明确你是 zsh 还是 bash（90% Mac 用户是 zsh）
- PATH 只改当前 shell 对应配置文件
- 安装后先跑 openclaw –version + openclaw status，不要直接上复杂配置
七、总结 在 Mac 上安装 OpenClaw 本身不难，真正容易卡住的是两件事：
• Shell 搞错（zsh vs bash）*
• PATH 没生效*
把这两点理顺，基本就是 10 分钟可完成安装与启动。
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/233909.html