OpenClaw 在 Mac 上本地化部署及接入飞书教程

OpenClaw 简介

OpenClaw

OpenClaw 是 Moltbot/Clawdbot 的最新正式名称。经过版本迭代与改名后，统一以「OpenClaw」作为官方名称，核心定位是通过自然语言指令，替代人工完成流程化、重复性工作，无需用户掌握编程技能，适配多场景自动化需求。

该项目经历了多次更名，Clawdbot → Moltbot → OpenClaw（当前名称）

文章配图

OpenClaw 是什么？

OpenClaw 是一个开源的个人 AI 助手平台。

简单来说，它是一个可以将你自己的 AI 助手接入你已经在用的即时通讯工具（Telegram、WhatsApp、飞书等）的系统。你可以自己挑选 AI 模型进行连接，添加各种工具和技能（如飞书等），构建专属工作流。如果应用得当，它就是一个能帮你干活的'员工'。

文章配图

△ OpenClaw 采用模块化设计，其核心架构如图所示

注意：**OpenClaw 需要访问不少本地权限和文件。**建议找一台没有数据的 Mac 来试水，避免自己的隐私数据泄露。

准备工作

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

macOS Sonoma 或更新版本（推荐使用 Apple Silicon M1 及以上芯片，性能会更好）。

流畅的网络环境，部分依赖库需要从 GitHub 下载。

一颗爱折腾的心，其实很简单，跟着做就行了！不用担心自己是小白，本文会手把手教你成功部署 OpenClaw，同时还会教你和飞书互联。

官网版本区别

文章配图

对于新手来说，看到官网给出的四个安装方式到底有什么区别？

One-liner：一键脚本安装，最简单、官方推荐。它会自动检测系统并安装依赖。适合个人用户，想快速在 Mac/Linux 上体验完整功能。缺点是如果你对系统环境有洁癖，脚本方式侵入性太强，不方便后期更新维护。

npm：全局安装方式，需要依赖 Node.js 包管理器安装，适合前端开发者或已熟悉 Node.js 的用户（有一定计算机门槛），通过它安装，你知道自己在装什么，依赖了什么，不会弄乱你的开发环境。版本控制方便，更新更容易，本文选用此安装方式。

**Hackable：**源码安装方式，可任意魔改，下载源代码到本地。适合想要修改核心逻辑、自己写复杂插件、或者给项目提 PR 的人（小白请直接忽略）。

macOS：GUI 界面应用，这是一个 Mac 端应用，提供了一个菜单栏图标，原生体验并提供语音交互、快捷指令等原生 Mac 功能。但是它通常是为了配合 CLI（命令行版）使用的，而不是完全替代命令行，想用此应用还是需要先安装前三中任意一个。

经过上面的解释你应该很清楚各个安装方式的区别了，只是想玩玩 OpenClaw 并且懒得装 Node 环境，玩完重装系统也无所谓，那就一键部署选 One-liner。如果想把它当主力工具，长期稳定使用，出了问题好修、版本好管、系统干净，那就选 npm 安装。

环境配置（npm 安装）

OpenClaw 依赖于 Node.js 环境。如果你不懂这是什么，没关系，照着输命令即可。

官方下载地址：

https://nodejs.org/zh-cn/download

复制官网链接到浏览器打开，然后点击 macOS 安装程序（.pkg）下载安装包如果你更熟悉用 Homebrew 下载，那会更方便，官网下载可避免一些未知错误；

文章配图

2. 然后打开下载后的安装包，按照安装包的直接正常安装即可；

文章配图

安装完成，点击「关闭」即可；

文章配图

打开「终端」；

文章配图

5. 在终端内输入：

sudo npm i -g openclaw

然后回车，输入开机密码后再回车；

文章配图

6. 如果出现如图错误，修改 Git 下载协议（强制使用 HTTPS），复制下方代码到终端，回车执行即可解决；

git config --global url."https://github.com/".insteadOf ssh://[email protected]/

文章配图

7. 重新输入

sudo npm i -g openclaw

出现如图界面表示安装成功；

文章配图

8. 启动 OpenClaw 的初始化向导，输入下方代码，然后回车；

openclaw onboard

文章配图

这一步主要是提醒你，使用 OpenClaw 可能会有一些风险。请问你是否继续？按向左方向键 ←，选择 Yes，按 Enter 回车确认；

