【2026最新】OpenClaw保姆级安装配置教程-手把手教你在Windows上用 Node.js 22+Git+Kimi模型+飞书机器人去部署你的小龙虾 超详细带图展示详解(Windows 版)
前言介绍
2026年,你的“数字员工”入职指南
- 你是否设想过这样一个场景:在2026年的今天,你的飞书不再仅仅是一个打卡和开会的工具,而是一个拥有“超级大脑”的智能中枢。
- 当你深夜灵感迸发时,它能陪你头脑风暴;当你被繁琐的数据报表淹没时,它能一键生成分析摘要;甚至当你需要管理密码、监控博客更新时,它都能像一位得力的私人助理般默默搞定。
这一切不再是科幻电影里的桥段,而是触手可及的现实。
为什么是OpenClaw?
- 在AI Agent(智能体)爆发的2026年,OpenClaw 无疑是GitHub上最耀眼的明星之一。它被誉为“AI界的npm”,以其极高的可扩展性和本地化部署的隐私安全性,迅速席卷全球开发者社区。
- 不同于普通的聊天机器人,OpenClaw 是一个 “行动式智能体” 。它不仅能陪你聊天,更能通过安装各种 Skills(技能) 来接管你的工作流。它就像一只无所不能的“赛博龙虾”,潜伏在你的电脑后台,随时准备响应你的召唤。
️告别环境混乱,拥抱极致纯净
- 对于开发者而言,部署环境往往是一场噩梦。不同项目依赖不同版本的 Node.js,全局安装导致的版本冲突让人抓狂。
- 本教程将带你从源头解决问题。我们将引入 nvm 这一神器,在 Windows 环境下构建一个隔离、纯净且高效的 Node.js 运行环境(锁定 v22+ 版本)。这不仅能确保 OpenClaw 的稳定运行,更是每一位专业开发者应当掌握的“环境管理艺术”。
连接强大的中文大模型
- 我们将通过 Kimi (Moonshot AI) 的 API 为 OpenClaw 注入灵魂。Kimi 凭借其对长文本的卓越处理能力和中文语境下的精准理解,将成为你机器人的核心大脑。配合飞书强大的生态连接能力,你将拥有一个 24 小时在线、懂业务、能干活的全天候 AI 伙伴。
- 准备好了吗? 接下来的内容,我们将通过保姆级的图文步骤,带你从零开始,亲手搭建这套属于未来的个人 AI 基础设施。让我们开始吧!

一、Node.js 下载安装
这里我建议安装 nvm 去管理你的不同版本的 Node.js
1.1 下载安装nvm
nvm是什么?
- nvm(Node Version Manager)是一个用于管理Node.js版本的命令行工具。
- 它允许开发者在同一台机器上安装和切换多个版本的Node.js,以便于在不同的项目中使用不同的Node.js版本。
- 在工作中,我们可能同时在进行2个或者多个不同的项目开发,每个项目的需求不同,进而不同项目必须依赖不同版本的NodeJS运行环境,这种情况下,对于维护多个版本的node将会是一件非常麻烦的事情。
- nvm就是为解决这个问题而产生的,他可以方便的在同一台设备上进行多个node版本之间切换。
具体安装文章:
【2026 最新】手把手教你彻底卸载 Node.js 用 nvm 管理多版本,告别环境混乱!nvm保姆级安装配置使用教程(Windows版)_卸载node最新版本-ZEEKLOG博客
1.2 安装需要版本的Node.js
具体 Node.js 版本要大于 22
| Node.js | v22.x | v22.10.0+ LTS | 必须是大版本 22 |
1.2.1 检查当前Node.js的版本
当你安装好 nvm 后,win + R 输入 cmd 打开 终端:

