OpenClaw Mac 部署｜中文详细步骤 + 避坑(mac编译opencv)

在AI智能体飞速普及的当下，普通AI聊天工具仅能实现对话交互，而OpenClaw作为开源、可本地化部署的AI执行框架，彻底打破了“只聊不做”的局限，能真正帮用户完成文件处理、浏览器自动化、任务调度、多平台联动等实操任务，实现从“对话AI”到“执行AI”的跨越。

本教程由中研赢创倾力打造，立足2026最新稳定版OpenClaw，覆盖零基础入门、环境搭建、核心配置、技能拓展、实战落地、故障排查全流程，摒弃晦涩术语，用通俗语言+实操步骤+避坑指南，助力每一位学习者快速吃透OpenClaw打造专属AI执行助手，不管是个人效率提升，还是轻量办公自动化，都能轻松落地。

一、为什么选择Mac本地部署？

1、优势

系统集成：可操作日历、备忘录、文件系统

隐私安全：数据完全本地，不上传云端

响应速度快：本地运行，无网络延迟

功能最全：支持所有高级功能

成本低：无需购买云服务器

开发友好：方便调试和自定义

2、适合人群

有Mac电脑的用户

注重隐私的用户

需要系统集成功能的用户

开发者和技术爱好者

二、系统要求

硬件要求：

CPU：M系列芯片或Intel i5以上

内存：8GB以上（推荐16GB）

硬盘：10GB以上空闲空间

系统版本：

macOS 12 Monterey 或更高版本

推荐 macOS 14 Sonoma 或 macOS 15 Sequoia

前置软件：

Node.js 22.0.0+（会自动安装）

Homebrew（可选，用于安装依赖）

三、安装步骤

第一步：打开终端

1. 按 Command + 空格 打开 Spotlight

2. 输入 Terminal 或 终端

3. 按回车打开终端

第二步：安装 OpenClaw

在终端中执行以下命令：

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

安装过程会自动：

检测系统环境

安装Node.js（如果未安装）

下载OpenClaw

配置环境变量

预计时间：2-5分钟

第三步：验证安装

安装完成后，执行以下命令验证：

openclaw --version

如果显示版本号（如 2026.2.9 ），说明安装成功！

第四步：初始化配置

运行配置向导：

openclaw onboard

配置流程：

1. 接受风险提示：

选择 Yes 继续

2. 选择启动模式：

推荐选择 QuickStart 快速启动：

3. 选择AI模型：

选择你的AI供应商（支持国内外主流模型）

国内推荐：

Kimi（Moonshot AI）：长文本专家，200万字上下文

DeepSeek：性价比之王，推理能力强

智谱GLM：中文理解好，多模态支持

4. 输入API Key：

根据选择的模型，输入对应的API Key（参见API配置指南）

5. 选择聊天工具：

如果要接入飞书/Telegram，选择对应选项

如果暂时不接入，选择 None （后续可配置）

6. Gateway端口设置：

默认 18789 即可：

7. 选择Skills：

使用空格键选择你需要的技能，也可以直接跳过：

8. API Key配置：

没有的可以选择 no 跳过：

10. 完成配置：

配置完成后，会自动启动Gateway服务并打开Web UI（ http://127.0.0.1:18789/chat ）

第五步：验证安装

# 检查Gateway状态

openclaw channels status

# 应该显示：

# Gateway reachable.