
---
title: Mac本地部署OpenClaw全流程：从零到一，每条指令都可直接复制
keywords: OpenClaw,Mac本地部署,AI智能体,Node.js,终端教程,AI助手安装,OpenClaw教程,Mac AI
tags: OpenClaw,Mac部署,AI教程,终端命令,开发者工具,本地AI
description: 2026年最新版Mac本地部署OpenClaw保姆级教程，每一条指令都可直接复制粘贴，每个步骤都附带了可能遇到的问题及解决方案，从零到一跑通专属AI智能体。
---

# 🦞 Mac本地部署OpenClaw全流程：从零到一，每条指令都可直接复制

> 2026年，OpenClaw已成为最受欢迎的个人AI智能体框架，GitHub星标突破30万。本文手把手带你从零开始在Mac上完成OpenClaw本地部署，每一条指令都经过实测验证，每个步骤都附带了可能遇到的问题及解决方案——你只需要打开终端，复制粘贴即可。


## 📌 写在前面：为什么选择Mac本地部署？

Mac（尤其是搭载Apple Silicon芯片的机型）与OpenClaw的适配性远超其他设备，核心优势体现在三大维度：

- **低功耗长效运行**：Mac mini idle状态功耗仅5-10W，远低于Windows主机，可常年开机运行，适合部署定时任务。
- **原生兼容性拉满**：OpenClaw 2026版本已深度适配macOS（12.0+），完美兼容Apple Silicon（M1/M2/M3/M4）与Intel芯片，部署过程比Windows更简洁，不易出现驱动冲突、权限不足等问题。
- **隐私与性能兼顾**：本地部署时所有数据存储在Mac本地，避免云端数据泄露，适合处理敏感信息。

> ⚠️ **安全提醒**：OpenClaw需要获取权限来操作你的电脑。如果你电脑中的数据文件比较重要，建议为OpenClaw创建一个独立的低权限账户运行，或考虑云端部署方案。本文虽为本地部署教程，但文中所有指令均严格遵循最小权限原则。


## 🦞 第一阶段：安装前准备（约5分钟）

### 1.1 确认系统要求

在开始之前，请确认你的Mac满足以下要求：

| 配置项 | 最低要求 | 推荐配置 | 说明 |
| :--- | :--- | :--- | :--- |
| **操作系统** | macOS 12.0 (Monterey) | macOS 14.0 (Sonoma) 或更高 | 已更新至最新系统补丁 |
| **处理器** | Intel Core i5 (2015+) | Apple M1/M2/M3/M4芯片 | Apple芯片性能优势显著 |
| **内存** | 8GB RAM | 16GB+ RAM | 多任务并发时内存需求较大 |
| **存储** | 10GB可用空间 | 20GB+ SSD | SSD显著提升I/O性能 |
| **网络** | 稳定互联网连接 | 高速宽带 | 需联网下载依赖 |



### 1.2 打开终端

```bash
# 按 Command + 空格键 → 输入「终端」→ 回车打开
```

### 1.3 安装Xcode Command Line Tools（如未安装）

```bash
xcode-select --install
```

**👉 可能出现的问题：**

