Mac M 系列芯片 OpenClaw 本地部署指南
在 Mac M 系列芯片上运行 OpenClaw，核心在于解决 Homebrew 环境配置、网络镜像加速以及依赖编译问题。下面按步骤梳理操作细节，遇到报错时对照排查即可。
前置检查
首先确认你的 Mac 是 M 系列芯片（Apple Silicon）：
uname -m # 输出 arm64 即为 M 芯片
如果是 Intel 芯片，后续部分命令路径会有差异，本文主要针对 arm64 架构。
安装依赖与环境配置
1. 安装 Homebrew
如果已安装可跳过，未安装则执行以下命令（M 芯片默认路径为 /opt/homebrew）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
配置环境变量这一步很关键，否则终端找不到 brew 命令：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc
验证安装是否成功：
brew --prefix # 应输出 /opt/homebrew
注意：国内网络环境下，Homebrew 下载容易超时。如果遇到连接 GitHub 失败或超时（如 75002 毫秒），需要配置镜像源。
2. 配置镜像源
若安装过程中出现超时错误，请在终端执行以下命令切换至中科大镜像：
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
配置完成后，建议先测试网络连通性：
curl -v https://github.com
如果输出中包含 Connected to github.com 且无超时，说明网络已优化，可重新执行 Homebrew 安装命令。
针对不同 Shell 的配置
执行 echo $SHELL 查看当前终端类型：
-
Bash (
/bin/bash)：需修改~/.bash_profile。[ -f ~/.zshrc ]; sed -i ~/.zshrc; >> ~/.bash_profile >> ~/.bash_profile ~/.bash_profile