输入下述指令可以查看你所有下载安装的的Node.js版本,如图所示前面有星星的是你当前的Node.js版本,我的当前的版本是 22:
nvm ls
1.2.2 没有22版本的看这里下载安装
如果大家没有22版本,按照下述指令来下载安装22版本的Node.js。
nvm install 22
接着使用下述指令切换到当前版本的Node.js:
nvm use 22
查看当前版本:
nvm ls
二、Git 下载安装
具体安装教程看这篇文章:
【2026 最新】下载安装 Git 详细教程 (Windows)_git下载-ZEEKLOG博客
三、OpenClaw 下载安装
点击 Win 在搜索栏搜索 PowerShell,选择用管理员方式运行:

为了避免PowerShell默认策略太严格,导致安装报错,输入下述指令,它允许你在自己的账户下运行自己编写的或在本机创建的脚本,同时阻止未经数字签名的、从互联网下载的脚本运行,从而在便利性和安全性之间取得一个平衡。
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
之后在后面输入 Y,表示同意这一次修改,接着回车:

3.1 开始安装
安装命令:
iwr -useb https://openclaw.ai/install.ps1 | iex安装过程中会跳出是否允许公共网络访问Node.js,这里点击允许即可:


- 等待一段时间,下方出现红色字体 OpenCla 2026 即安装成功。
- 不要关闭当前,紧接着向下翻开始配置OpenClaw!

3.2 开始配置
OpenClaw 默认设计为 “个人专属使用”(即仅你本人操作),这里提示是为了确保你是不是个人用,这里直接点击键盘上的左方向键选择Yes,接着回车确认。



接下来下述直接回车,保持默认的QuickStart模式。

这一步选择 OpenClaw 大模型厂商,用键盘的上下键切换:

如果你有创建过某个服务商的API密钥,可以直接使用,这里我推荐Kimi,因为Kimi会免费送新用户15块钱的额度。
上述终端页面先不要关闭,我们先去配置你需要的AI模型厂商的密钥,如果有密钥的可以跳过 3.3 创建Kimi大模型密钥 这一步。
3.3 创建Kimi大模型密钥
进入Kimi后台进行登录:
Moonshot AI 开放平台 - Kimi K2.5 大模型 API 服务

账户总览可以看到你的账户余额:

创建API key密钥
在 API key 管理页面右上角点击新建 API key:


复制你的密钥,这里一定要妥善管理好你的密钥,不要让别人知道,不然最后烧的就是你的token。

3.4 配置大模型
回到PowerShell,向下选择Kimi模型,接着回车:

这里因为我们是在Kimi网站创建的密钥,所以这里选择.cn后缀的,接着回车。

接着选择现在复制密钥,回车:

将你刚才创建好的密钥粘贴到这里来,然后回车:

接着选择模型,这里我就保持默认的模型 kimi-2.5,然后回车:

这里是要选择你要和OpenClaw对话的方式,因为这里涉及一些后续配置,先跳过。

这一部分是在让你配置“网络搜索”工具,允许你创建的 AI 代理(Agent)具备实时上网搜索信息的能力。如果你是初次尝试,且没有上述搜索引擎的账号,建议直接选择 Skip for now 跳过,先体验本地的基础功能。
后续需要联网搜索时,可以随时重新运行配置向导来添加。这里我选择跳过。

接下来就是选择Skills,就是你的小龙虾需要掌握的技能,如果你有清晰的需求这里可以看看有没有需要配置的,每个技能的后面()内都有各自的应用场景解释。
这里左右键选择Yes,就会进入选择Skills页面:

常见技能:

