OpenClaw安装部署Mac操作系统版 - 打造你的专属AI助理

【第二篇】OpenClaw安装部署Mac操作系统版 - 打造你的专属AI助理

摘要：Mac系统是OpenClaw的最佳部署平台之一。本文详细介绍在macOS上安装部署OpenClaw的完整流程，包括环境准备、多种安装方式、权限配置等内容，让Mac用户轻松搭建AI智能体平台。

前言：为什么Mac是最佳选择？

Mac系统在OpenClaw部署上有天然优势：

优势一：完美的Unix环境

macOS基于Unix，兼容性极佳
命令行工具丰富
与Linux生态高度兼容

优势二：原生AppleScript支持

可直接控制iMessage、Notes等系统应用
深度集成macOS原生功能
支持屏幕录制、系统录音等权限

优势三：优秀的桌面环境

图形界面友好
文件权限管理清晰
开发者工具完善

适用场景：

喜欢在Mac上工作的开发者
需要使用iMessage集成的用户
希望深度定制AI助理的个人用户

一、部署前的准备工作

1.1 系统要求检查

最低配置要求：

macOS 10.15 (Catalina) 或更高版本
Intel芯片或Apple Silicon (M1/M2/M3)
内存：4GB以上（推荐8GB+）
磁盘空间：至少2GB可用空间
网络：稳定的互联网连接

运行时要求：

Node.js 22或更高版本（强制要求）
Xcode Command Line Tools
npm或pnpm包管理器

1.2 检查系统版本

打开"终端"应用，输入：

bash 复制代码

sw_vers

期望输出示例：

复制代码

ProductName:    macOS
ProductVersion: 15.2
BuildVersion:   24C101

确认版本 >= 10.15。

1.3 检查Node.js版本

bash 复制代码

node --version

期望输出： v22.x.x

如果版本不符合要求：

低于22：需要升级
提示"command not found"：需要安装

1.4 安装Xcode Command Line Tools

即使不开发，OpenClaw也需要这些工具：

bash 复制代码

xcode-select --install

系统会弹出安装窗口，点击"安装"按钮，等待完成。

验证安装：

bash 复制代码

xcode-select -p

期望输出路径，例如：/Library/Developer/CommandLineTools

二、Node.js环境配置

2.1 安装Node.js

方法一：使用Homebrew（推荐）

如果你已经安装了Homebrew：

bash 复制代码

# 安装Node.js
brew install node

# 如果已安装但版本低，升级
brew upgrade node

方法二：官网安装包下载

访问 https://nodejs.org
下载LTS版本（长期支持版）
双击.pkg安装包
按向导完成安装

方法三：使用nvm（推荐给开发者）

bash 复制代码

# 安装nvm（如果未安装）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重新加载shell配置
source ~/.zshrc  # 或 ~/.bash_profile

# 安装Node.js 22
nvm install 22

# 设置为默认版本
nvm use 22
nvm alias default 22

2.2 验证Node.js安装

bash 复制代码

node --version
npm --version

两个命令都应该返回版本号。

常见问题：命令找不到

如果提示"command not found"，可能需要：

重启终端：打开新的终端窗口
检查PATH：
bash 复制代码
```
echo $PATH
```
确认npm全局路径在PATH中（通常是 /usr/local/bin 或 /opt/homebrew/bin）

手动添加PATH（如果需要）：

bash 复制代码

# Intel Mac
export PATH="/usr/local/bin:$PATH"

# Apple Silicon Mac
export PATH="/opt/homebrew/bin:$PATH"

三、OpenClaw安装方式

OpenClaw提供了多种安装方式，选择最适合你的即可。

3.1 方法一：一键安装脚本（推荐）

这是最简单快速的方式：

bash 复制代码

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

脚本会自动完成：

检测系统环境
安装Node.js（如果缺失）
安装OpenClaw全局包
配置初始设置

安装时间： 通常30秒到2分钟

3.2 方法二：npm全局安装

如果你已经配置好Node.js环境：

bash 复制代码

npm install -g openclaw@latest

验证安装：

bash 复制代码

openclaw --version

期望看到版本号，例如：2026.3.7

3.3 方法三：Git源码安装（开发者）

适合需要自定义修改的开发者：

bash 复制代码

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖
pnpm install

# 构建
pnpm build

# 链接到全局
pnpm link

