【在 macOS 上安装 OpenClaw 完整指南】
在 macOS 上安装 OpenClaw 完整指南
让你的 AI 助手通过 WhatsApp、Telegram、Discord、钉钉等聊天工具随时待命
OpenClaw 是一个强大的 AI 智能体 Gateway 网关，它可以将各种聊天应用（WhatsApp、Telegram、Discord、iMessage、钉钉等）连接到你的 AI 智能体。本文将详细介绍如何在 macOS 上安装和配置 OpenClaw，同时提供阿里云 ECS 云服务器部署方案（适合 7×24 小时在线场景）。
两种部署方式对比
| 特性 | macOS 本地部署 | 阿里云 ECS 部署 |
|---|---|---|
| 适用场景 | 个人学习、开发测试 | 企业部署、生产环境 |
| 成本 | 自有设备 | 99 元/年起 |
| 可用性 | 依赖本地网络 | 7×24 小时在线 |
| 部署难度 | 简单 | 中等 |
| 推荐用户 | 个人开发者 | 企业/团队 |
快速选择：
- 🏠个人使用/学习→ 继续阅读本文（macOS 本地部署）
- ☁️企业部署/生产环境→ 查看 阿里云 ECS 部署指南
什么是 OpenClaw？
OpenClaw 🦞 是一个运行在本地或多操作系统的 AI 智能体网关，它的核心功能是：
- 多渠道接入：通过单个 Gateway 进程连接 WhatsApp、Telegram、Discord、iMessage 等
- 多智能体路由：按智能体、工作区或发送者隔离会话
- 媒体支持：发送和接收图片、音频和文档
- Web 控制界面：通过浏览器仪表板管理聊天、配置和会话
- 移动节点支持：配对 iOS 和 Android 节点，支持 Canvas 功能
简单来说，OpenClaw 让你可以通过任何聊天工具与 AI 智能体对话，就像给朋友发消息一样自然。
系统要求
在开始之前，请确保你的 Mac 满足以下要求：
- 操作系统：macOS（具体版本要求取决于 Node.js 22 的兼容性）
- Homebrew：macOS 包管理器（推荐安装）
- Node.js：22 或更新版本（安装脚本会自动检测并安装）
- Git：用于依赖管理（安装脚本会自动安装）
- 磁盘空间：建议至少 2GB 可用空间
安装方法
OpenClaw 提供多种安装方式，推荐使用安装脚本，它会自动处理所有依赖。
前置步骤：安装 Homebrew（推荐）
虽然 OpenClaw 安装脚本会自动处理 Node.js 和 Git 的安装，但在 macOS 上建议先安装 Homebrew，它是 macOS 最流行的包管理器，后续维护更方便。
安装 Homebrew：
/bin/bash-c"$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装完成后，根据提示将 Homebrew 添加到 PATH：
# Apple Silicon (M1/M2/M3) Macecho'eval "$(/opt/homebrew/bin/brew shellenv)"'>>~/.zprofileeval"$(/opt/homebrew/bin/brew shellenv)"# Intel Macecho'eval "$(/usr/local/bin/brew shellenv)"'>>~/.zprofileeval"$(/usr/local/bin/brew shellenv)"验证 Homebrew 安装：
brew--version方法一：使用安装脚本（推荐）
这是最简单、最推荐的安装方式。打开终端（Terminal），运行以下命令：
curl-fsSLhttps://openclaw.ai/install.sh|bash安装脚本会自动完成以下操作：
- 检测并安装 Node.js 22+（如果缺失）
- 检测并安装 Git（如果缺失）
- 通过 npm 全局安装 OpenClaw
- 可选：运行新手引导向导
安装过程示例输出：
🦞 OpenClaw Installer ✓ Detecting OS... macOS detected ✓ Checking Node.js... Node 22.22.0 installed ✓ Checking Git... Git 2.39.0 installed ✓ Installing OpenClaw via npm... ✓ Installation complete! Run 'openclaw onboard --install-daemon' to get started.跳过新手引导
如果你只想安装 CLI 工具，稍后手动配置：
curl-fsSLhttps://openclaw.ai/install.sh|bash-s-- --no-onboard方法二：使用 npm 手动安装
如果你已经安装了 Node.js 22+，并且更喜欢手动控制安装过程：
# 安装 OpenClawnpminstall