首页 / OpenClaw 教程 / Mac本地部署

OpenClaw Mac 本地部署教程

Mac 本地部署完整教程，原生支持最完善，可操作日历、备忘录、截图等系统功能

💻 一、系统要求

硬件要求

🖥️ 最低配置
  • CPU：Apple Silicon M 系列 或 Intel Core i5 及以上
  • 内存：8GB 以上（推荐 16GB）
  • 硬盘：10GB 以上可用空间
  • 网络：稳定的互联网连接
🚀 推荐配置
  • CPU：Apple Silicon M1 Pro/Max/Ultra 或更高
  • 内存：16GB 或 32GB
  • 硬盘：SSD，50GB 以上可用空间

系统版本

📋 支持的操作系统
  • macOS 12 Monterey 或更高版本
  • 推荐 macOS 14 Sonoma 或 macOS 15 Sequoia
  • 同时支持 Intel 和 Apple Silicon 芯片

前置软件

软件 最低版本 用途 检查命令
Node.js 22.0.0+ 运行环境 node --version
npm 10.0.0+ 包管理器 npm --version
Homebrew 最新版 软件安装（可选） brew --version

安装 Node.js

bash 
# 使用 Homebrew 安装
brew install node@22

# 或使用官方安装包
# 下载地址：https://nodejs.org/zh-cn/download/

📦 二、安装步骤

第一步：打开终端

在 Mac 上打开终端（Terminal）应用：

  • 按 Cmd + Space 打开 Spotlight
  • 输入 "Terminal" 并回车
  • 或使用 Launchpad 找到终端应用

第二步：安装 OpenClaw

在终端中执行以下 curl 命令安装 OpenClaw：

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

安装脚本会自动：

  • 下载最新版本的 OpenClaw
  • 安装到系统目录
  • 配置环境变量

第三步：验证安装

安装完成后，验证 OpenClaw 是否正确安装：

bash 
# 检查版本
openclaw --version

# 预期输出：
# OpenClaw CLI v1.2.3

第四步：初始化配置

运行初始化命令，配置你的 OpenClaw：

bash 
openclaw onboard

配置流程详解

1. 接受风险提示

交互 
OpenClaw 将能够访问您的系统，执行命令和操作文件。
请确认您了解相关风险。

是否继续？(y/N): y

2. 选择启动模式

交互 
请选择启动模式：
1. 交互模式 (推荐新手)
2. 服务端模式
3. 守护进程模式

请选择 (1-3): 1

3. 选择 AI 模型

交互 
请选择 AI 模型提供商：
1. OpenAI (GPT-4/GPT-3.5)
2. Anthropic (Claude)
3. Google (Gemini)
4. Moonshot (Kimi)
5. DeepSeek
6. 自定义 API

请选择 (1-6): 2

4. 输入 API Key

交互 
请输入 Anthropic API Key:
(从 https://console.anthropic.com/ 获取)

API Key: sk-ant-api03-xxxxxxxx

5. 选择聊天工具

交互 
请选择要启用的聊天平台：
✓ iMessage (Mac 原生支持)
[ ] WhatsApp
[ ] Telegram
[ ] Discord
[ ] 飞书
[ ] 钉钉

使用空格选择，回车确认

6. Gateway 端口设置

交互 
设置 Gateway 端口 (默认 3000):
Port [3000]: 

Web UI 将运行在 http://localhost:3000

7. 选择 Skills

交互 
推荐安装的 Skills：
✓ file-search (文件搜索)
✓ calendar (日历管理)
✓ screenshot (截图工具)
✓ reminder (提醒事项)

是否安装推荐 Skills? (Y/n): Y

8. 启用 Hooks

交互 
启用系统 Hooks？
这允许 OpenClaw 操作日历、备忘录等系统应用。

启用 Hooks? (Y/n): Y

✅ 配置完成！

第五步：验证安装

检查各组件状态：

bash 
# 检查所有 channels 状态
openclaw channels status

# 预期输出：
# Channel          Status    
# ---------------- ----------
# iMessage         ✅ online
# gateway          ✅ online
# web-ui           ✅ online

🚀 三、日常使用

启动 OpenClaw

bash 
# 前台启动（可看到日志）
openclaw start

# 后台启动
openclaw start --daemon

# 指定配置启动
openclaw start --config ~/.openclaw/config.prod.yml

访问 Web UI

🌐 Web 界面

启动后，在浏览器中访问：

http://localhost:3000

你可以在 Web UI 中：

  • 查看所有连接的平台
  • 管理已安装的 Skills
  • 查看对话历史
  • 配置系统设置

停止服务

bash 
# 停止服务
openclaw stop

# 强制停止
openclaw stop --force

# 重启服务
openclaw restart

📱 四、接入飞书（推荐）

飞书是国内团队协作的首选，OpenClaw 对飞书有完善的支持。

创建飞书应用

  1. 访问 飞书开放平台
  2. 点击「创建企业自建应用」
  3. 填写应用名称和描述
  4. 记录 App ID 和 App Secret

配置权限

在飞书后台添加以下权限：

  • im:chat:readonly（读取群组信息）
  • im:message:send（发送消息）
  • im:message.group_msg（接收群消息）
  • im:message.p2p_msg（接收单聊消息）

配置 OpenClaw

bash 
# 启用飞书
openclaw config set channels.feishu.enabled true

# 设置 App ID
openclaw config set channels.feishu.app_id "cli_xxxxxxxxxx"

# 设置 App Secret
openclaw config set channels.feishu.app_secret "xxxxxxxxxx"

# 重启服务
openclaw restart

验证接入

在飞书中 @你的机器人，测试是否能正常回复。

💡 飞书优势
  • 国内访问速度快，无需代理
  • 支持富文本、卡片消息
  • 完善的群组管理功能
  • 移动端体验优秀

❓ 五、常见问题

安装时权限不足

问题：安装脚本提示 Permission denied

解决：

bash 
# 方法1：使用 sudo
sudo curl -fsSL https://openclaw.ai/install.sh | bash

# 方法2：更改安装目录
export OPENCLAW_INSTALL_DIR="$HOME/.local"
curl -fsSL https://openclaw.ai/install.sh | bash

如何更新

bash 
# 检查更新
openclaw update check

# 执行更新
openclaw update

# 或重新运行安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash

如何卸载

bash 
# 完全卸载 OpenClaw
openclaw uninstall

# 手动清理（如果自动卸载失败）
rm -rf ~/.openclaw
rm /usr/local/bin/openclaw

其他常见问题

问题 可能原因 解决方案
Node.js 版本过低 系统 Node 版本 < 22 使用 nvm 安装 Node 22
端口被占用 3000 端口被其他程序使用 更换端口或关闭占用程序
iMessage 无法连接 权限未开启 系统设置中开启自动化权限
API 调用失败 API Key 无效或额度不足 检查 API Key 和账户余额
Skills 无法加载 依赖缺失 运行 openclaw doctor 检查
🔧 诊断工具

使用诊断命令检查系统状态：

bash 
# 运行诊断
openclaw doctor

# 查看详细日志
openclaw logs --tail 100

# 重置配置
openclaw config reset

获取帮助

如果遇到其他问题，可以通过以下渠道获取帮助：