| 问题 | 解决方法 |
| :--- | :--- |
| 弹窗提示“无法安装该软件，因为当前无法从软件更新服务器获得” | 前往[Apple Developer官网](https://developer.apple.com/download/all/)手动下载对应版本的Command Line Tools |
| 安装完成后验证失败 | 重新运行一次`xcode-select --install`，系统会提示已安装 |


## 🦞 第二阶段：安装核心依赖（约3分钟）

### 2.1 安装Homebrew（Mac包管理器）

**👉 复制粘贴以下整条命令，回车执行：**

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

> ⚠️ **安装过程中需要注意：**
> - 需要输入Mac开机密码（输入时屏幕不显示字符，是正常现象）
> - 安装时间约3-5分钟，请耐心等待
> - 如果网络较慢，可以使用国内镜像源

**M系列芯片（Apple Silicon）用户，安装完成后需要配置PATH：**

```bash
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc
```

**验证Homebrew安装成功：**

```bash
brew --version
```

如果输出版本号（如 Homebrew 4.x.x），说明安装成功。

**👉 可能出现的问题：**

| 问题 | 解决方法 |
| :--- | :--- |
| curl: (7) Failed to connect | 检查网络连接，或使用国内镜像：`/bin/bash -c "$(curl -fsSL https://mirrors.ustc.edu.cn/brew/install.sh)"` |
| Permission denied | 命令前加`sudo`重试：`sudo /bin/bash -c ...` |
| 安装后brew命令找不到 | 检查PATH配置，M芯片用户确认已执行上述echo配置命令 |

### 2.2 安装Node.js（核心运行环境）

> ⚠️ **重要提示**：OpenClaw要求Node.js版本 ≥ 22。虽然一键安装脚本会自动安装，但提前安装可以避免后续网络问题导致的中断。

**方法一：通过Homebrew安装（推荐）**

```bash
brew install node@22
```

安装完成后，链接到系统PATH：

```bash
brew link node@22 --force --overwrite
```

**方法二：手动下载官方安装包（网络慢时使用）**

Intel芯片Mac用户：
```bash
curl -fsSL https://nodejs.org/dist/v22.16.0/node-v22.16.0.pkg -o node.pkg
sudo installer -pkg node.pkg -target /
```

M系列芯片Mac用户：
```bash
curl -fsSL https://nodejs.org/dist/v22.16.0/node-v22.16.0-arm64.pkg -o node.pkg
sudo installer -pkg node.pkg -target /
```

**验证Node.js安装成功：**

```bash
node --version
npm --version
```

预期输出：node版本应为v22.x.x及以上，npm版本应为v10.x.x及以上。

**👉 可能出现的问题：**

| 问题 | 解决方法 |
| :--- | :--- |
| brew安装时提示“No available formula” | 先运行`brew update`更新Homebrew |
| 版本低于22 | 运行`brew upgrade node@22`更新，或手动下载官方最新版安装包 |
| 安装后node命令找不到 | 重启终端，或手动添加PATH：`export PATH="/usr/local/bin:$PATH"` |
| 权限错误（Permission denied） | 命令前加`sudo`重试 |


## 🦞 第三阶段：一键安装OpenClaw（约5分钟）

### 3.1 执行一键安装脚本

> ⚠️ **选择适合你的命令（二选一）：**

**官方原版（推荐，全球通用）：**

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

**国内加速版（网络慢时使用）：**

```bash
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
```

> ⚠️ **安装过程中需要注意：**
> - 执行时可能需要输入Mac开机密码（输入不显示，直接回车即可）
> - 脚本会自动检测并安装Node.js（如果尚未安装）
> - 整个过程约3-5分钟，请耐心等待

**👉 可能出现的问题：**

| 问题 | 解决方法 |
| :--- | :--- |
| curl: (7) Failed to connect | 网络问题，尝试国内加速版命令 |
| 脚本执行中断 | 检查网络稳定性，重新执行命令 |
| 提示“command not found: curl” | 先安装curl：`brew install curl` |

### 3.2 加载环境变量（必做！）

安装完成后，必须加载环境变量，否则终端无法识别`openclaw`命令。

```bash
source ~/.zshrc
```

如果你使用的是Bash（老系统）：

```bash
source ~/.bash_profile
```

### 3.3 验证安装成功

```bash
openclaw --version
```

输出版本号（如 2026.x.x）即安装成功。

**👉 可能出现的问题：**

| 问题 | 解决方法 |
| :--- | :--- |
| zsh: command not found: openclaw | 环境变量未加载，重新执行`source ~/.zshrc`；如果仍然报错，执行以下命令修复PATH：`export PATH="$(npm prefix -g)/bin:$PATH"`，然后重新验证 |
| npm ERR! sharp安装错误 | sharp是图像处理库，国内网络可能导致下载失败，重新执行安装脚本，网络高峰期可尝试清晨重试 |


## 🦞 第四阶段：配置向导（约10分钟）

### 4.1 启动入门向导

```bash
openclaw onboard
```

入门向导会引导你完成网关、频道、技能和工作区的配置。

**向导配置步骤（按键盘方向键选择，回车确认）：**

| 步骤 | 选项 | 操作 |
| :--- | :--- | :--- |
| **第1步：风险确认** | Yes | 选择`Yes`并回车，表示知道AI操作电脑的风险 |
| **第2步：安装模式** | QuickStart | 选择`QuickStart`快速开始模式 |
| **第3步：模型配置** | Skip for now | 先跳过，稍后配置（或按需选择Kimi/OpenAI等） |
| **第4步：频道配置** | Skip for now | 先跳过，稍后通过Dashboard配置 |
| **第5步：技能配置** | No | 先跳过，稍后通过ClawHub安装 |



> 💡 **提示**：所有配置都可以后续修改，不用担心选错。完成后系统会自动生成网关认证Token。

### 4.2 配置大模型API Key（以Kimi为例）

模型配置有两种方式，选其一即可。

**方式一：通过向导重新配置**

```bash
openclaw configure --section models
```

**方式二：通过Web Dashboard配置**

```bash
openclaw dashboard
```

然后在浏览器访问 `http://127.0.0.1:18789/`，在Web界面中填写API Key。

**获取Kimi API Key的步骤：**

1. 访问 https://platform.moonshot.cn/console
2. 登录账号
3. 点击左侧菜单「API Key管理」
4. 点击「创建API Key」，复制生成的密钥

将复制的API Key粘贴到配置中，选择模型`Moonshot / Kimi-K2.5`并确认。

> 💡 **替代方案：接入腾讯云混元API**

OpenClaw也支持腾讯云混元大模型，兼容OpenAI SDK接口。获取方式：登录[腾讯云大模型API](https://hunyuan.cloud.tencent.cn/) → 创建API Key → 按OpenAI兼容格式配置到OpenClaw中。

### 4.3 启动Gateway网关服务

```bash
openclaw gateway start
```

**成功标志：**
- 看到 `RPC probe: ok`
- 看到 `Listening: 127.0.0.1:18789`

> ⚠️ **关键提醒**：如果Gateway无法启动，通常是因为**网关模式未配置**。OpenClaw出于安全考虑，不会自动选择运行模式——你必须手动配置`gateway.mode`。如遇到此问题，运行`openclaw configure`，在网关配置项中选择`Local (this machine)`即可修复。

**👉 可能出现的问题：**

| 问题 | 解决方法 |
| :--- | :--- |
| Error: listen EADDRINUSE: address already in use :::18789 | 端口被占用，先运行`lsof -i :18789`查看占用进程，然后用`kill -9 <PID>`杀掉进程 |
| Gateway start blocked: set gateway.mode=local | 网关模式未设置，运行`openclaw configure`，在网关配置中选择`Local (this machine)` |
| 没有任何输出，进程直接退出 | 可能是@matrix-org/matrix-sdk-crypto-nodejs二进制文件下载不完整，重装OpenClaw：`npm uninstall -g openclaw && npm install -g openclaw` |
| 提示node版本不兼容 | 确认Node.js版本≥22，运行`node --version`检查 |


## 🦞 第五阶段：启动Web仪表盘与体验（约3分钟）

### 5.1 启动Web仪表盘

```bash
openclaw dashboard
```

然后在浏览器中访问：`http://127.0.0.1:18789/`

> ⚠️ **注意**：首次访问需要输入Gateway Token（配置向导中生成的认证令牌）。如果忘记Token，可以运行`openclaw config get gateway.auth.token`查看。

### 5.2 使用TUI终端聊天（无需配置频道）

如果想快速体验，可以直接在终端中进入TUI聊天模式：

```bash
openclaw tui
```

在TUI界面中，你可以直接输入问题，AI会基于你配置的模型进行回复。

**退出TUI：** 连续按两次 `Ctrl + C`

### 5.3 安装第一个技能（可选）

通过ClawHub安装基础搜索技能：

```bash
# 安装ClawHub CLI
npm i -g clawhub

# 搜索技能
clawhub search web-search

# 安装搜索技能
clawhub install desearch-web-search --force
```


## 🦞 第六阶段：常用管理命令

| 命令 | 说明 |
| :--- | :--- |
| `openclaw status` | 查看OpenClaw整体状态 |
| `openclaw gateway status` | 查看Gateway服务状态 |
| `openclaw gateway restart` | 重启Gateway服务 |
| `openclaw gateway stop` | 停止Gateway服务 |
| `openclaw tui` | 进入终端聊天模式 |
| `openclaw doctor` | 诊断系统问题（遇到问题第一时间运行） |
| `openclaw logs --follow` | 实时查看日志 |
| `openclaw config set <key> <value>` | 设置配置项 |
| `openclaw config get <key>` | 获取配置项 |
| `openclaw dashboard` | 打开Web仪表盘 |




## 🦞 第七阶段：进阶配置——安装Docker沙箱（安全必备）

> ⚠️ **安全提醒**：OpenClaw拥有操作你电脑的权限，强烈建议开启Docker沙箱隔离高风险操作。

### 7.1 安装Docker Desktop

1. 访问 https://www.docker.com/products/docker-desktop/
2. 下载适用于macOS的Docker Desktop安装包
3. 双击安装，将Docker图标拖入Applications文件夹
4. 启动Docker Desktop（首次启动需要授权）

### 7.2 验证Docker安装

```bash
docker --version
```

### 7.3 在OpenClaw配置中启用沙箱

编辑OpenClaw配置文件：

```bash
openclaw config set use_docker true
```

或在 `~/.openclaw/openclaw.json` 中确认以下配置：

```json
{
  "use_docker": true
}
```


## 🛠️ 常见问题速查表

| 问题现象 | 诊断命令 | 解决方法 |
| :--- | :--- | :--- |
| openclaw命令找不到 | `npm prefix -g` | `export PATH="$(npm prefix -g)/bin:$PATH"` |
| Node.js版本过低 | `node --version` | `brew upgrade node@22` |
| 端口18789被占用 | `lsof -i :18789` | `kill -9 <PID>` |
| Gateway无法启动 | `openclaw doctor` | 自动修复或按提示操作 |
| API调用失败 | `openclaw logs --follow` | 检查API Key是否正确 |
| 技能安装失败 | `clawhub list` | 检查网络，重新安装 |




## 💎 总结

你已经完成了OpenClaw在Mac上的完整部署！回顾一下整个流程：

1. **安装前准备**：确认系统版本，打开终端，安装Xcode Command Line Tools
2. **安装核心依赖**：Homebrew + Node.js
3. **一键安装OpenClaw**：执行安装脚本，加载环境变量
4. **配置向导**：设置网关、配置大模型API Key
5. **启动服务**：启动Gateway，打开Web仪表盘或TUI体验
6. **进阶配置**：安装Docker沙箱，提升安全性

**建议路线图**：
- **第1天**：完成安装部署，成功启动Gateway
- **第2天**：配置API Key，通过TUI测试对话
- **第3天**：安装Docker沙箱，安装基础技能
- **第4天起**：按需安装Skills，探索自动化任务


**相关链接**：
- OpenClaw官网：https://openclaw.ai
- ClawHub技能市场：https://clawhub.ai
- 腾讯云混元API：https://hunyuan.cloud.tencent.cn
- Docker Desktop下载：https://www.docker.com/products/docker-desktop/

*本文基于截至2026年4月的公开信息整理。OpenClaw仍在快速迭代，建议使用时查阅最新官方文档。*
```

2026年，OpenClaw已成为最受欢迎的个人AI智能体框架，GitHub星标突破30万。本文手把手带你从零开始在Mac上完成OpenClaw本地部署，每一条指令都经过实测验证，每个步骤都附带了可能遇到的问题及解决方案——你只需要打开终端，复制粘贴即可。

Mac本地部署OpenClaw全流程：从零到一，每条指令都可直接复制

人工智能

开发工具

客户端

2026年最新OpenClaw本地部署教程，详解Mac电脑一键安装流程。适配Apple Silicon芯片，支持M1/M2/M3/M4机型，提供完整命令行指令和常见问题解决方案。包含Homebrew安装、Node.js配置、Docker沙箱设置等关键步骤，5分钟快速部署AI智能体框架。

数据存储

图像处理

数据泄露

包管理器

服务器

智能体

Windows

Docker

GitHub

2026采购季 | AI焕新·智启新局

4核4G3M云服务器 新用户低至38元/年！

对象存储COS新用户低至1元！


imageprocess

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Mac本地部署OpenClaw全流程：从零到一，每条指令都可直接复制-腾讯云开发者社区-腾讯云

Mac本地部署OpenClaw全流程：从零到一，每条指令都可直接复制

Mac本地部署OpenClaw全流程：从零到一，每条指令都可直接复制

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