| 技能名称 | 图标 | 功能描述/用途 |
|---|---|---|
| 1password | 🔐 | 密码管理工具,用于安全存储和检索密码。 |
| blogwatcher | 📰 | 博客监控工具,可能用于跟踪特定博客的更新或内容。 |
| camsnap | 📸 | 摄像头相关工具,可能用于拍照、截图或视频监控。 |
| clawhub | 🧩 | OpenClaw 的官方插件库或社区市场。 |
| eightctl | 🛌 | 智能床(如 Eight Sleep)控制相关。 |
| gemini | ✨ | 与 Google Gemini 模型或相关服务集成的工具。 |
| gifgrep | 🧲 | GIF 图片搜索或处理工具。 |
| github | 🐙 | GitHub 集成工具,用于管理仓库、提交代码、查看 Issues 等。 |
| gog | 🎮 | 可能与 GOG 游戏平台相关,用于管理游戏库或购买记录。 |
| goplaces | 📍 | 地理位置或地图相关工具,可能用于地点查询或导航。 |
| himalaya | 📧 | 电子邮件客户端工具,用于收发和管理邮件。 |
| mcporter | 📦 | 与 Minecraft 服务器管理或数据传输有关。 |
| nano-banana-pro | 🍌 | 是一个特定的轻量级工具或服务。 |
| nano-pdf | 📄 | PDF 文件处理工具,用于阅读、编辑或转换 PDF。 |
| obsidian | 💎 | Obsidian 笔记软件集成工具,用于与你的本地笔记库交互。 |
| openai-whisper | 🎤 | OpenAI 的 Whisper 语音识别模型集成,用于语音转文字。 |
| openhue | 💡 | Philips Hue 智能灯泡控制工具,用于调节灯光颜色、亮度等。 |
| oracle | 🧿 | 与 Oracle 数据库或云服务相关。 |
| ordercli | 🛵 | 订单管理工具,可能用于处理电商订单或物流信息。 |
| sag | 🔊 | 与音频处理或特定服务相关。 |
| songsee | 🌊 | 音乐或音频识别工具,可能用于识别歌曲或处理音频文件。 |
| sonoscli | 🔊 | Sonos 智能音响控制工具,用于播放音乐、调节音量等。 |
如果没有需要配置的Skills,直接上键选择Skip for now 接着 空格 + 回车 即可。

接着会让你选择配置一系列密钥,如果你都没有配置的话,直接选择No,回车即可,我这里全选的No。
| 对应的 API Key | 服务/功能说明 | 建议操作 |
|---|---|---|
GOOGLE_PLACES_API_KEY | 谷歌地点服务,用于查询地点、地图信息等。 | 若无谷歌云账号,选 No。 |
GEMINI_API_KEY | Google Gemini 模型服务,用于调用 Gemini 生成内容。 | 若无 Google AI Studio 账号,选 No。 |
NOTION_API_KEY | Notion 笔记服务,用于读写 Notion 数据库/页面。 | 若无 Notion 集成令牌,选 No。 |
OPENAI_API_KEY | OpenAI 图像生成服务(如 DALL·E),用于生成图片。 | 若无 OpenAI 账号,选 No。 |
OPENAI_API_KEY | OpenAI 语音识别服务(Whisper),用于语音转文字。 | 若无 OpenAI 账号,选 No。 |
ELEVENLABS_API_KEY | ElevenLabs 语音合成服务,用于生成自然语音。 | 若无 ElevenLabs 账号,选 No。 |

“自动化钩子(Hooks)”是一种自动化规则。它允许你设定:当 AI 代理执行某些特定指令(如 /new、/reset)时,自动触发一些预设的动作。这里我们也可以,直接选择Skip for now 接着 空格 + 回车跳过即可。

接着程序会自启动网关,我们可以看到一个命令窗口被自动打开了,这个窗口先不要关它!

等待一会回到之前的PowerShell窗口,这里会提示你再哪里启动打开小龙虾,这里我推荐使用Web UI 网页图形页面,更加直观好操作。

上述回车后,会自动打开网页,在这里我们就可以和我们的小龙虾对话了。

四、将OpenClaw和飞书连接
4.1 创建飞书机器人
官网:飞书开放平台
点击右上角的登录按钮,进行登录:

登录成功后点击后上角的开发者后台:

点击创建企业自建应用:

填写你的应用名称和应用描述:

添加机器人功能:


点击左侧权限管理里面页面里面的开通权限:

右侧输入框内输入下述:
im:全选当前权限,点击确认开通权限:

接着点击上面黄色方框内的创建版本:

填写相关内容后,向下翻点击保存即可。



