保姆级教程 | Windows 11系统本地部署 OpenClaw 并接入飞书

OpenClaw 在国内被称为“龙虾”，既因产品图标是“龙虾”，更因其“动手干活”的核心能力。与传统只能问答互动的AI不同，OpenClaw 最大的特点是能真正动手执行任务，将其部署在电脑上，就可以代替主人操作各种程序完成工作，真正实现了从“动口”到“动手”的质变。例如，我在手机飞书APP上给它发条消息，让它帮忙在电脑D盘上创建一个文件，演示如下。

●OpenClaw 官方网站：https://openclaw.ai
●OpenClaw 项目地址：https://github.com/openclaw/openclaw

虽然最近 OpenClaw 热度很高，但官方对 Windows 原生环境并不算友好，很多人会卡在 Node 环境、权限、插件安装等问题上。下面，十一张（www.11zhang.com）站长把自己完整跑通的流程整理成一篇保姆级教程，手把手带你在 Windows 11系统上完成 OpenClaw 部署并接入飞书机器人。

Windows 系统环境与硬件要求

✅系统：Windows 10 21H2及以上、Windows 11（必须支持WSL2，官方原生推荐WSL2运行，兼容性最好）。
✅硬件：内存≥8GB（推荐16GB，本地跑模型更流畅）；硬盘剩余空间≥20GB；CPU支持虚拟化（BIOS里开启，默认大多是开启的）。
✅网络：能正常访问GitHub、npm官方源。不用特殊工具，普通网络即可。

OpenClaw 安装教程

1、安装 Node.js

虽然 OpenClaw 官方文档不要求提前安装 Node.js，但是先把这一步做完可以避开很多坑。先用浏览器打开下方的 Node.js 官方下载页面，点击“Windows 安装程序”按钮下载安装包，如下图。

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

打开下载好的安装包，先点击“Next”按钮，安装位置可默认或修改，后续可以一路无脑点击“Next”按钮进行安装。

安装完成后点击“Finish”按钮，如下图。

看到下图后，按任意键继续，需要等待一段时间进行自动配置。

当看到下图表示配置完成。

安装完成后，可以同时按 [Win+R] 快捷键打开运行界面，然后运行界面上输入 cmd 命令回车打开，输入 node -v 命令，如果显示版本号就说明 Node 安装成功，如下图。

# 验证 Node.js 版本
node -v

# 验证 npm 版本
npm -v

2、安装 Git

Git 并不是必备安装项，但很多人后面遇到的一些报错，本质上都和 Git 配置有关，所以也可以提前避坑。同样用浏览器打开下方的 Git 官方下载页面，根据电脑架构选择对应下载链接，如下图。

https://git-scm.com/install/windows

打开下载好的安装包，先点击“Next”按钮，部分重要的截图如下。

最后点击“Install”开始安装，非专业开发者后面可以一路无脑点击“Next”按钮，如下图。

完成后取消勾选“View Release Note”，然后点击“Finish”，如下图。

安装完成后，可以同时按 [Win+R] 快捷键打开运行界面，然后运行界面上输入 cmd 命令回车打开，输入 git --version 命令，如果显示版本号就说明 Git 安装成功，如下图。

git --version

在菜单栏中搜索“PowerShell”，选择“以管理员身份运行”，然后输入以下2条命令，如下图。

Set-ExecutionPolicy RemoteSigned
npm install -g npm@11.11.0

3、安装 OpenClaw

以管理员身份运行 Powershell，然后输入以下 OpenClaw 官网 Windows 安装命令并回车执行，看到 OpenClaw 欢迎信息即表示安装成功，如下图。

iwr -useb https://openclaw.ai/install.ps1 | iex

4、配置 OpenClaw

出现风险提示时，按左方向键选择“Yes”并回车，如下图。

入门模式选择：Quickstart（快速启动），按回车继续，如下图。

