本文档介绍了在 Mac mini（特别是 Apple Silicon 芯片 M1/M2/M3）上安装 OpenClaw 的详细步骤。

小贴士：受邀注册可获得 10 元代金券，抵扣 Coding Plan。

https://www.aliyun.com/benefit/ai/aistar?clubBiz=subTask..12406021..10263..

🌰 第一步：安装 Homebrew

Homebrew 是 macOS 的包管理工具，是后续安装的基础。

安装脚本选择

选项 A：官方脚本

⚠️ 注意：国内网络环境下可能遇到连接问题。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

选项 B：国内源脚本（推荐）

✅ 建议使用此脚本，下载速度更快。

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

常见问题处理

  • 缺少 Xcode Command Line Tools：如果出现提示，直接回车按指引安装即可。

  • 网络问题：如遇网络错误，请自行解决网络环境https://mitce.net/aff.php?aff=29583。

Apple Silicon (M1/M2/M3) 特别配置

如果你使用的是 M 系列芯片，安装完成后需要将 Homebrew 添加到环境变量 PATH 中：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

验证安装

运行以下命令检查是否成功：

brew --version

如果显示版本号（如 Homebrew x.x.x），则说明安装成功。

✍️ 第二步：使用 Homebrew 安装 nvm

nvm (Node Version Manager) 用于管理 Node.js 版本。

1. 安装 nvm

brew install nvm

2. 配置环境变量

根据你使用的 Shell 类型选择对应的配置方式：

情况 A：使用 Zsh (macOS Catalina 及以后版本的默认 Shell)

执行以下指令将配置写入 ~/.zshrc：

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"' >> ~/.zshrc
echo '[ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"' >> ~/.zshrc

情况 B：使用 Bash (较旧版本的 macOS)

执行以下指令将配置写入 ~/.bash_profile：

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bash_profile
echo '[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"' >> ~/.bash_profile
echo '[ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"' >> ~/.bash_profile

3. 生效与验证

重新打开终端，或者手动加载配置：

source ~/.zshrc
# 如果是 Bash 用户，请使用 source ~/.bash_profile

验证安装：

nvm --version

📚 第三步：用 nvm 安装 Node.js

安装长期支持版 (LTS) 的 Node.js：

# 安装最新 LTS 版本
nvm install --lts

# 查看当前使用的版本
node -v
npm -v

👍 第四步：通过 npm 安装最新版 OpenClaw

有两种安装方式，推荐优先尝试 npm 方式。

方式一：npm 安装（推荐）

npm install -g openclaw@latest

方式二：官方脚本安装

⚠️ 注意：此方式在某些环境下容易出错。

curl -fsSL https://openclaw.ai/install.sh | bash

第五步：完成初始配置向导

打开阿里百炼控制台，找到对应的API KEY。

首次安装后，OpenClaw 会自动启动配置向导，可以手动执行openclaw onboard命令进行配置。

配置项 (Configuration Item)

建议配置 / 操作 (Suggested Action)

备注 (Notes)

风险提示确认

Yes

确认理解潜在风险并继续

Onboarding mode

QuickStart

快速启动模式

Model/auth provider

Skip for now

稍后配置百炼模型 (Bailian Model)

Filter models by provider

All providers

显示所有提供商的模型

Default model

Keep current

保持当前默认模型

Select channel (QuickStart)

Skip for now

稍后配置渠道

Configure skills now?

No

暂不配置技能 (推荐稍后配置)

Enable hooks?

选中 (Space) → 回车 (Enter)

按空格键勾选，按回车确认

How do you want to hatch your bot?

Do this later

稍后创建/孵化机器人

  1. 使用文本编辑器打开配置文件。如果文件不存在，编辑器会自动创建：

nano ~/.openclaw/openclaw.json

在 JSON 根对象中加入如下 models 配置（如果已存在则替换）。

注：请将 YOUR_API_KEY 替换为 Coding Plan API key。

"models": {
  "mode": "merge",
  "providers": {
    "bailian": {
      "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
      "apiKey": "YOUR_API_KEY",
      "api": "openai-completions",
      "models": [
        {
          "id": "qwen3.5-plus",
          "name": "qwen3.5-plus",
          "reasoning": false,
          "input": ["text", "image"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 1000000,
          "maxTokens": 65536
        },
        {
          "id": "qwen3-max-2026-01-23",
          "name": "qwen3-max-2026-01-23",
          "reasoning": false,
          "input": ["text"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 262144,
          "maxTokens": 65536
        },
        {
          "id": "qwen3-coder-next",
          "name": "qwen3-coder-next",
          "reasoning": false,
          "input": ["text"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 262144,
          "maxTokens": 65536
        },
        {
          "id": "qwen3-coder-plus",
          "name": "qwen3-coder-plus",
          "reasoning": false,
          "input": ["text"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 1000000,
          "maxTokens": 65536
        },
        {
          "id": "MiniMax-M2.5",
          "name": "MiniMax-M2.5",
          "reasoning": false,
          "input": ["text"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 1000000,
          "maxTokens": 65536
        },
        {
          "id": "glm-5",
          "name": "glm-5",
          "reasoning": false,
          "input": ["text"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 202752,
          "maxTokens": 16384
        },
        {
          "id": "glm-4.7",
          "name": "glm-4.7",
          "reasoning": false,
          "input": ["text"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 202752,
          "maxTokens": 16384
        },
        {
          "id": "kimi-k2.5",
          "name": "kimi-k2.5",
          "reasoning": false,
          "input": ["text", "image"],
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
          "contextWindow": 262144,
          "maxTokens": 32768
        }
      ]
    }
  }
}

找到 agents.defaults 对象，并替换或添加以下两个字段：

{
  "model": {
    "primary": "bailian/qwen3.5-plus"
  },
  "models": {
    "bailian/qwen3.5-plus": {},
    "bailian/qwen3-max-2026-01-23": {},
    "bailian/qwen3-coder-next": {},
    "bailian/qwen3-coder-plus": {},
    "bailian/MiniMax-M2.5": {},
    "bailian/glm-5": {},
    "bailian/glm-4.7": {},
    "bailian/kimi-k2.5": {}
  }
}

GML 模型详情：Claude Code、Cline 等 20+ 大编程工具无缝支持。