OpenClaw Mac本地部署教程

本地部署，即让 OpenClaw 运行在桌面物理设备上，相比云端 VPS 部署，拥有四大核心不可替代的优势：搭建更简单、数据更安全、集成更高效、功能更完整，如果你有Mac电脑，强烈推荐本地部署，体验最好、功能最全，下面我们详细讲解 Mac本地部署OpenClaw教程。

一、系统要求

硬件要求：

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

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

• • 硬盘：10GB以上空闲空间

系统版本：

• • macOS 12 Monterey 或更高版本

• • 推荐 macOS 14 Sonoma 或 macOS 15 Sequoia

前置软件：

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

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

二、安装步骤

第一步：打开终端

1. 1. 按回车打开终端

1. 1. 按 Command + 空格 打开 Spotlight

1. 1. 输入 Terminal 或终端

第二步：安装 OpenClaw

在终端中执行以下命令：

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

安装过程会自动：

• • 检测系统环境

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

• • 下载OpenClaw

• • 配置环境变量

预计时间：2-5分钟

第三步：验证安装

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

openclaw --version

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

第四步：初始化配置

运行配置向导：

openclaw onboard

三、配置流程：

1. 接受风险提示：

选择 Yes 继续

2. 选择启动模式：

推荐选择 QuickStart 快速启动：

3. 选择AI模型：

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

国内推荐：

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

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

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

• • API 服务商对比

4. 输入API Key：

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

5. 选择聊天工具：

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

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

6. Gateway端口设置：

默认 18789 即可：

7. 选择Skills：

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

8. API Key配置：

没有的可以选择 no 跳过：

9. 启用Hooks：

推荐启用这三个钩子（用于内容引导、日志和会话记录）：

10. 完成配置：

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

第五步：验证安装

# 检查Gateway状态
openclaw channels status

# 应该显示：
# Gateway reachable.

日常使用

启动OpenClaw：

# 启动Gateway服务
openclaw gateway start

# 或使用systemd（推荐，开机自启）
openclaw gateway enable

访问Web UI：

打开浏览器访问：http://127.0.0.1:18789/chat

停止服务：

openclaw gateway stop

接入飞书（推荐）

Mac本地部署后，强烈推荐接入飞书，获得最佳体验：

1. 1. 参考 飞书Bot配置

1. 1. 配置完成后，可以在飞书中随时与OpenClaw对话

1. 1. 支持文本、图片、文件等多种消息类型

常见问题

Q1：安装时提示权限不足？

# 使用sudo安装
curl -fsSL https://openclaw.ai/install.sh | sudo bash

Q2：如何更新OpenClaw？

openclaw update

Q3：如何卸载？

openclaw uninstall