Mac本地部署（推荐）

🍎 最佳体验：如果你有Mac电脑，强烈推荐本地部署，体验最好、功能最全！

为什么选择Mac本地部署？

优势：

• ✅ 系统集成：可操作日历、备忘附录、文件系统
• ✅ 隐私安全：数据完全本地，不上传云端
• ✅ 响应速度快：本地运行，无网络延迟
• ✅ 功能最全：支持所有高级功能
• ✅ 成本低：无需购买云服务器
• ✅ 开发布友好：方便调试和自定义

适合人群：

• 有Mac电脑的用户
• 注重隐私的用户
• 需要系统集成功能的用户
• 开发布者和技术爱好者

系统要求

硬件要求：

• CPU：M系列芯片或Intel i5以上
• 内存：8GB以上（推荐16GB）
• 硬盘：10GB以上空闲空间

系统版本：

• macOS 12 Monterey 或更高版本
• 推荐 macOS 14 Sonoma 或 macOS 15 Sequoia

前置软件：

• Node.js 24（推荐）/ 22.16+（兼容路径，会自动安装）
• Homebrew（可选，用于安装依赖）

安装步骤

第一步：打开终端

1. 按 Command + 空格 打开 Spotlight
2. 输入 Terminal 或终端
3. 按回车打开终端

第二步：安装 OpenClaw

在终端中执行以下命令：

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

安装过程会自动：

• 检测系统环境
• 安装Node.js（如果未安装）
• 下载OpenClaw
• 配置环境变量

预计时间：2-5分钟

第三步：验证安装

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

openclaw --version

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

第四步：初始化配置

运行配置向导：

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 跳过：

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. 参考 第9章节：飞书Bot配置
2. 配置完成后，可以在飞书中随时与OpenClaw对话
3. 支持文本、图片、文件等多种消息类型

常见访问题

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

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

Q2：如何更新OpenClaw？

openclaw update

Q3：如何卸载？

openclaw uninstall