跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

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

综述由AI生成介绍如何在 Mac 系统上通过 npm 方式本地化部署开源个人 AI 助手平台 OpenClaw。内容涵盖环境准备、Node.js 安装、OpenClaw 初始化配置及 API Key 设置。此外,详细说明了如何将 OpenClaw 接入飞书开放平台,创建企业自建应用并配置机器人权限,实现通过自然语言指令控制飞书聊天。最后提供了常用命令及技能库扩展建议,帮助用户构建专属自动化工作流。

菩提发布于 2026/4/5更新于 2026/6/1241 浏览
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

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

文章配图

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

文章配图

  1. 安装完成,点击「关闭」即可;

文章配图

  1. 打开「终端」;

文章配图

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

文章配图

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

文章配图

  1. 选择 QuickStart(快速开始模式),回车;

文章配图

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

文章配图

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

文章配图

  1. 这里可以配置备用 API,如果不想配置就都选「No」即可;

文章配图

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

文章配图

  1. 配置完成,选择「Open the web UI」,打开可视化页面;

文章配图

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

文章配图

把 OpenClaw 接入飞书机器人

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

文章配图

  1. 接着填写应用名称(如 "AppOS-OpenClaw 助手")、应用描述,选择应用图标,点击**「创建应用」**按钮,进入应用管理页面;

文章配图

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

文章配图

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

文章配图

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

文章配图

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

文章配图

  1. 点击顶部「创建版本」按钮;

文章配图

  1. 简单填写相关内容,然后点击「保存」;

文章配图

  1. 点击「确认发布」;

文章配图

  1. 机器人发布完成,开始配置 OpenClaw

文章配图

  1. 为了防止与自带的飞书文件夹冲突,我们直接把之前的先全部删掉,方便后面顺利安装,输入下方代码到终端内,然后回车,输入开机密码执行;
sudo rm -rf ~/.openclaw/extensions/feishu

文章配图

  1. 清理完成后,接着下载飞书插件,在终端输入下方代码,然后回车,输入开机密码执行;
openclaw plugins install @m1heng-clawd/feishu

文章配图

  1. 正在下载飞书插件,耐心等待即可;

文章配图

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

文章配图

  1. 在输入下方输入代码,然后回车,输入开机密码执行;
openclaw config

文章配图

  1. 选择「Local (this machine)」,然后回车;

文章配图

  1. 选择「Channels(渠道)」,然后回车;

文章配图

  1. 选择「Configure/link(配置链接)」,然后回车;

文章配图

  1. 选择「Feishu/Lark(飞书)」,然后回车;

文章配图

  1. 打开飞书开放平台,在「应用凭证」里,复制 AppID 和 AppSecret;

文章配图

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

文章配图

  1. 选择「Feishu(feishu.cn)- China」,然后回车;

文章配图

  1. 选择「Open - respond in all groups(requires mention)」,然后回车;

文章配图

  1. 选择「Finished」然后回车;

文章配图

  1. 选择「Yes」,回车;

文章配图

  1. 选择「Open...」,回车;

文章配图

  1. 选择「Continue」,回车;

文章配图

  1. 配置完成,关闭终端;

文章配图

  1. 重新打开终端,然后输入下方代码,重启配置;
openclaw gateway

文章配图

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

文章配图

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

文章配图

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

文章配图

  1. 添加完成后如下图所示;

文章配图

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

文章配图

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

文章配图

  1. 按如图所示输入;

文章配图

  1. 点击「确认发布」;

文章配图

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

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

文章配图

  1. ClawHub,精英特工的技能平台。

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

文章配图

目录

  1. OpenClaw 简介
  2. OpenClaw 是什么?
  3. 准备工作
  4. 官网版本区别
  5. 环境配置(npm 安装)
  6. 2. 然后打开下载后的安装包,按照安装包的直接正常安装即可;
  7. 5. 在终端内输入:
  8. 6. 如果出现如图错误,修改 Git 下载协议(强制使用 HTTPS),复制下方代码到终端,回车执行即可解决;
  9. 7. 重新输入
  10. 8. 启动 OpenClaw 的初始化向导,输入下方代码,然后回车;
  11. 12. 如果没有 KIMI 的 API Key,打开下方官方地址注册账号获取 API key,KIMI 认证后的账号可以获得 15 元的免费代金券;
  12. 18. 这里选择「Yes」,也可以暂不配置选择「No」,后面通过 UI 界面再进行配置;
  13. 19. 选择「npm」;
  14. 20. 关于技能,你可以先跳过选择此步骤,或者使用空格键您需要的技能,可多选;
  15. 22. 正在完成最后的启动服务配置,大约 30 秒左右;
  16. 24. 安装完成,浏览器自动打开 Web UI 界面;
  17. 把 OpenClaw 接入飞书机器人
  18. 3. 在添加应用能力中选择「机器人」→ 点击「添加」;
  19. OpenClaw 常用命令
  20. OpenClaw 技能库
  21. 1. 宝藏仓库地址 GitHub 地址:
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • PageIndex 无分块文档索引与推理检索指南
  • Python、PyTorch、CUDA 及 MMCV/MMDetection 版本对应指南
  • GLM-5 与 Qwen3.5 模型 API 接口调用实战指南
  • 生成式大模型与判别式大模型的联系与区别
  • Java 后端常见面试题及参考答案
  • Stable Diffusion 之外:三款主流图像生成工具对比
  • MCP 协议详解:与 Function Call 的区别及使用方法
  • Linux 高级 IO:I/O 多路转接之 epoll 接口与原理详解
  • 自然语言处理在教育领域的实战应用
  • CSS3 文本样式:溢出、换行与断行控制
  • Stable Diffusion 视觉提示词注入攻击原理与实现
  • 工业级存储芯片 CSNP32GCR01-AOW 在无人机飞控系统中的应用实践
  • Openclaw 报错 unauthorized: gateway token mismatch 解决方案
  • AgentScope Java v1.0 深度解析:企业级 AI Agent 落地指南
  • ThingsBoard 设备批量导入实战:ID 与 Token 管理
  • 基于 WebRTC+AI 的智能远程控制解决方案
  • Go 语言核心控制流:for 循环与 switch 详解
  • Moltbot:让 Claude 从聊天工具转变为可落地 AI Bot
  • AI 大模型入门基础知识与核心架构解析
  • MogFace 人脸检测模型:WebUI GPU 方案实现单卡 20 路实时流处理

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online