Shell / BashNode.jsAI
Mac M 芯片 OpenClaw 环境搭建与运行指南
在 Mac M 系列芯片设备上安装和配置 OpenClaw 的详细步骤。内容包括前置硬件检查、Homebrew 环境配置（含镜像源设置）、编译依赖安装（CMake、SDL2 等）、源码克隆及构建流程。通过 pnpm 管理项目依赖，完成初始化向导并配置 Google Places API Key 及大模型接口密钥，最终启动网关与管理界面实现本地部署。
在 Mac M 系列芯片设备上安装和配置 OpenClaw 的详细步骤。内容包括前置硬件检查、Homebrew 环境配置（含镜像源设置）、编译依赖安装（CMake、SDL2 等）、源码克隆及构建流程。通过 pnpm 管理项目依赖，完成初始化向导并配置 Google Places API Key 及大模型接口密钥，最终启动网关与管理界面实现本地部署。
确认你的 Mac 是 M 系列芯片：
uname -m # 输出 arm64 说明是 M 芯片
如果已装 Homebrew，跳过此步；未安装则执行：
# 安装 Homebrew（M 芯片默认路径：/opt/homebrew）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 配置 Homebrew 环境变量（M 芯片必须，否则 brew 命令找不到）
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc
# 验证 Homebrew 路径
brew --prefix # 输出 /opt/homebrew 即为正确
若安装过程中出现超时或连接 GitHub 失败（如 443 端口超时），需配置镜像源。终端执行如下命令：
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"
Bash 终端：
如果 echo $SHELL 输出 /bin/bash，请修改 ~/.bash_profile：
# 删除可能存在的错误 zshrc 配置
if [ -f ~/.zshrc ]; then
sed -i '' '/HOMEBREW_BOTTLE_DOMAIN/d' ~/.zshrc
sed -i '' '/HOMEBREW_API_DOMAIN/d' ~/.zshrc
fi
# 配置 brew 镜像到 bash 配置文件
echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"' >> ~/.bash_profile
echo 'export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"' >> ~/.bash_profile
source ~/.bash_profile
Zsh 终端：
如果 echo $SHELL 输出 /bin/zsh，修复文件权限后配置：
# 修复 .zshrc 文件的所有权
sudo chown $(whoami):staff ~/.zshrc
chmod 644 ~/.zshrc
# 重新配置镜像
echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"' >> ~/.zshrc
echo 'export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"' >> ~/.zshrc
source ~/.zshrc
验证环境变量是否生效：
echo $HOMEBREW_BOTTLE_DOMAIN
echo $HOMEBREW_API_DOMAIN
# 应分别输出 mirrors.ustc.edu.cn 相关地址
# 安装 Xcode 命令行工具（C++ 编译环境）
xcode-select --install
# 安装 OpenClaw 核心依赖（SDL2 系列+CMake）
brew install cmake sdl2 sdl2_image sdl2_mixer sdl2_ttf
# 验证依赖安装路径
ls /opt/homebrew/lib/cmake/SDL2 # 有文件说明 SDL2 安装成功
国内镜像更快，推荐优先尝试 Gitee 官方中文仓库：
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
cd openclaw-cn
若遇到网络问题，可尝试其他镜像：
git clone https://gitee.com/mirrors/OpenClaw.git
如果是 Gitee 中文官方仓库，需先安装 pnpm：
npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com/
执行以下命令完成项目构建与初始化：
# 1. 安装依赖
pnpm install
# 2. 首次构建 UI 依赖
pnpm ui:build
# 3. 构建项目
pnpm build
# 4. 启动初始化向导
pnpm openclaw onboard --install-daemon
按提示设置 google_places_api_key。初始化完成后再次启动网关：
pnpm openclaw gateway
如需打开管理界面：
pnpm openclaw dashboard
启动网关后服务将在本地部署，打开本地管理界面即可查看。需配置相应模型并获取对应的 API KEY（消耗 token）才能进行对话和执行大模型操作。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 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