养虾指南
OpenClaw System Guide
macOS 原生

Mac 本地安装 OpenClaw

macOS 原生安装方案。通过 Homebrew 和 Node.js 搭建本地开发环境,完全免费,数据私有,完美支持 Apple Silicon。

在 Mac 上本地安装 OpenClaw(小龙虾),完全免费、数据完全私有。支持 Apple Silicon(M1/M2/M3/M4)和 Intel Mac,使用 Homebrew 和 Node.js,15 分钟完成部署。Mac mini 是很多养虾人的甜品级方案——性能够用、功耗低、7x24 小时挂着跑。

前置要求

  • macOS 12 (Monterey) 或更高版本
  • Homebrew 包管理器
  • Node.js 22+(LTS 版本)
  • Git(macOS 通常自带)
  • 至少一个大模型 API 密钥
没有 Homebrew?打开终端(按 Cmd+Space 搜索 "Terminal"),粘贴此命令安装:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
1

安装 Node.js 22

使用 Homebrew 安装 Node.js 22 LTS 版本:

Terminal
brew install node@22

安装完成后验证 Node.js 和 npm 版本:

Terminal
node --version\nnpm --version
如果你使用 nvm 管理 Node.js 版本,也可以用 nvm install 22 && nvm use 22 来安装和切换。确保 Node.js 版本 >= 22.0.0。
2

克隆 OpenClaw 仓库

从 GitHub 克隆 OpenClaw 源代码到本地:

Terminal
git clone https://github.com/openclaw/openclaw.git
如果 GitHub 访问较慢,国内用户可以使用镜像加速:git clone https://ghproxy.com/https://github.com/openclaw/openclaw.git
3

安装项目依赖

进入项目目录并安装所有依赖包(这一步可能需要几分钟):

Terminal
cd openclaw && npm install
Apple Silicon (M1/M2/M3/M4) 用户无需任何额外配置,所有依赖都原生支持 ARM64 架构。安装过程和 Intel Mac 完全一致。
4

配置环境变量(.env 文件)

复制示例环境变量文件,然后编辑填入你的 API 密钥:

Terminal
cp .env.example .env

用你喜欢的编辑器(VS Code、nano、vim 等)打开 .env 文件,确保至少配置了一个模型的 API 密钥:

.env
# OpenClaw 环境变量配置
OPENAI_API_KEY=sk-your-openai-api-key
# ANTHROPIC_API_KEY=sk-ant-your-key
# DEEPSEEK_API_KEY=your-deepseek-key

DEFAULT_MODEL=gpt-4o
ACCESS_CODE=your-secure-password
PORT=3210
请务必设置 ACCESS_CODE 访问密码!未设置密码会导致同一 Wi-Fi 网络下的任何设备都能访问你的 OpenClaw。
5

启动 OpenClaw

运行以下命令启动 OpenClaw 服务:

Terminal
npm start

启动成功后,打开浏览器访问以下地址即可开始使用:

Browser
http://localhost:3210
看到 OpenClaw 界面即安装成功!输入 ACCESS_CODE 登录后就可以开始配置你的 AI Agent 了。下次启动只需在项目目录下运行 npm start。

Apple Silicon 兼容性与性能说明

OpenClaw 完全支持 Apple Silicon(M1、M2、M3、M4 系列芯片)。安装过程与 Intel Mac 完全一致,所有 npm 依赖包都提供了原生 ARM64 版本,无需 Rosetta 转译。

Apple Silicon Mac 上运行 OpenClaw 的性能表现非常优秀。得益于统一内存架构和高效的 ARM 指令集,本地推理速度更快、功耗更低。Mac Mini (M4) + OpenClaw 是社区公认的「甜品级养虾方案」——性能强劲、体积小巧、功耗低、24 小时运行无压力。

如果你计划将 Mac 作为 OpenClaw 的长期运行服务器,建议保持电源连接并在系统偏好设置中关闭「自动睡眠」,确保 OpenClaw 服务不会因为系统休眠而中断。

装好了!下一步:喂虾

龙虾装好了但还不会说话——你需要配置大模型 API Key(大脑)和通信工具(嘴巴),让它能思考和对话。

去喂虾(大模型 + 通信工具)