OpenClaw完整安装指南【MacOS版】

准备工作

在开始之前，请确认你的 Mac 满足以下条件：

• macOS Sonoma 或更新版本（推荐使用 Apple Silicon M1 及以上芯片，性能更佳）
• 网络环境稳定流畅，必要时可能需要科学上网（部分依赖库需要从 GitHub 下载）
• 一颗愿意尝试新技术的心

其实整个过程并不复杂，只要跟着步骤操作即可。即使你是小白用户也不用担心，本文会一步一步教你成功部署 OpenClaw，并完成与 飞书机器人的互联。

第一步：安装Node.js环境

首先需要安装 Node.js（包含 npm 包管理器）。

官方下载地址：

https://nodejs.org/en/download

安装完成后，建议将 npm 切换为 国内镜像源，这样安装依赖时速度会更快，否则可能会出现下载缓慢甚至无法下载的问题。

在终端执行：

npm config set registry https://registry.npmmirror.com

然后验证是否安装成功：

node -vnpm -v

第二步：OpenClaw介绍

OpenClaw 官方网站：

https://openclaw.ai/

OpenClaw 提供了多种安装方式：

One-liner（推荐）

一键脚本安装方式，是官方推荐的方式。

脚本会自动检测系统并安装所有依赖，非常适合想快速体验完整功能的个人用户。

缺点是脚本安装对系统环境的控制较少，如果你比较在意系统环境整洁，后期更新和维护可能不太方便。

npm 安装

通过 Node.js 的 npm 包管理器进行全局安装。

适合：

• 前端开发者
• 熟悉 Node.js 环境的用户

优点：

• 安装过程透明
• 依赖关系清晰
• 版本管理更方便
• 更新更加容易

本文将采用 npm 安装方式。

Hackable（源码安装）

通过下载源码进行安装，可以自由修改项目代码。

适合：

• 想要修改核心逻辑的开发者
• 想编写复杂插件的用户
• 想给项目贡献 PR 的开发者

如果你是新手用户，可以忽略这种方式。

macOS GUI 应用

这是 OpenClaw 提供的 Mac 图形界面应用。

它会在菜单栏中提供一个图标，并支持：

• 语音交互
• 快捷指令
• 原生 macOS 功能

不过它通常是配合 CLI（命令行版本）一起使用，而不是完全替代 CLI，因此仍然需要先安装前面三种方式中的任意一种。

第三步：安装OpenClaw

本文采用 Node.js + npm 的方式安装 OpenClaw。

在终端内输入：

sudo npm i -g openclaw

安装完成后，启动 OpenClaw 初始化向导：

openclaw onboard

系统会提示你：

使用 OpenClaw 可能存在一些风险，是否继续？

选择 QiuickStart（快速开始模式），回车；

OpenClaw 需要连接 大语言模型 API 才能工作。

由于 OpenClaw 使用 token 较多，这里以 MiniMax 为例：

https://platform.minimaxi.com/user-center/basic-information

获取 API Key 后，在终端中输入并回车。

15. 然后输入你的API Key，回车；

系统会询问是否立即配置聊天工具。

这里可以先 跳过。

暂不配置选择「No」，后面通过UI界面再进行配置；

系统会询问是否选择技能。

可以：

• **使用 **空格键选择需要的技能（支持多选）
• 或直接跳过

配置完成，选择「Open the web UI」，打开可视化页面；

此时可以简单测试一下功能是否正常。

第四步：接入飞书机器人

首先进入 飞书开放平台。

登录后点击：创建企业自建应用

创建应用

填写以下信息：

• 应用名称（例如：智能使用说明书-龙虾机器人）
• 应用描述
• 应用图标

添加机器人能力

进入：

添加应用能力

选择：

机器人

点击：

添加

开通权限

进入：

开发配置 → 权限管理 → 开通权限

在搜索框输入：

im:

勾选所有相关权限，然后点击：

确认开通权限

继续搜索：

通讯录

选择：

获取通讯录基本信息

然后点击：

确认开通权限

订阅事件

进入：

事件与回调

选择：

订阅方式 → 使用长连接接收事件

点击保存。

然后点击：

添加事件

按需选择需要的事件。

然后点击添加事件

最后创建版本

****然后点击确认发布

第五步：再次配置openclaw连接飞书机器人

命令行输入

openclaw config

依次选择：

依次选择：

依次选择：

到这一步，如果出现下面的：

则说明安装顺利，跳转到第5-1步：

如果出现下面的错误

则根据提示执行命令：

sudo chown -R 501:20 "/Users/liangfacai/.npm"

注意，文件夹路径要改为你自己的

然后命令行输入命令

openclaw channels add

然后依次选择飞书

如果出现下面的错误：

这和最近 OpenClaw 的已知问题一致：Feishu 插件在某些版本里会报 Cannot find module '@larksuiteoapi/node-sdk'，根因是 bundled Feishu 的依赖解析/打包有问题。官方 issue 里已经复现并说明过。

最直接的处理办法

先把 全局自带的 feishu 删掉，只保留你家目录里的那份：

rm -rf ~/.nvm/versions/node/v24.11.0/lib/node_modules/openclaw/extensions/feishu

rm -rf ~/.openclaw/extensions/feishu

openclaw plugins install @openclaw/feishu

然后执行 openclaw channels add

依次选择飞书即可

第5-1步：

输入飞书的密钥：

此密钥获得流程如下：

成功！

配置完成后，在飞书的群组添加机器人里选择刚才创建的机器人即可。