4.2 连接飞书机器人
回到 PowerShell 输入:
openclaw config回车,再次进行配置:

选择 Local 本地运行,回车:

选择 Channels 配置通讯方式,回车:

选择 Configure/link,添加新的消息渠道,回车:

一路向下找到飞书,选择回车:

这里需要安装飞书插件,直接回车即可:

等待一会安装成功后,我们需要 飞书应用的App Secret,点击 Enter App Secret (Stores the credential directly in OpenClaw config),接着回车:

我们来到飞书开发者后台:
点击左侧的凭证与基础信息,复制右侧的App Secret:
凭证与基础信息 - OpenClaw【Windows】 - 开发者后台

然后粘贴密钥,回车:

复制App ID,粘贴然后回车:


选择| WebSocket (default) 通讯方式,回车:

我们是在国内飞书创建的,直接回车:

这里选择是否允许在群聊里使用机器人,这里选择第二个Open - respond in all groups (requires mention),意思为所有群里都可以使用机器人,但是必须@机器人。
,

接着向下翻,选择Finished完成配置:

然后这一步询问要不要现在配置私聊访问策略,也就是谁可以在飞书私聊里用OpenClaw机器人,我们选择Yes,然后回车:

- 如果只是自己测试使用,策略可以先选择Open;
- 如果是正式环境,建议选择Pairing;
我这里选择Open,然后回车:

- Pairing (recommended) — 配对模式(推荐)
- 含义:这是最安全的模式。只有在你主动添加该用户为好友(即完成配对)后,AI 才会响应他们的私信。
- 适用场景:个人使用或小范围团队内部使用。你只想和信任的人交流。
- Allowlist (specific users only) — 白名单模式(仅限特定用户)
- 含义:只有在你预先设置的“白名单”里的用户,才能发送私信给 AI。其他用户的消息会被忽略。
- 适用场景:你需要严格控制谁能与 AI 交流,比如只允许特定的管理员或团队成员操作。
- Open (public inbound DMs) — 开放模式(公开接收)
- 含义:任何人都可以通过飞书搜索到你的机器人并发送私信,AI 都会回复。
- 适用场景:公开的服务号、客服机器人或公开问答机器人。但要注意,这可能会收到垃圾信息或骚扰。
- Disabled (ignore DMs) — 禁用模式(忽略私信)
- 含义:AI 完全不会处理任何私信消息,即使有人发消息过来也不会回复。
- 适用场景:你只打算通过群组(Groups)或其他渠道使用 AI,不打算在私信里和它交互。
选择最后的continue,回车,这样你就配置好了你的OpenClaw:


接着在 PowerShell 输入
openclaw gateway进行回车:
如果出现下述报错,无需理会是因为你的OpenClaw 网关已经在运行了(进程 ID 为 29076),因此无法再次启动。