3.4 验证安装成功

无论使用哪种方法，最后都要验证：

bash 复制代码

# 查看版本
openclaw --version

# 运行诊断
openclaw doctor

如果 openclaw doctor 没有报错，说明安装成功！

四、初始化配置

4.1 运行初始化向导

bash 复制代码

openclaw onboard --install-daemon

这个命令会启动交互式向导，引导你完成配置。

4.2 向导步骤详解

步骤1：风险确认

复制代码

? I understand this is powerful and inherently risky. Continue? (Y/n)

输入 Y 继续。OpenClaw是一个强大的工具，需要谨慎使用。

步骤2：选择模式

复制代码

? Onboarding mode:
❯ QuickStart - Minimal setup, get running fast
  Manual - Full control over all settings

QuickStart：推荐新手，自动配置推荐设置
Manual：适合有经验的用户，完全自定义配置

建议： 第一次选择QuickStart，后续可以随时修改配置。

步骤3：选择模型提供商

复制代码

? Which model provider would you like to use?
❯ KIMI
  MiniMax
  GLM
  OpenAI
  Anthropic
  Other (custom endpoint)

国内用户推荐：

KIMI：性价比高，中文理解好
MiniMax：多模型支持
GLM：智谱AI出品

国际用户推荐：

Anthropic：Claude系列，质量顶尖
OpenAI：GPT系列，功能全面

步骤4：选择鉴权方式

选择模型后，会提示鉴权方式：

复制代码

? KIMI auth method:
❯ Coding Plan / OAuth
  API Key

国内用户建议： 选择 "Coding Plan" 对应项

步骤5：输入API Key

复制代码

? Enter your KIMI API Key: [在此处粘贴你的Key]

注意： 终端不会显示任何字符（出于安全考虑），直接粘贴后按回车即可。

步骤6：选择模型

复制代码

? Select model:
❯ kimi-k2.5
  kimi-k2.5-lite
  kimi-k2.5-pro

选择你订阅的模型版本。

步骤7：配置Channel（建议先Skip）

复制代码

? Select channel (QuickStart):
❯ Skip for now (You can add channels later via `openclaw channels add`)
  WhatsApp
  Telegram
  ...

建议： 首次选择 "Skip for now"，先确保基础环境正常，再添加消息渠道。

步骤8：配置Skills

复制代码

? Configure skills now? (recommended)
❯ Yes
  No

建议： 选择 Yes，现在就把能装的依赖装掉，减少后续问题。

步骤9：配置Hooks

复制代码

? Enable hooks?
❯ Skip for now
  <hook列表>

建议： 首次选择 "Skip for now"，先跑通主线。

步骤10：选择Hatch方式

复制代码

? How do you want to hatch your bot?
❯ Hatch in TUI (recommended)
  Open Web UI
  Do this later

建议： 选择 "Hatch in TUI"，在终端中直接对话。

4.3 初始化完成

向导完成后，你会看到类似输出：

复制代码

✓ Configuration complete
✓ Gateway is running
✓ You can now start using OpenClaw!

Dashboard URL: http://127.0.0.1:18789/
Gateway Status: Running

五、首次对话测试

5.1 完成Bootstrap

向导完成后，建议先完成Bootstrap（初始化对话），告诉AI你的基本信息。

示例对话：

复制代码

你好！我是你的主人。

关于我：
- 称呼：China龙
- 地点：中国北京（UTC+8）
- 语言：中文
- 职业：自由职业者

我希望你扮演：
- 角色：全能助理
- 职责：帮助我管理文档、搜索资料、整理任务

我的工作环境：
- 工作目录：~/Documents/projects
- 常用工具：VS Code、Notion
- 沟通方式：通过Terminal对话

我的偏好：
- 回答风格：先给结论，再展开细节
- 回答长度：中等，不要太简短也不要太冗长
- 执行操作前：必须向我确认（特别是删除、修改文件）

安全边界：
- 绝不主动执行删除操作
- 未经允许不发送网络请求
- 不访问我的私人照片、视频等文件

5.2 发送测试消息

测试1：简单任务

复制代码

请给我一个"今天就能执行"的3条待办清单，每条不超过50字，并按优先级排序。

测试2：信息查询

复制代码

请告诉我北京今天的天气，并给出穿衣建议。

测试3：文件操作

