2026 年，OpenClaw 已成为最受欢迎的个人 AI 智能体框架。本文手把手带你从零开始在 Mac 上完成 OpenClaw 本地部署，每一条指令都经过实测验证，每个步骤都附带了可能遇到的问题及解决方案。
📋 部署前必读：你的 Mac 够格”养虾”吗？
硬件要求（别担心，要求不高）
- 操作系统：macOS 12 (Monterey) 及以上，推荐 macOS 13 (Ventura) 或更高
- 内存：≥8GB，推荐 16GB，多任务更流畅
- 硬盘空间：≥2GB 可用空间，实际占用约 1.5GB
- 芯片：Intel 或 Apple Silicon 均可，M1/M2/M3 芯片性能提升约 30%
你需要准备的东西
- 一个 API Key：OpenClaw 需要大模型”大脑”才能理解指令，推荐使用阿里云百炼（新用户有免费额度）或 OpenAI API
- 稳定的网络：安装过程需要下载依赖包
- 耐心：大概 15-30 分钟
🚀 Step 1：安装 Homebrew（Mac 的”应用商店”）
Homebrew 是 Mac 上必备的包管理器，后续很多依赖都要靠它安装。打开终端（Terminal），执行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装完成后，根据终端提示运行接下来的两条命令（把 brew 加入环境变量）。验证安装：brew --version 输出版本号即成功。
🚀 Step 2：安装 Node.js（OpenClaw 的运行环境）
OpenClaw 基于 Node.js 开发，需要 v22.0.0 及以上版本。
# 安装 Node.js 24.x LTS（推荐）
brew install node@24
# 将 node 加入 PATH
echo 'export PATH="/usr/local/opt/node@24/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 验证安装
node --version # 应显示 v24.x.x
npm --version # 应显示 10.x.x可选但推荐：安装 Redis
Redis 用于提升 OpenClaw 的记忆和任务队列能力：
brew install redis
brew services start redis
redis-cli ping # 返回 PONG 即成功🚀 Step 3：安装 OpenClaw（核心步骤）
一键安装脚本（最简单，推荐）
OpenClaw 官方提供了一键安装脚本，会自动处理所有依赖：
curl -fsSL https://openclaw.ai/install.sh | bash安装完成后重新加载终端配置：source ~/.zshrc
验证安装：openclaw --version 应显示 2026.x.x 版本号。
如果一键脚本失败（备用方案：手动安装）
# 全局安装
npm install -g openclaw@latest
# 如果遇到 sharp 模块报错（常见于 M 芯片 Mac）
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest🚀 Step 4：初始化配置（Onboarding 向导）
安装完成后，运行初始化向导：openclaw onboard --install-daemon
交互式配置步骤
- 1. 初始化模式：QuickStart（直接回车）
- 2. 模型提供商：Custom Provider（后续配置 API）
- 3. 认证方式：自动生成 URL，浏览器打开完成授权
- 4. 通讯渠道：Skip for now（暂时跳过）
- 5. 技能初始化：Yes（启用核心技能框架）
- 6. 第三方 API 密钥：No（后续按需配置）
- 7. 启用 Hooks：session-memory（提升对话连续性）
- 8. 孵化方式：Hatch in TUI（终端测试模式）
🚀 Step 5：配置 Gateway 服务
# 配置 Gateway 模式（LAN）
openclaw gateway config --bind lan
# 启动 Gateway 服务
openclaw gateway start
# 配置开机自启（可选）
openclaw gateway enable启动成功后，默认监听 80 端口，可通过 http://localhost/ 访问。
🚀 Step 6：配置大模型 API（给龙虾装上”大脑”）
- 访问阿里云百炼控制台
- 注册/登录账号
- 创建 API Key 并复制保存
- 配置到 OpenClaw：
openclaw config set models.default.provider=aliyun - 设置 API Key：
openclaw config set models.default.apiKey=你的 API_KEY
验证配置：openclaw doctor
🚀 Step 7：访问 Web 控制台
在浏览器中打开 http://localhost/ 即可看到 OpenClaw 的 Web 界面。
控制台功能
- 会话窗口：与 AI 对话的主界面
- 技能管理：查看和安装可用技能
- 设置面板：配置模型、渠道、插件等
- 日志查看：查看运行日志和错误信息
⚠️ 常见问题排查
- 端口被占用：改用其他端口
openclaw gateway config --port 8080 - Node.js 版本不对：
brew upgrade node@24 - 权限错误（EACCES）：
sudo chown -R $(whoami) $(npm prefix -g) - API 调用失败：检查 API Key 是否正确、网络连接、账户余额
✅ 总结
教程结束！现在你的 Mac 上已经成功部署了 OpenClaw。接下来可以安装实用技能（天气、日历、文件管理等）、配置通讯渠道（微信、飞书、Telegram 等）、探索更多自动化场景。
祝你”养虾”愉快！🦞