背景
在 Apple Silicon(M1/M2/M3/M4,arm64 架构)Mac 上部署 OpenClaw 与普通 x64 环境有所不同。本文档提供详细的环境准备、安装步骤及常见问题解决方案。
环境准备
注意:所有命令必须在原生终端中运行。
-
检查 Node 版本与架构
node -v node -e "console.log(process.platform, process.arch)"- 若输出
darwin x64,说明处于 Rosetta/x64 模式,需调整。 - 应输出
darwin arm64。
- 若输出
-
升级 Node.js 建议升级到最新版 v22,确保自动选择 arm64 二进制文件。
nvm install 22 --reinstall-packages-from=current nvm use 22 nvm alias default 22验证:
node -e "console.log(process.platform, process.arch)" # 必须为 darwin arm64 which node arch -
安装依赖工具 确保 Xcode Command Line Tools 已安装:
xcode-select --install安装 Homebrew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
开始安装
执行安装脚本:
curl -fsSL https://openclaw.ai/install.sh | bash
按提示确认安全风险(Yes)。
- Onboarding mode:选择 QuickStart。
- 模型提供商:选择 OpenRouter。
- 获取 API Key:前往 OpenRouter 创建 API KEY 并保存。
- 配置 Key:返回 OpenClaw 设置页面粘贴 Key。
- 选择模型:在列表中找到
stepfun/step-3.5-flash:free。 - 接入飞书:OpenClaw 已官方集成飞书/Lark,无需额外插件。
- 配置 Skill:按需接入记事本等工具。
- 启动方式:选择 TUI(Terminal UI)进行测试。
测试成功后,启动 Gateway 以支持通信软件互通:
openclaw gateway start