复制代码

请查看当前目录有哪些文件，并总结文件类型。

如果AI能正常回复并执行任务，恭喜你！配置成功！

六、安装守护进程

6.1 什么是守护进程？

守护进程（Daemon）让OpenClaw在后台持续运行，即使关闭终端也不会中断。

优点：

开机自启
后台运行，不占用终端
崩溃自动重启

6.2 macOS上的守护进程

macOS使用 launchd 管理守护进程。

如果你在初始化向导中使用了 --install-daemon 参数，守护进程已经自动安装。

检查守护进程状态：

bash 复制代码

openclaw gateway status

手动启动/停止守护进程：

bash 复制代码

# 启动
openclaw gateway start

# 停止
openclaw gateway stop

# 重启
openclaw gateway restart

6.3 查看守护进程日志

bash 复制代码

tail -f ~/.openclaw/logs/gateway.log

或使用OpenClaw命令：

bash 复制代码

openclaw logs --follow

6.4 开机自启配置

macOS的守护进程默认会开机自启。

检查是否启用：

bash 复制代码

launchctl list | grep openclaw

如果看到输出，说明已启用。

手动禁用/启用：

bash 复制代码

# 禁用
launchctl unload ~/Library/LaunchAgents/com.openclaw.gateway.plist

# 启用
launchctl load ~/Library/LaunchAgents/com.openclaw.gateway.plist

七、配置Web UI

7.1 什么是Web UI？

Web UI是OpenClaw的图形化控制界面，可以在浏览器中使用。

优势：

图形化界面，更友好
支持文件拖拽
可视化管理配置

7.2 打开Web UI

方法一：命令行

bash 复制代码

openclaw dashboard

浏览器会自动打开 http://127.0.0.1:18789/或者http://locahost:18789/

方法二：直接访问

在浏览器中输入：

复制代码

http://127.0.0.1:18789/
或者
http://locahost:18789/

7.3 Web UI功能

对话界面：与AI聊天
文件管理：查看、上传、下载文件
配置管理：修改配置文件
日志查看：实时查看运行日志
Cron任务：管理定时任务
Skills管理：安装、更新插件

7.4 配置Web UI认证

默认情况下，Web UI不需要密码。为了安全，建议设置认证：

bash 复制代码

openclaw config set gateway.controlUi.auth.enabled true
openclaw config set gateway.controlUi.auth.username "你的用户名"
openclaw config set gateway.controlUi.auth.password "你的密码"

# 重启网关使配置生效
openclaw gateway restart

八、权限配置（重要）

8.1 为Terminal添加权限

OpenClaw需要某些系统权限才能完全功能：

完全磁盘访问权限：

打开"系统设置" → "隐私与安全性"
找到"完全磁盘访问"
点击"+"号，添加"终端"（Terminal）
或者添加你的终端应用（如 iTerm2）

屏幕录制权限：

在"隐私与安全性"中找到"屏幕录制"
添加"终端"应用
重启终端

系统录音权限：

在"隐私与安全性"中找到"麦克风"
添加"终端"应用

8.2 验证权限

bash 复制代码

# 测试屏幕截图
openclaw browser screenshot --test

# 测试录音
openclaw browser audio --test

如果没有报错，说明权限配置正确。

8.3 权限问题排查

问题： 提示权限不足

解决方案：

检查Terminal是否在权限列表中
如果已添加但仍有问题，尝试：
- 重启Terminal
- 重启Mac
- 先删除Terminal，再重新添加

九、常见问题排查

9.1 问题：命令找不到

症状： openclaw --version 提示"command not found"

原因： npm全局路径未加入PATH

解决方案：

检查npm全局路径：

bash 复制代码

npm prefix -g

临时添加PATH：

bash 复制代码

# Intel Mac
export PATH="/usr/local/bin:$PATH"

# Apple Silicon Mac
export PATH="/opt/homebrew/bin:$PATH"

永久添加PATH：

编辑 ~/.zshrc（或 ~/.bash_profile）：

bash 复制代码

# Intel Mac
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc

# Apple Silicon Mac
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc

# 重新加载配置
source ~/.zshrc

9.2 问题：端口18789被占用

症状： 启动Gateway时提示端口被占用

排查：

bash 复制代码

lsof -i :18789

解决方案1：更改端口

bash 复制代码

