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

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 界面；

接入飞书机器人

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

2. 接着填写应用名称（如 "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 onboard          # 重新进入配置向导
openclaw status           # 查看运行状态
openclaw health           # 健康检查
openclaw gateway start    # 启动服务
openclaw gateway stop     # 停止服务
openclaw update           # 更新到最新版本
openclaw doctor           # 诊断问题
openclaw uninstall        # 卸载 OpenClaw

技能库

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

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

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

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

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

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

参考文档

https://docs.openclaw.ai/zh-CN