需要选择 OpenClaw 背后的大模型服务商，比如 OpenAI、智谱、Moonshot AI 等等，这个可以根据个人偏好进行选择，通过键盘的上下方向键切换。如果你已经创建过某个服务商的 API 密钥，可以直接使用，而我会选择 Z.AI（即智谱 AI）模型，并不是广告，而是因为智谱会免费赠送新用户 2000万 Tokens 额度体验包（点击下方链接注册即可）。

PS：站长这里顺便教一下大家如何创建大模型 API 密钥，以 智谱 模型为例，操作步骤如下：

Z.AI 是智谱的国际站，bigmodel.cn 是智谱的国内站，这里我们用国内站，即：CN，如下图。

选择 Paste API Key now，然后黏贴智谱 API Key，如下图。

默认选择最新模型即可，如下图。

接下来选择通讯渠道，也就是要通过 Telegram、Discord、飞书之类的工具和小龙虾（OpenClaw）对话。我们先选择 Skip for now，如下图，也就是先跳过，因为涉及到一些准备步骤，后面我们再来进行配置。

继续选择 Skip for now 跳过，如下图。

然后问要不要现在配置 Skills，也就是小龙虾掌握的技能，我们可以选择 Yes 打开看一下，如下图。

如果你有比较清晰的目的了，这里可以看看有没有需要配置的，每个技能后面的括号里，都有写出来应用的场景，这个也可以留到后面进行配置。我们按空格选择 Skip for now，然后回车，如下图。

接下来会出现一系列问题，问我们要不要配好各种服务的 API 密钥，比如 Nano Banana 的密钥，可以用来生成图片。如果你还没有创建好的密钥，也可以先都选 No，回头有需要再进行填写。然后会问我们要不要启用 hook（指的是在某个事件发生时自动执行某个功能），我们目前也可以先跳过，空格选择 Skip for now 然后回车，如下图。

程序会启用网关，我们会看到有个命令窗口被自动打开了，如下图，这个窗口先不要去关它。

等待一段时间，回到之前的 PowerShell 窗口，它会问我们想用什么方式启动小龙虾。我们可以选用 Open the Web UI，网页图形界面会更加直观和操作友好一些，回车后会出现提示说有网页自动被打开，如下图。

会进入 http://127.0.0.1:18789 这个网页，在聊天界面我们就可以开始和自己的小龙虾对话了，如果你能收到来自小龙虾的回复说明，我们的配置也已经完成了，如下图。

但小龙虾之所以出圈，其中一个原因是它可以接入各种通讯软件。接入后，我们只需要在手机上发一条消息，它就能在电脑上自动开始干活，所以我们接下来要做的是把 OpenClaw 和飞书连接起来。

5、创建飞书机器人

打开飞书开放平台，先点击右上角登录（如果没有账号可以注册一个个人账号，不需要加入任何企业），登录完成后点击“开发者后台”，然后再点击“创建企业自建应用”，如下图。

https://open.feishu.cn

给应用起一个名字，填写对应的描述，图标也可以自定义，最后点击“创建”，如下图。

点击左侧的“添加应用能力”，先添加“机器人”能力，如下图。

点击左侧的“权限管理”，给机器人开通权限，在搜索框里输入“im:”，把出现的这些消息相关权限先都加上，再点击“确认开通权限”，如下图。

上方会有个提示，应用发布后，当前的修改才会生效，我们点击“创建版本”，输入版本号（比如 1.0.0）及更新说明，最后点击“保存”并“确认发布”，如下图。

现在我们的飞书机器人就创建好了，但还需要连接 OpenClaw 和飞书。

6、连接 OpenClaw 和飞书

回到 PowerShell，我们输入 openclaw config 命令再次进行配置，如下图。

openclaw config

第1个问题，先选择 “Local（即 本机运行）”，如下图。

配置选择 Channels，也就是通讯渠道，如下图。

回车后选择 Configure/link 添加渠道，如下图。