PS C:\WINDOWS\system32> openclaw gateway
🦞 OpenClaw 2026.3.13 (61d171a)
Eid al-Fitr: Celebration mode: queues cleared, tasks completed, and good vibes committed to main with clean history.
20:17:29 [plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: feishu (F:\Chengxusheji\Nvm\nvm\node_cache\node_modules\openclaw\extensions\feishu\index.ts). Set plugins.allow to explicit trusted ids.
20:17:35 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
20:17:35 [plugins] feishu_chat: Registered feishu_chat tool
20:17:35 [plugins] feishu_wiki: Registered feishu_wiki tool
20:17:35 [plugins] feishu_drive: Registered feishu_drive tool
20:17:35 [plugins] feishu_bitable: Registered bitable tools
20:17:35 Gateway failed to start: gateway already running (pid 29076); lock timeout after 5000ms
If the gateway is supervised, stop it with: openclaw gateway stop
20:17:35 Gateway service appears registered. Stop it first.
20:17:35 Tip: openclaw gateway stop
20:17:35 Or: schtasks /End /TN "OpenClaw Gateway"
PS C:\WINDOWS\system32>
然后再飞书自建应用界面,点击左侧的事件与回调,修改订阅方式:

选择长连接保存:

保存成功后点击右下角的添加事件:

搜索接受消息,勾选之后选择添加:

回到权限管理,点击开通权限:

搜索通讯录,将获取通讯录基本信息勾选上,点击确认:

要想要生效需要再次点击上方的创建版本:

输入信息后,下滑下方后点击保存:


发布成功后即可配置成功。
五、测试对话
打开手机版飞书APP:

打开应用

这样就可以和你的小龙虾OpenClaw对话啦!

六、常见问题
6.1 问题一:飞书应用未显示
如果App开发者小助手里面内没有打开应用显示,说明没有配置好机器人,建议检查4.1 创建飞书机器人这一步。
6.2 问题二:OpenClaw回复无响应
如果在询问你的小龙虾没有回复,建议检查你是否打开小龙虾网关,又没有下述页面:

如果没有建议在PowerShell管理员运行模式下输入下述命令关闭重启打开:
openclaw gateway stop openclaw gateway restart七、关闭暂停OpenClaw
7.1 只是关闭暂停
当你不想去使用你的OpenClaw,想要关闭暂停它,可以在终端输入下述指令然后回车:
- 打开终端(Terminal 或 CMD/PowerShell)。
- 输入以下命令并回车:
openclaw gateway stop- 效果:这会停止后台的 LaunchAgent 或系统服务,Web 界面和聊天功能将暂时无法使用。
- 补充:如果你想重启它,可以使用
openclaw gateway restart。
| 场景分类 | 适用情况 | 操作目的 |
|---|---|---|
| 1. 临时释放电脑资源 | 需要运行大型游戏、渲染视频,或感觉电脑变卡时 | 释放被占用的内存和 CPU,让电脑运行更流畅,忙完后可随时启动 |
| 2. 暂时不需要 AI 响应 | 周末/假期休息,或开会/专注工作时,不想被打扰 | 切断 AI 的“耳朵”和“嘴巴”,使其进入“冬眠”状态,不再响应指令但保留配置 |
| 3. 修改配置前的准备 | 需要更换 API Key、修改模型参数或调整技能包时 | 防止修改文件时后台程序仍在读取旧配置,导致冲突或修改不生效 |
| 4. 排查故障(重启大法) | AI 反应迟钝、不回复消息、报错或似乎“卡死”时 | 相当于给 AI 做一次“重启”,通常能解决大部分连接或运行的小毛病 |
7.2 如何彻底关闭“开机自启”?
1.打开任务计划程序,同时按下键盘上的Win+R键

2.在弹出的运行窗口中输入“taskschd.msc”,然后点击左下方的“确定”

3.在任务计划程序中,选中左侧“任务计划程序”文件夹,在右边下拉对话框中找到“Openclaw Gateway”的名称,右键点击“禁用”(如果确定永久不启用可以选择“删除”)。

该种方法同样适用于安装了Claude code后遇到开机自启动问题的情况,只要在同样的位置上把对应的claude Code Gateway禁用即可。
八、彻底卸载OpenClaw
1. 打开终端(Terminal)
- Windows 用户:按
Win + R键,输入cmd,按回车(或者在开始菜单搜索“命令提示符”或“PowerShell”)。 - Mac 用户:按
Command + 空格,输入Terminal或“终端”,按回车。
2. 执行核心卸载命令
在终端窗口中,复制并粘贴以下命令,然后按回车键:
openclaw uninstall --all --yes- 命令解释:
uninstall:告诉程序执行卸载。--all:彻底删除模式,包括网关服务、本地数据库、配置文件等所有数据。--yes:全程自动确认,不需要你手动输入Y确认。
3. 删除命令行工具(CLI)
执行完上一步后,OpenClaw 的主体已经删除了,但可能还剩下一个“外壳”(命令行工具)。为了彻底清除,请继续执行以下命令:
npm uninstall -g openclaw(如果你当初是用 pnpm 或 bun 安装的,请将 npm 替换为 pnpm remove -g 或 bun remove -g)。