Apple Silicon ARM64 架构 macOS 部署 OpenClaw

背景

在 Apple Silicon（M1/M2/M3/M4，arm64 架构）Mac 上部署 OpenClaw 与普通 x64 环境有所不同。本文档提供详细的环境准备、安装步骤及常见问题解决方案。

环境准备

注意：所有命令必须在原生终端中运行。

1. 检查 Node 版本与架构

   node -v
   node -e "console.log(process.platform, process.arch)"
   

   • 若输出 darwin x64，说明处于 Rosetta/x64 模式，需调整。
   • 应输出 darwin arm64。

2. 升级 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
   

3. 安装依赖工具 确保 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）。

1. Onboarding mode：选择 QuickStart。
2. 模型提供商：选择 OpenRouter。
3. 获取 API Key：前往 OpenRouter 创建 API KEY 并保存。
4. 配置 Key：返回 OpenClaw 设置页面粘贴 Key。
5. 选择模型：在列表中找到 stepfun/step-3.5-flash:free。
6. 接入飞书：OpenClaw 已官方集成飞书/Lark，无需额外插件。
7. 配置 Skill：按需接入记事本等工具。
8. 启动方式：选择 TUI（Terminal UI）进行测试。

测试成功后，启动 Gateway 以支持通信软件互通：

openclaw gateway start

飞书配置