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

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

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

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

环境配置（npm 安装）

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

官方下载地址：

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

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

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

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

4. 打开「终端」；

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

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

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

11. 这里是配置 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

13. 然后复制你的 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. 关于技能，你可以先跳过选择此步骤，或者使用空格键您需要的技能，可多选；

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

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

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

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

把 OpenClaw 接入飞书机器人

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

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

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

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

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

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

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

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

9. 点击「确认发布」；

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

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

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

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

openclaw plugins install @m1heng-clawd/feishu

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

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

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

openclaw config

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

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

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

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

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

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

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

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

24. 选择「Finished」然后回车；

25. 选择「Yes」，回车；

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

27. 选择「Continue」，回车；

28. 配置完成，关闭终端；

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

openclaw gateway

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

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

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

33. 添加完成后如下图所示；

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

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

36. 按如图所示输入；

37. 点击「确认发布」；

38. 打开手机端「飞书」，搜索机器人的名字，给机器人发消息，如果机器人以 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

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

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

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