文章配图

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

文章配图

这里是配置 AI 模型 API Key，OpenClaw 需要连接到大语言模型才能工作。OpenClaw 比较费 token，国外模型成本较高，新版本已经支持 KIMI K2.5，小编以 KIMI 为例；

文章配图

注：其他任意模型均可，也可以用 Ollama 本地运行的 DeepSeek 的蒸馏版，即可免费使用 AI 模型。

12. 如果没有 KIMI 的 API Key，打开下方官方地址注册账号获取 API key，KIMI 认证后的账号可以获得 15 元的免费代金券；

https://platform.moonshot.cn/console/api-keys

文章配图

然后复制你的 API key，请保存好自己的 API；

文章配图

14. 选择 Kimi API key (.cn)，回车；

文章配图

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

文章配图

16. 选择保持当前（moonshot/kimi-k2.5），回车；

文章配图

17. 接着你会看到选择聊天选择工具的选项。这里你建议先「暂时跳过」，先在终端（Terminal）里把 OpenClaw 跑起来，确认它的 AI 大脑、文件读写权限都正常工作，后面再单独部署；

文章配图

18. 这里选择「Yes」，也可以暂不配置选择「No」，后面通过 UI 界面再进行配置；

文章配图

19. 选择「npm」；

文章配图

20. 关于技能，你可以先跳过选择此步骤，或者使用空格键您需要的技能，可多选；

文章配图

这里可以配置备用 API，如果不想配置就都选「No」即可；

文章配图

22. 正在完成最后的启动服务配置，大约 30 秒左右；

文章配图

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

文章配图

24. 安装完成，浏览器自动打开 Web UI 界面；

文章配图

把 OpenClaw 接入飞书机器人

首先进入飞书开放平台。登录成功后，点击创建企业自建应用；

文章配图

接着填写应用名称（如 "AppOS-OpenClaw 助手"）、应用描述，选择应用图标，点击**「创建应用」**按钮，进入应用管理页面；

文章配图

3. 在添加应用能力中选择「机器人」→ 点击「添加」；

文章配图

在开发配置中点击「权限管理」→「开通权限」；

文章配图

在搜索框内搜索**「im:」**勾选全部相关权限名称，最后点击「确认开通权限」；

文章配图

点击左侧「云文档」勾选全部相关权限名称，最后点击「确认开通权限」；

文章配图

点击顶部「创建版本」按钮；

文章配图

简单填写相关内容，然后点击「保存」；

文章配图

点击「确认发布」；

文章配图

机器人发布完成，开始配置 OpenClaw

文章配图

为了防止与自带的飞书文件夹冲突，我们直接把之前的先全部删掉，方便后面顺利安装，输入下方代码到终端内，然后回车，输入开机密码执行；

sudo rm -rf ~/.openclaw/extensions/feishu

文章配图

清理完成后，接着下载飞书插件，在终端输入下方代码，然后回车，输入开机密码执行；

openclaw plugins install @m1heng-clawd/feishu

文章配图

正在下载飞书插件，耐心等待即可；

文章配图

出现下面界面表示飞书插件安装成功；

文章配图

在输入下方输入代码，然后回车，输入开机密码执行；

openclaw config

文章配图

选择「Local (this machine)」，然后回车;

文章配图

选择「Channels（渠道）」，然后回车；

文章配图

选择「Configure/link（配置链接）」，然后回车；

文章配图

选择「Feishu/Lark（飞书）」，然后回车；

文章配图

打开飞书开放平台，在「应用凭证」里，复制 AppID 和 AppSecret；

文章配图

在终端对应位置分别输入飞书的 AppID 和 AppSecret；

文章配图

选择「Feishu（feishu.cn）- China」，然后回车；

文章配图

选择「Open - respond in all groups（requires mention）」，然后回车；

文章配图

选择「Finished」然后回车；

文章配图

选择「Yes」，回车；

文章配图

选择「Open...」，回车；

文章配图

选择「Continue」，回车；

文章配图

配置完成，关闭终端；

文章配图

重新打开终端，然后输入下方代码，重启配置；

openclaw gateway

文章配图

打开飞书开放平台，选择「事件与回调」→「订阅方式」→「使用长连接接收事件」→「保存」；

文章配图

