【2026最新】OpenClaw保姆级安装配置教程-手把手教你在Windows上用 Node.js 22+Git+Kimi模型+飞书机器人去部署你的小龙虾 超详细带图展示详解(Windows 版)

【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.jsv22.xv22.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_KEYGoogle Gemini 模型服务,用于调用 Gemini 生成内容。若无 Google AI Studio 账号,选 No
NOTION_API_KEYNotion 笔记服务,用于读写 Notion 数据库/页面。若无 Notion 集成令牌,选 No
OPENAI_API_KEYOpenAI 图像生成服务(如 DALL·E),用于生成图片。若无 OpenAI 账号,选 No
OPENAI_API_KEYOpenAI 语音识别服务(Whisper),用于语音转文字。若无 OpenAI 账号,选 No
ELEVENLABS_API_KEYElevenLabs 语音合成服务,用于生成自然语音。若无 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,然后回车:

  1. Pairing (recommended) — 配对模式(推荐)
    • 含义:这是最安全的模式。只有在你主动添加该用户为好友(即完成配对)后,AI 才会响应他们的私信。
    • 适用场景:个人使用或小范围团队内部使用。你只想和信任的人交流。
  2. Allowlist (specific users only) — 白名单模式(仅限特定用户)
    • 含义:只有在你预先设置的“白名单”里的用户,才能发送私信给 AI。其他用户的消息会被忽略。
    • 适用场景:你需要严格控制谁能与 AI 交流,比如只允许特定的管理员或团队成员操作。
  3. Open (public inbound DMs) — 开放模式(公开接收)
    • 含义:任何人都可以通过飞书搜索到你的机器人并发送私信,AI 都会回复。
    • 适用场景:公开的服务号、客服机器人或公开问答机器人。但要注意,这可能会收到垃圾信息或骚扰。
  4. 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,想要关闭暂停它,可以在终端输入下述指令然后回车:

    1. 打开终端(Terminal 或 CMD/PowerShell)。
    2. 输入以下命令并回车:
    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)

    Read more

    GLM-4-9B开源:7大测评碾压Llama-3-8B的AI神器

    GLM-4-9B开源:7大测评碾压Llama-3-8B的AI神器 【免费下载链接】glm-4-9b 项目地址: https://ai.gitcode.com/zai-org/glm-4-9b 智谱AI正式发布GLM-4系列开源版本GLM-4-9B,在多维度测评中全面超越Meta的Llama-3-8B,标志着国产大模型在开源领域实现重要突破。 行业现状:开源大模型进入性能比拼新阶段 2024年以来,大模型领域呈现"闭源争霸,开源突围"的竞争格局。Meta的Llama-3系列凭借8B和70B两个版本掀起开源热潮,而国内厂商正加速布局中高端开源模型市场。GLM-4-9B的推出,不仅是智谱AI继ChatGLM3后的又一力作,更通过实测数据证明国产开源模型已具备与国际主流模型同台竞技的实力。当前,90亿参数级别正成为企业级应用的黄金平衡点,既保证性能又兼顾部署成本,成为行业落地的优先选择。 核心亮点:全维度超越的"七项全能"模型 GLM-4-9B在学术测评与功能扩展两方面展现出显著优势。在MMLU(多任务语言理解)测评中,以74.7分超越Llama-3-8B-Instruct的6

    By Ne0inhk

    PFRL源码探秘:从Q函数到策略网络的底层实现原理

    PFRL源码探秘:从Q函数到策略网络的底层实现原理 【免费下载链接】pfrlPFRL: a PyTorch-based deep reinforcement learning library 项目地址: https://gitcode.com/gh_mirrors/pf/pfrl PFRL是一个基于PyTorch的深度强化学习库,提供了从Q函数到策略网络的完整实现,帮助开发者快速构建和训练强化学习智能体。本文将深入探索PFRL的核心模块实现原理,揭示深度强化学习算法的底层运作机制。 一、Q函数架构:价值估计的核心实现 Q函数作为值函数近似的核心组件,在PFRL中有着丰富的实现。从基础的DQN到复杂的决斗网络(Dueling DQN),PFRL提供了多种Q函数架构以适应不同的问题场景。 1.1 基础Q函数实现 PFRL在pfrl/q_functions/state_q_functions.py中实现了基础的状态Q函数。其中SingleModelStateQFunctionWithDiscreteAction类是离散动作空间Q函数的基类,通过前向传播方法计算状态价值: cl

    By Ne0inhk
    Spec-Kit+Copilot打造AI规格驱动开发

    Spec-Kit+Copilot打造AI规格驱动开发

    作者:算力魔方创始人/英特尔创新大使 刘力 一,什么是Spec-Kit? 在传统的软件开发中,通常先有需求→ 写规格 → 再写代码;规格多数是“指导性文档”,而真正的业务逻辑和边界由程序员“翻译”出来。Spec-Driven Development(规格驱动开发)的理念是,将规格(spec)从“仅供参考”提升为可执行、可驱动的核心工件,直接引导后续设计、计划、任务拆解、实现等流程。spec-kit 是 GitHub 提供的一个工具集 / CLI / 模板库,用来在项目中落地这种流程! Github: https://github.com/github/spec-kit 二,搭建运行环境 本节将指导您从零开发搭建Spec-Kit的运行环境。 第一步:在Ubuntu24.04上安装uv: curl -LsSf

    By Ne0inhk
    【源力觉醒 创作者计划】开源、易用、强中文:文心一言4.5或是 普通人/非AI程序员 的第一款中文AI?

    【源力觉醒 创作者计划】开源、易用、强中文:文心一言4.5或是 普通人/非AI程序员 的第一款中文AI?

    前言 * 你有没有发现,AI 正在悄悄渗透进我们的生活:写文案、画插图、做PPT、答作业,它几乎无所不能😍 !但很多人可能会问: AI,我能用吗?用得起吗?适合我吗?特别是中文用户,面对清一色英文界面、动辄上百元的 API 费用、还要“翻墙”的闭源大模型,常常望而却步😩。 * 好消息来了,文心一言4.5 正式开源,带着「能跑、好用、懂中文」的标签亮相😎。这不仅是一款中文大模型,更像是为中文用户量身定做的一把 AI 钥匙,让你在本地就能打开 AI 世界的大门!在这个“不会用 AI 就像不会用手机”的时代,早点上手,早点受益。 * 一起来轻松玩转文心大模型吧👉一文心大模型免费下载地址: https://ai.

    By Ne0inhk