OpenClaw Mac 本地部署指南

适用环境：macOS 本地安装适合人群：希望在 Mac 上长期稳定使用 OpenClaw 的开发者和进阶用户

如果你主要使用 MacBook 或 Mac mini，想把 OpenClaw 跑在本地，这篇可以直接照着做。相比 Windows，macOS 的部署路径更直接，不需要 WSL，但有一个前置条件一定要先处理好：Xcode Command Line Tools。

一、先说结论：Mac 上可以直接本地安装

根据官方文档，本地安装适合希望完全掌控数据和运行环境的用户。OpenClaw 本身是一个运行在 Node.js 上的 TypeScript 项目，因此系统环境是否完整，直接决定安装体验。

官方给出的关键信息有这几个：

Node.js 版本要求为 22 及以上
包管理器可用 npm / pnpm / bun
macOS 安装前，需要先安装 Xcode Command Line Tools
推荐优先使用 npm 全局安装
macOS 也支持官方的一键脚本安装

二、系统要求

在 Mac 上部署 OpenClaw，建议先确认下面几点：

macOS 设备可正常联网
已安装 Node.js 22+
已安装 Xcode Command Line Tools
终端可正常使用 npm

其中最容易忽略的是这一条：

xcode-select --install

如果你之前没装过 Xcode Command Line Tools，先执行这条命令。没有它的话，一些依赖在安装过程中可能会报错。

三、安装方式怎么选

方式一：npm 全局安装（推荐）

这是官方更推荐的方案，适合大多数用户：

npm install -g openclaw@latest openclaw onboard --install-daemon

说明一下：

npm install -g openclaw@latest
：全局安装 OpenClaw
openclaw onboard --install-daemon
：完成初始化配置，同时安装守护进程，让 OpenClaw 在后台持续运行

如果你希望装完就能长期使用，这个方式最省心。

方式二：官方一键脚本安装

如果你不想手动折腾 Node.js，也可以尝试官方脚本：

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

这个方式适用于 macOS / Linux。脚本会自动检测系统环境，在缺少 Node.js 时自动补齐，并完成 OpenClaw 安装。不过从稳定性和可控性来说，如果你平时本来就用 Node 开发，还是更建议直接走 npm安装。

四、初始化配置

安装完成后，运行 onboarding：

openclaw onboard

或者如果你前面已经加了 --install-daemon，那这个步骤会一起完成。

Onboarding 过程中，通常会引导你配置这些内容：

选择模型
填写 API Key
配置消息渠道
设置基础运行参数

五、飞书接入建议

如果你准备把 OpenClaw 接到飞书，推荐使用 WebSocket 长连接模式。

建议配置如下：

模式：WebSocket
域：feishu.cn
群聊策略：Allowlist
仅在指定群内响应

这样做的好处是响应更稳定，不容易误触发，也更适合社群、团队群等正式场景。

六、第三方模型中转配置

如果你使用的是第三方 API 中转，而不是官方直连，可以直接编辑配置文件：

nano ~/.openclaw/openclaw.json

在 models字段中填入对应配置，例如：

"models": {   "anthropic/claude-sonnet-4-6": {     "apiKey": "你的key",     "baseURL": "https://你的中转地址/v1"   } }

保存后重启 Gateway：

openclaw gateway restart

七、Web 搜索建议

如果你准备启用 Web 搜索能力，初始方案可以先用 DuckDuckGo。但从可用性和后续体验来看，更建议考虑下面两个：

Brave Search
Tavily

这两个通常都有免费额度，也更适合长期使用。

重新配置命令：

openclaw configure --section web

八、Skills 安装建议

Skills 不建议一口气装太多，先装常用的就够了。比如常见的：

github
gh-issues

先满足实际工作流，再按需扩展，会比一次性装很多更省事。

九、GitHub CLI 建议一并装好

如果你后面会配合 GitHub 使用，建议把 gh也装好并完成授权。

gh auth login

然后按提示完成设备授权即可。这样后面无论是提 issue、查仓库、做自动化，都会顺畅很多。

十、安全审计建议装完就跑一次

安装完成后，建议执行：

openclaw security audit

重点关注两类常见问题：

allowInsecureAuth=true
：非调试环境建议关闭
feishu.doc
权限：如果不用飞书文档能力，可以在配置中禁用

十一、Mac 用户额外优势

Mac 环境相比其他平台，有一个额外价值点：如果你后续要用 iMessage 频道或 Apple Notes 技能，这些依赖 macOS 原生 AppleScript 能力，只有在 macOS 上才能运行。

十二、常见问题

1. 安装时报依赖或编译错误

优先检查这两项：

xcode-select --install node -v

确保已经安装 Xcode Command Line Tools，并且 Node.js 版本不低于 22。

2. 配置文件异常

可以先尝试：

openclaw doctor --fix

如果还是不行，再删除配置重来：

rm ~/.openclaw/openclaw.json openclaw onboard

3. 飞书连接时报 `bot open_id: unknown`

先检查飞书开发者后台是否已开启长连接订阅方式。这个报错不一定代表彻底失败，系统一般会自动重试。

4. Dashboard 怎么访问

启动后一般会看到类似地址：

http://127.0.0.1:XXXXX/

具体端口以实际日志为准。

十三、我的实战建议

先安装 Xcode Command Line Tools
使用 npm 全局安装OpenClaw
通过 onboard --install-daemon完成初始化
模型接入优先走 第三方 API 中转
飞书使用 WebSocket + Allowlist
装完第一时间执行 security audit

一句话总结：Mac 上部署 OpenClaw 的难点不在 OpenClaw 本身，而在前置环境是否完整。只要 Node.js 22+ 和 Xcode Command Line Tools 准备好，后面的安装和接入其实都比较顺。