OpenClaw是一个开源的AI智能体，让你可以在本地部署AI助手，操作本地文件。支持通过飞书、企业微信、QQ、钉钉和Telegram等国内外通讯平台随时指挥。支持 Claude、GPT、Gemini、DeepSeek、MiniMax、通义千问和Kimi等多种模型。

集文件管理、知识管理、日程管理、自动化任务与实用工具于一体，支持文件智能搜索、批量处理、自动整理，可以进行笔记同步、日历同步、智能提醒，可以设定定时任务、推送日报，还提供截图、翻译和画图等功能。

接下来就是保姆级超详细教程，全网最新版！手把手带你从零完成OpenClaw全流程部署 —— 从安装运行环境、配置大模型，到成功连接飞书，最终实现用手机直接指挥OpenClaw自动干活，全程step by step，跟着操作，10分钟就能一次搞定！

OpenClaw 的核心基于 TypeScript 语言开发，且依托 Node.js 运行环境运行；macOS系统的Git工具，不用需要通过Command Line Tools for Xcode进行安装。接下来咱们就从下载并安装运行环境开始吧。

如果想跟着视频一步一步走的话，看这个《2. OpenClaw小龙虾(macOS)+飞书本地部署：小白10分钟搞定，保姆级教程》，喜欢看文章的，接着往下看。

1. 安装运行环境

(1) 下载安装包

