OpenClaw是一个开源的AI智能体，让你可以在本地部

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

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

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

OpenClaw 的核心基于 TypeScript 语言开发，且依托 Node.js 运行环境运行；而下载 OpenClaw代码库还需要用到Git工具，接下来咱们就从下载并安装运行环境开始吧。

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

1. 安装运行环境

(1) 下载安装包

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

根据你的电脑操作系统（如 Windows 64 位）选择对应安装包，多数网站会自动适配系统版本。核对无误后，点击页面上的【Windows 安装程序 (.msi)】按钮，即可开始下载。

打开Git官方网站(https://git-scm.com)，点击【Install for Windows】按钮，进入下载安装包窗口。

根据你的电脑操作系统（如 Windows 64 位）选择对应安装包，多数网站会自动适配系统版本。核对无误后，点击页面上的【Git for Windows/x64 Setup.】按钮，即可开始下载。

(2) 安装Node.js和Git

双击 Node.js 安装包，一路【Next】，狂奔到底。该安装包包含让JS在电脑端运行的Node.js，以及管理JS库/工具的npm。

接着双击 Git 安装包，在弹出的【用户帐户控制】窗口中，点击【是】即可。若点击【否】，则会取消本次操作并退出。一路【Next】，狂奔到底。Git是版本控制系统，用来下载 OpenClaw的代码仓库。

2. 开始安装openclaw

打开【开始】菜单：可点击屏幕左下角的Windows图标，或直接按下键盘上的Win 键。

在搜索框中，输入“PowerShell”，搜索到Windows PowerShell。

鼠标右键点击【Windows PowerShell】，选择【以管理员身份运行】；在弹出的【用户帐户控制】窗口中，点击【是】即可。若点击【否】，则会取消本次操作并退出。

在命令行窗口，输入如下命令并按下键盘上的Enter回车键确认。这个命令的作用是：允许计算机运行本地和下载的脚本。

Set-ExecutionPolicy RemoteSigned

当提示是否更改执行策略时，输入字母 y 并按下回车键确认即可。

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

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

接下来，你就可以通过npm命令全局安装openclaw包的最新版本了。如果安装过程中出现失败提示，不用着急，只需重新输入相同的命令再次执行安装即可。下载和安装需要一定时间，需要稍微等待，不要中途退出终端或中断命令执行。

npm install -g openclaw@latest

3. openclaw配置

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

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

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

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

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

按下键盘向下方向键 ↓，选中【MiniMax M2.5（CN）】（该选项为国内大模型 API 接入接口），再按下Enter回车键确认。

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

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

打开Minimax后台https://platform.minimaxi.com/user-center/basic-information/interface-key，点击左边【接口密钥】，接着点击右边的【创建新的API Key】，便会弹出【创建新的密钥】名称的窗口。

输入新密钥名称为“openclaw”（可随意），接着点击【创建密钥】按钮。

先用鼠标左键点击“复制”按钮，再点击【确定】按钮，这两步操作都需要完成。接着回到Windows PowerShell窗口。

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

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

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

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

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

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

系统会自动弹出新的 Windows PowerShell 窗口，该窗口用于启动 OpenClaw 服务。稍等片刻后会出现 Node.js 的权限确认弹窗，在弹窗中选择【允许】。

回到配置窗口，选择【Open the Web UI】并回车确认。

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

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

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

4. 创建飞书机器人

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

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

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

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

为了方便操作，在菜单栏第一个图标左边，打开【展开导航】，接着给应用添加权限。

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

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

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

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

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

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

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

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

5. 配置飞书通讯

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

openclaw config

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

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

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

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

新版本 OpenClaw 已内置支持飞书插件，优先选择本地已有的【Use local plugin path】选项；若未找到该选项，再选择【Download from npm】进行下载安装。

选择【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】（继续），完成配置。

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

openclaw gateway

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

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

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

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

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

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

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

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

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

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

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

看到【当前修改均已发布】或【已发布】提示，即代表应用发布成功；个人账号通常无需审核。

7.  开通“获取通讯录基本信息”权限

点击【权限管理】，接着点击【开通权限】按钮，又来到你熟悉的权限配置窗口。

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

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

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

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

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

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

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

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

openclaw gateway

8. 跟OpenClaw聊会天

在飞书Web后台，点击右上角的【功能】图标。

点击【消息】，即可进入聊天会话窗口。

找到左边【搜索】框，点击之后会弹出搜索窗口。

在搜索框中搜索自己添加的机器人名称（如“openclaw”）搜索机器人，点击下方【openclaw 机器人】，即可打开与 OpenClaw的聊天窗口。

输入你一直想说的话（如：“你是谁，能做什么？”），按下回车键或点击【发送】按钮进行发送。

在聊天窗口中，若出现带有机器人标识（如 “openclaw”）的提示，代表机器人正在思考，请稍作等待。

来了，来了，回答来了，“我是一个AI助手，运行在OpenClaw平台上，我能做很多事情：…”

到这里，你或许以为操作已完成？其实不然，你还可以通过手机指挥 OpenClaw 执行任务。在手机上安装飞书 App，输入计算机操作指令（如 “把桌面上的 安装步骤 文件发给我”），稍等片刻即可收到文件。

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