然后点击同一页面内的「添加事件」；

文章配图

在弹出的列表中，搜索并添加 「接收消息」、「消息已读」、「机器人进群」、「机器人被移出群」，最后点击「确认添加」；

文章配图

添加完成后如下图所示；

文章配图

点击「权限管理」→搜索「通讯录」→选中「获取通讯录基本信息」→「确认开通权限」；

文章配图

配置完成后我们需要重新发布新版本，点击顶部「创建版本」；

文章配图

按如图所示输入；

文章配图

点击「确认发布」；

文章配图

打开手机端「飞书」，搜索机器人的名字，给机器人发消息，如果机器人以 AI 的方式进行回复，那么恭喜你配置成功（太不容易了）。

文章配图

OpenClaw 常用命令

openclaw onboard # 重新进入配置向导
openclaw status # 查看运行状态
openclaw health # 健康检查
openclaw gateway start # 启动服务
openclaw gateway stop # 停止服务
openclaw update # 更新到最新版本
openclaw doctor # 诊断问题
openclaw uninstall # 卸载 OpenClaw

OpenClaw 技能库

最后再推荐两个 OpenClaw 技能库，它就是给你的 AI 装上一堆「技能插件」，让它从'动嘴皮子'变成'真能干活'。

文章配图

1. 宝藏仓库地址 GitHub 地址：

https://github.com/VoltAgent/awesome-openclaw-skills

里面包含内容众多，可根据自身需求进行安装；

文章配图

ClawHub，精英特工的技能平台。

**官方网站：**https://clawhub.ai/

文章配图

OpenClaw 在 Mac 上本地化部署及接入飞书教程

OpenClaw 简介

OpenClaw 是什么？

准备工作

官网版本区别

环境配置（npm 安装）

2. 然后打开下载后的安装包，按照安装包的直接正常安装即可；

5. 在终端内输入：

6. 如果出现如图错误，修改 Git 下载协议（强制使用 HTTPS），复制下方代码到终端，回车执行即可解决；

7. 重新输入

8. 启动 OpenClaw 的初始化向导，输入下方代码，然后回车；

12. 如果没有 KIMI 的 API Key，打开下方官方地址注册账号获取 API key，KIMI 认证后的账号可以获得 15 元的免费代金券；

18. 这里选择「Yes」，也可以暂不配置选择「No」，后面通过 UI 界面再进行配置；

19. 选择「npm」；

20. 关于技能，你可以先跳过选择此步骤，或者使用空格键您需要的技能，可多选；

22. 正在完成最后的启动服务配置，大约 30 秒左右；

24. 安装完成，浏览器自动打开 Web UI 界面；

把 OpenClaw 接入飞书机器人

3. 在添加应用能力中选择「机器人」→ 点击「添加」；

OpenClaw 常用命令

OpenClaw 技能库

1. 宝藏仓库地址 GitHub 地址：

更多推荐文章

相关免费在线工具

OpenClaw 在 Mac 上本地化部署及接入飞书教程

OpenClaw 简介

OpenClaw 是什么？

准备工作

官网版本区别

环境配置（npm 安装）

2. 然后打开下载后的安装包，按照安装包的直接正常安装即可；

5. 在终端内输入：

6. 如果出现如图错误，修改 Git 下载协议（强制使用 HTTPS），复制下方代码到终端，回车执行即可解决；

7. 重新输入

8. 启动 OpenClaw 的初始化向导，输入下方代码，然后回车；

12. 如果没有 KIMI 的 API Key，打开下方官方地址注册账号获取 API key，KIMI 认证后的账号可以获得 15 元的免费代金券；

18. 这里选择「Yes」，也可以暂不配置选择「No」，后面通过 UI 界面再进行配置；

19. 选择「npm」；

20. 关于技能，你可以先跳过选择此步骤，或者使用空格键您需要的技能，可多选；

22. 正在完成最后的启动服务配置，大约 30 秒左右；

24. 安装完成，浏览器自动打开 Web UI 界面；

把 OpenClaw 接入飞书机器人

3. 在添加应用能力中选择**「机器人」→** 点击**「添加」；**

OpenClaw 常用命令

OpenClaw 技能库

1. 宝藏仓库地址 GitHub 地址：

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具

3. 在添加应用能力中选择「机器人」→ 点击「添加」；