openclaw config set gateway.port 18790
openclaw gateway start

解决方案2：结束占用进程

bash 复制代码

# 查看占用进程的PID
lsof -i :18789

# 结束进程（替换<PID>）
kill <PID>

# 如果无法结束，强制结束
kill -9 <PID>

9.3 问题：Gateway启动失败

症状： openclaw gateway start 后立即退出

排查步骤：

查看日志
bash 复制代码
```
openclaw logs --follow
```
运行诊断
bash 复制代码
```
openclaw doctor
```
检查配置
bash 复制代码
```
openclaw config get
```

常见原因：

端口被占用
权限不足
配置文件错误
API Key无效

9.4 问题：Web UI无法访问

症状： 浏览器访问 http://127.0.0.1:18789/ 打不开

排查：

确认Gateway运行状态
bash 复制代码
```
openclaw gateway status
```
检查端口监听
bash 复制代码
```
lsof -i :18789
```
查看防火墙设置
- 打开"系统设置" → "网络" → "防火墙"
- 确保未阻止本地连接

9.5 问题：守护进程无法启动

症状： openclaw gateway start 提示失败

解决方案：

重新安装守护进程

bash 复制代码

openclaw gateway uninstall
openclaw gateway install

手动启动测试
bash 复制代码
```
openclaw gateway --verbose
```

检查launchd错误

bash 复制代码

launchctl print system/com.openclaw.gateway

十、API Key配置（必做）

OpenClaw需要AI模型才能工作，选择以下任一方案：

10.1 KIMI Coding Plan（推荐）

申请步骤：

访问 https://www.kimi.com/code
登录/注册KIMI账号
点击"订阅Coding Plan"
选择套餐（49/99/199/699元）
完成支付（支持支付宝/微信）
进入控制台，点击"创建API Key"
复制生成的Key（以sk-开头）

价格参考：

Lite版：49元/月
标准版：99元/月
Pro版：199元/月
企业版：699元/月

配置到OpenClaw：

方法一：使用向导

bash 复制代码

openclaw configure

按提示选择KIMI并粘贴API Key。

方法二：命令行配置

bash 复制代码

openclaw models auth setup-token --provider kimi
# 输入API Key

10.2 MiniMax Coding Plan

申请步骤：

访问 https://platform.minimaxi.com/subscribe/coding-plan
注册/登录账号
完成实名认证（需要身份证）
订阅Coding Plan（29/49/119元）
进入"API管理"页面
创建API Key并复制

配置：

bash 复制代码

openclaw models auth setup-token --provider minimax

10.3 GLM Coding Plan

申请步骤：

访问 https://bigmodel.cn/glm-coding
注册/登录智谱AI账号
进入控制台
点击"API Keys"菜单
创建新的API Key
复制保存

配置：

bash 复制代码

openclaw models auth setup-token --provider glm

10.4 其他模型提供商

Anthropic (Claude):

bash 复制代码

openclaw models auth setup-token --provider anthropic

需要访问 https://console.anthropic.com 获取API Key。

OpenAI (GPT):

bash 复制代码

openclaw models auth setup-token --provider openai

需要访问 https://platform.openai.com 获取API Key。

十一、高级配置

11.1 配置多模型

OpenClaw支持配置主模型和备用模型，主模型失败时自动切换：

bash 复制代码

openclaw config set agents.defaults.model.primary "kimi/kimi-k2.5"
openclaw config set agents.defaults.model.fallbacks.0 "glm/glm-5"
openclaw config set agents.defaults.model.fallbacks.1 "minimax/minimax-m2.5"

11.2 配置工作目录

OpenClaw的工作目录默认是 ~/.openclaw/workspace，你可以自定义：

bash 复制代码

openclaw config set workspace "/path/to/your/workspace"

11.3 配置日志级别

默认日志级别是 info，可以调整为 debug 获取更详细日志：

bash 复制代码

openclaw config set logging.level "debug"

11.4 配置超时时间

默认会话超时是30分钟，可以调整：

bash 复制代码

# 设置为1小时
openclaw config set agents.defaults.reply.timeoutSeconds 3600

# 设置为2小时
openclaw config set agents.defaults.reply.timeoutSeconds 7200

十二、性能优化

12.1 启用缓存

缓存可以减少API调用，提升响应速度：

bash 复制代码

