【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)。