找到 Feishu/Lark（飞书）后回车，如下图。

要在飞书上运行，还需要安装飞书渠道插件，选择 Download from npm 回车通过 npm 来安装飞书渠道插件，如下图。

选择 Enter App Secret 回车输入飞书应用的 App Secret 和 App ID（我们可以从飞书开发者后台“凭证与基础信息”获取），如下图。

飞书和 OpenClaw 的通信方式选择默认的 WebSocket（实时通讯），如下图。

由于我们的机器人应用是国内版的飞书，也就是 feishu.cn 这个域名创建的，所以选择 China 这个国内版飞书，如下图。

群聊权限选择 Open（需 @机器人 使用），如下图。

最后点击 Finished 完成配置，如下图。

私聊访问策略选择 Yes，也就是谁都可以在飞书私聊里用 OpenClaw 机器人，如下图。

如果只是测试使用，可以选择 Open（表示任何人都可以私聊机器人），这样不需要任何配置。但是，如果是正式环境，建议选 Pairing，如下图。

最后选择 Continue，这样我们就完成了飞书通讯渠道的配置，如下图。

接下来在 PowerShell 窗口输入 openclaw gateway 命令启用网关，如下图。

openclaw gateway

然后在飞书开发者后台“事件与回调”中选择“长连接”并保存，如下图。

点击“添加事件”接收消息，搜索“接收”勾选上【接收消息】，如下图。

回到“权限管理”，点击“开通权限”，如下图。

搜索“通讯录”勾选【获取通讯录基本信息】权限，如下图。

要让上面的修改生效，我们需要再次“创建版本”并发布，这是给机器人添加消息接收能力，如下图。

到这里，飞书机器人的配置到目前就完成了，虽然过程很漫长和琐碎，但现在我们就可以尝试在飞书上和小龙虾（OpenClaw）进行对话了。

7、测试对话

在飞书 APP 消息列表里找到自建应用的入口，点击“打开应用”，如下图。

随便输入一条消息，可以看到 OpenClaw 回复了一个表情，表示自己正在输入，等待几秒后就能收到它的消息了。我们可以继续和它私聊对话或拉进群聊 @机器人使用。如果想让它变得更强，也可以给它配置更多的 Skills，拓展它能完成的任务，建议只安装官方或可信来源的 Skills，避免带来安全风险。

您学废了吗？本文所提到的所有软件，下载地址：

https://pan.quark.cn/s/f2a6974b172c
https://pan.baidu.com/s/1mvnK4Z1LJAyN8TSJco5Xlg?pwd=1140
https://pan.xunlei.com/s/VOnV9NtBGw8pVR8Psf4yMi2kA1?pwd=e7gx
https://www.123865.com/s/q7CRVv-n9fHd
https://url57.ctfile.com/d/16898257-161579399-608091?p=1140

知识拓展

1、常用命令速查表

命令	功能
openclaw onboard	初始化配置向导
openclaw gateway	启动 OpenClaw 服务（Gateway）
openclaw gateway stop	停止 OpenClaw 服务
openclaw gateway restart	重启 OpenClaw 服务
openclaw tui	打开终端对话界面
openclaw dashboard	打开网页版控制台
openclaw dashboard --no--open	启动控制台但不自动打开浏览器
openclaw channels login	重新登录聊天通道
openclaw channels logout	退出聊天通道
openclaw config	进入配置菜单
openclaw config list	查看配置
openclaw status	查看 OpenClaw 状态
openclaw --help	查看 OpenClaw 帮助
notepad ~/.openclaw/policies/default.json	查看策略文件
dir ~/.openclaw/extensions	查看已安装的插件
cat ~/.openclaw/openclaw.json	查看配置文件

2、OpenClaw 中文社区

网址：https://clawd.org.cn

这是一个专门为国内用户提供 OpenClaw 开源AI助手本地化部署与中文支持的社区网站，旨在解决原版项目在国内网络环境下的“水土不服”问题。