openclaw config set agents.defaults.cache.enabled true
openclaw config set agents.defaults.cache.ttl 3600  # 缓存1小时

12.2 优化模型选择

复杂任务：使用高质量模型（如KIMI K2.5 Pro）
简单任务：使用经济模型（如KIMI K2.5 Lite）
子代理任务：使用更便宜的模型

12.3 定期清理

定期清理旧会话和缓存，释放空间：

bash 复制代码

# 清理旧会话（保留最近7天）
openclaw sessions prune --days 7

# 清理缓存
rm -rf ~/.openclaw/cache/*

十三、安全加固

13.1 运行安全审计

定期运行安全审计，检查潜在风险：

bash 复制代码

openclaw security audit

如果发现问题，可以自动修复：

bash 复制代码

openclaw security audit --fix

13.2 配置DM策略

默认DM策略是 pairing，陌生人发消息需要你批准：

bash 复制代码

openclaw config set channels.whatsapp.dmPolicy "pairing"
openclaw config set channels.telegram.dmPolicy "pairing"

13.3 启用沙盒

沙盒可以在Docker容器中运行工具，提升安全性：

bash 复制代码

openclaw config set agents.defaults.sandbox.mode "non-main"
openclaw config set agents.defaults.sandbox.scope "session"

13.4 文件权限

确保配置文件权限正确：

bash 复制代码

chmod 600 ~/.openclaw/openclaw.json
chmod 700 ~/.openclaw

十四、总结与建议

使用建议

从小任务开始：先让AI完成简单任务，逐步信任
定期备份 ：定期备份 ~/.openclaw 目录
监控成本：注意API调用次数，控制成本
持续学习：探索更多功能和Skills
参与社区：加入Discord、GitHub，分享经验

恭喜你完成了OpenClaw在Mac系统上的安装部署！

下一步学习路径：

配置消息渠道：接入Telegram、WhatsApp、iMessage等
学习使用工具：浏览器自动化、Web搜索等
安装Skills插件：扩展AI能力
配置定时任务：自动化重复工作
开发自定义Skill：定制专属功能

参考资料：

OpenClaw官方文档: https://docs.openclaw.ai
Node.js官网: https://nodejs.org
Homebrew官网: https://brew.sh

OpenClaw安装部署Mac操作系统版 - 打造你的专属AI助理

【第二篇】OpenClaw安装部署Mac操作系统版 - 打造你的专属AI助理

前言：为什么Mac是最佳选择？

一、部署前的准备工作

1.1 系统要求检查

1.2 检查系统版本

1.3 检查Node.js版本

1.4 安装Xcode Command Line Tools

二、Node.js环境配置

2.1 安装Node.js

2.2 验证Node.js安装

三、OpenClaw安装方式

3.1 方法一：一键安装脚本（推荐）

3.2 方法二：npm全局安装

3.3 方法三：Git源码安装（开发者）

3.4 验证安装成功

四、初始化配置

4.1 运行初始化向导

4.2 向导步骤详解

4.3 初始化完成

五、首次对话测试

5.1 完成Bootstrap

5.2 发送测试消息

六、安装守护进程

6.1 什么是守护进程？

6.2 macOS上的守护进程

6.3 查看守护进程日志

6.4 开机自启配置

七、配置Web UI

7.1 什么是Web UI？

7.2 打开Web UI

7.3 Web UI功能

7.4 配置Web UI认证

八、权限配置（重要）

8.1 为Terminal添加权限

8.2 验证权限

8.3 权限问题排查

九、常见问题排查

9.1 问题：命令找不到

9.2 问题：端口18789被占用

9.3 问题：Gateway启动失败

9.4 问题：Web UI无法访问

9.5 问题：守护进程无法启动

十、API Key配置（必做）

10.1 KIMI Coding Plan（推荐）

10.2 MiniMax Coding Plan

10.3 GLM Coding Plan

10.4 其他模型提供商

十一、高级配置

11.1 配置多模型

11.2 配置工作目录

11.3 配置日志级别

11.4 配置超时时间

十二、性能优化

12.1 启用缓存

12.2 优化模型选择

12.3 定期清理

十三、安全加固

13.1 运行安全审计

13.2 配置DM策略

13.3 启用沙盒

13.4 文件权限

十四、总结与建议

推荐配置清单

使用建议