打开Node.js官方网站(https://nodejs.org/zh-cn)，点击【获取Node.js®】按钮，进入下载安装包窗口。

根据你的电脑操作系统选择对应的安装包，网站会自动适配系统版本。核对无误后，点击页面上的【macOS Installer (.pkg)】按钮，即可开始下载。

macos系统的Git通过Command Line Tools for Xcode进行安装。下载版本为系统版本号+1，我的是14的，14+1=15，所以下载15的版本。

确定版本号之后，点击【View Details】，会展开下载链接。

鼠标点击【Command Line Tools for Xcode 15.3.dmg】，即可开始下载。

(2) 安装Node.js

双击 Node.js 安装包，会弹出Node.js的介绍，了解即可，点击【继续】按钮。

软件许可协议，全英文的，能看懂的就看看，看完了就点击【继续】。

又碰到了只有【同意】和【不同意】选项的弹窗，必须点【同意】才能继续下一步，点【不同意】就会直接退回，根本没得选，只能点【同意】。

输入开机密码之后，点击【安装软件】。

先喝口水休息一下，正好趁这会儿装 Node.js和npm，前者能让 JS 在电脑端跑起来，后者专门用来管理JS的各类库和工具。

恭喜你，到这，Node.js就安装成功了，点击【关闭】按钮，关闭窗口。

双击【Command Line Tools for Xcode】安装包，会看到关于Command Line Tools的介绍，这没什么好看的，直接点击【继续】。

软件许可协议，了解一下即可，了解完就点击【继续】按钮。

又碰到了只有【同意】和【不同意】选项的弹窗，必须点【同意】才能继续下一步，点【不同意】就会直接退回，根本没得选，只能点【同意】。

在这里可以更改安装位置，一般用默认的即可，点击【安装】。

输入开机密码之后，接着点击【安装软件】。

安装进度条还在慢悠悠动，正好摸鱼歇会儿～这次装的是Git版本控制，等下就能用它把OpenClaw的代码仓库扒下来啦。

看到窗口醒目的 “安装成功” 了，这步稳了，直接点【关闭】把窗口关了就行。

接下来我们将通过“终端”验证 Git 是否安装成功，先点击底部的【应用程序】图标。

在【其他】文件夹，点击进去。

找到【终端】并点击打开。

输入如下命令并回车。

git --version

能看到Git的版本号，则表示安装成功。如果看到错误信息，那就在评论区留言。

2. 开始安装openclaw

npm 默认使用国外源，下载速度较慢，还经常出现下载到一半就中断的情况。想要解决这个问题，可以通过以下命令，将npm源切换为阿里云国内镜像。

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

接下来，你就可以通过npm命令全局安装openclaw包的最新版本了。输入开机密码之后，就开始安装了。下载和安装需要一定时间，需要稍微等待，不要中途退出终端或中断命令执行。

sudo npm install -g openclaw

看到如下提示信息，即表示安装成功了。如果安装过程中出现失败提示，不用着急，只需重新输入如下刚刚的命令再次执行安装即可。

3. OpenClaw配置

运行如下命令，进行OpenClaw的初始化设置，按Enter回车键确认。

openclaw onboard

红色字体的大概意思是：“我了解该功能默认为个人使用，若要用于共享或多用户场景，需进行权限锁定与安全加固。是否继续？”

按下键盘向左方向键 ←，选择【Yes】，按Enter回车键确认。如果选择【No】，就不安装了。

选择快速启动 QuickStart 选项，按回车键确认。

开始配置大模型，国内外主流大模型供应商均支持接入，国内可选 Kimi、Minimax 等，配置步骤基本一致。以 Minimax 为例，按下键盘向下方向键↓选中目标大模型，再按Enter回车键确认。

按下键盘向下方向键 ↓，选中【MiniMax CN - API Key (minimaxi.com) 】（该选项为国内大模型 API 接入接口），按下Enter回车键确认。

选择【Paste API key now】（立即粘贴API密钥），按下回车键确认。

在此处输入MiniMax国内大模型接口的API Key。

鼠标右键粘贴API Key，按Enter回车键确认。

需要选择默认大模型，直接选择【Keep current（minimax/MiniMax-M2.5）】即可。

配置即时通讯平台，此处暂时不配置（后续会配置飞书）。按下键盘向下方向键 ↓，选择【Skip for now】跳过即可。

搜索服务大模型列表配置，选择【Skip for now】跳过，后续若需配置搜索服务，可在 OpenClaw配置中重新添加。

Skills选择列表，选择【No】，暂不配置，用到的时候再配置。

在 hooks 配置列表中，选择【session-memory】选项（该选项用于存储会话记录）。按下键盘向下方向键 ↓ 定位到该选项，按下【空格】键选中，再按回车键确认。

配置OpenClaw系统服务，需要一些时间，稍等片刻即可。

选择【Open the Web UI】并回车确认。

浏览器会自动打开OpenClaw的Web UI界面。

在输入框中输入你想发送的内容（可输入：“你是哪个大模型？”），按下回车键或点击【Send】按钮进行发送。

看到大模型成功回复，即代表OpenClaw已安装成功。接下来创建飞书机器人。

4. 创建飞书机器人

打开飞书开放平台地址 https://open.feishu.cn，创建机器人用于接入OpenClaw。点击【创建企业自建应用】按钮，进入应用信息配置窗口。

填写应用名称与应用描述，应用图标可在页面中选择样式，也可自行上传，根据个人喜好选择即可；全部填写完成后，点击【创建】按钮。

第一个卡片为【机器人】，点击卡片上的【添加】按钮，给机器人添加应用能力。

能看到左侧菜单栏的机器人图标，即代表机器人创建成功。

接着给应用添加权限。先点击【权限管理】，接着点击【开通权限】按钮，即可弹出权限配置窗口。

在搜索框中输入“im:”，找出跟通讯相关的权限列表。

在【权限名称】有个复选框，勾选就会将下面的权限全部选上，接着点击【确认开通权限】按钮。

点击【创建版本】按钮，进入应用版本详情窗口，填写应用发布相关信息。

填写应用版本号（1.0.0）和更新说明（功能描述），接着鼠标往下滑动。

按下【保存】按钮，会弹出确认发布的窗口。

按下【确认发布】按钮，发布机器人应用。

看到【当前修改均已发布】或【已发布】提示，即代表应用发布成功；个人账号通常无需审核。接着到【终端】窗口配置飞书通讯。

5. 配置飞书通讯

新开一个【终端】窗口，输入以下命令并按下回车键确认，即可进入 OpenClaw 的配置列表界面。

openclaw config

选择【Local（this machine）】（本地机器）选项。

按下键盘向下方向键↓，选择【Channels】(渠道)选项并回车。

选择【Configure/link】(配置连接)选项并回车。

按下键盘向下方向键↓，选择【Feishu/Lark（飞书）】选项并回车。

选择【Enter App Secret】选项并按下键盘Enter回车键。

等你输入App Secret，该信息在飞书开放平台后台。

打开飞书后台，点击【凭据与基础信息】即可查看到 App Secret，点击复制图标进行复制。

回到配置窗口，鼠标右键，便可将App Secret粘贴进去，按下回车键确认。

接下来需要输入 App ID，它同样在飞书后台的【凭据与基础信息】页面。

打开飞书后台，点击【凭据与基础信息】即可查看到App ID，点击复制图标进行复制。

回到配置窗口，鼠标右键，便可将App ID粘贴进去，按下回车键确认。

飞书通讯连接模式选择【WebSocket（default）】，该模式为默认长连接，支持双向实时通信，不用管这些技术术语 ，接着往下走。

通讯连接地址，选择国内的【Feishu（feishu.cn）- China】选项并回车。

选择【Open – respond in all groups（requires menthion）】选项，接受群组聊天。

选择【Finished】选项并回车。

是否授权私信聊天功能，直接选择【Yes】即可，默认会采用 pairing（配对）模式，无需额外修改。

选择【Open (public inbound DMs)】，允许任何人向你的飞书机器人发送私信，无需提前配对。

选择【Continue】（继续），完成配置。

在新的【终端】窗口，输入如下命令，重启OpenClaw服务，让配置生效。可以看到飞书插件已经配置成功。接下来还需要配置飞书的“事件与回调”和“长连接”。

openclaw gateway restart

6. 配置飞书“事件与回调”和“长连接”

打开飞书后台，点击【事件与回调】，接着点击【订阅方式】旁边的【编辑】图标，便会展开设置长连接的内容。

勾选【使用 长连接 接收事件】，点击【保存】按钮后，右下角原本置灰、不可操作的【添加事件】按钮将被激活。

按下【添加事件】按钮，会弹出添加事件窗口。

在搜索框内输入 “接收消息”，勾选【接收消息】选项，然后点击【添加】按钮；在返回的窗口中，再次点击【添加事件】按钮。

在搜索框内输入“消息”，勾选【消息已读】选项，然后点击【添加】按钮；在返回的窗口中，再次点击【添加事件】按钮。

在搜索框内输入“机器人”，勾选【机器人进群】和【机器人被移除群】两个选项，然后点击【添加】按钮。

接着还需要开通“获取通讯录基本信息”权限，点击【权限管理】，接着点击【开通权限】按钮，又来到你熟悉的权限配置窗口。

在搜索框中输入“通讯录”，勾选【获取通讯录基本信息】选项，点击【确定开通权限】按钮。

出现需要再次确认窗口时，点击【确认】按钮。

点击【创建版本】按钮，进入应用版本详情窗口，填写应用发布相关信息。

填写应用版本号（1.0.1）和更新说明（功能描述），接着鼠标往下滑动。

按下【保存】按钮，会弹出确认发布的窗口。

按下【确认发布】按钮，发布机器人新功能。

看到【当前修改均已发布】或【已发布】提示，即代表应用发布成功；个人账号通常无需审核。接着新开一个【终端】窗口。

在命令行窗口中，再次输入你熟悉的重启 OpenClaw 服务的命令。服务重启成功后，就迎来了激动人心的时刻——和OpenClaw聊会天。

openclaw gateway restart

7. 跟OpenClaw聊会天

在手机上安装飞书 App，输入计算机操作指令（如 “把桌面上的 安装步骤 文件发给我”），在聊天窗口中，若出现带有机器人的标识（如 “openclaw”），代表机器人正在思考，稍等片刻，即可收到文件。

恭喜你！到这里，你已经成功成为 “养龙虾” 大户啦！关注老陈说编程，解锁更多 AI 技能，掌握更多实用本领！