2026年Windows 环境下 OpenClaw 完全部署与配置教程

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

March 9, 2026 By Henry

macOS 安装教程点我 OpenClaw 是近期备受关注的开源 AI Agent 工具，但官方对 Windows 的原生生态支持相对有限。在实际部署过程中，经常会遇到关于 Node.js 环境、执行策略设限和依赖下载的问题。

本文将结合实际安装记录以及社区的解决方案，提供一份详尽的 Windows 端安装、配置直至接入工具及大模型的完整流程。

由于 OpenClaw 对 Node.js 版本有要求，为避免后续权限和全局变量导致的问题，强烈建议使用 nvm（Node Version Manager）来进行环境管理。

⚠️ 强烈注意：在安装 nvm 之前，如果你的电脑上已经安装过 Node.js，请严格卸载旧版本！ 包括清理掉全局模块和环境变量（如等），否则安装 nvm 后可能会导致极其混乱的路径冲突。

前往 GitHub Releases 页面下载最新的：nvm-windows releases

安装过程保持默认并一路 Next 即可。

安装成功后，请使用管理员身份打开 PowerShell，执行验证安装。

在 管理员 PowerShell 中，执行以下命令安装并指定使用 Node.js 22.22.0 版本：

安装并启用成功后，终端会打印类似的系统提示。

在已开启的管理员 PowerShell 中，执行官方提供的一键安装脚本：

报错 A：执行策略受限 在执行上述命令时，遇到如下红色报错：

原因：PowerShell 默认执行策略限制了未经签名的脚本执行。 解决方法：在终端输入以下命令提升当前用户的执行权限，并在系统询问时输入确认：

提升权限后，重新执行前面的安装命令。

报错 B：安装卡死或极度缓慢 如果控制台显示后长时间无响应。 解决方法：按中断当前进程，将 npm 源修改为国内镜像后再次安装：

安装成功后，通常会自动进入配置流程。如果不小心关闭了终端，可重新打开后执行：

在连续的风险提示与初始询问中：

后续配置项建议按需简化（可使用最小化跑通再深层配置）：

下面以 MiniMax 为例获取 API Key：

Select Channel/Search Provider/Skills：官方建议 Windows 原生最好通过 WSL2 运行飞书等 IM 插件，因此在此步骤的连接频段建议先，后续单独安装管理。

Hooks：全部勾选。上下箭头选择，空格选中/取消选中，回车提交。
Hatch your bot：选择，将启动网关服务并在浏览器弹出控制台页面。控制台启动完成并可发消息回复，即代表基础运行成功。(注：目前 Web UI 界面仍处于早期阶段，体验还不是很完善。对于熟悉命令行的用户，强烈推荐使用命令行交互，后续可通过终端输入进入。)

如果在初始化向导中跳过了模型配置，或者后续需要额外接入其他 AI 模型（如 DeepSeek、豆包等），可以通过命令行进行配置：

选择→

随后选择自己的提供商。如果没有则选择。随后同上方初始化配置处所提的相同方式配置。

如果需要在聊天过程中临时切换不同的 AI 模型，可以在终端使用 TUI（文本用户界面）进行操作：

由于初始化向导在 Windows 可能报错缺失路径，请在 PowerShell 中直接调用 CLI 执行：

访问飞书开放平台创建应用，开启机器人功能，并获取 App ID 与 App Secret，在 OpenClaw 设置对应项时输入。

事件订阅：在“事件与回调”内，订阅方式改为 使用长连接接收事件，并点击添加事件。 (注：若开启长连接提示失败，请确认 openclaw gateway 在后台正常 running，或者等待几分钟后重试保存)

一切配置就绪后，在飞书开发者“版本管理与发布”中提交版本。随后在飞书中直接搜索该机器人发起对话。此时它回复的一串 配对码 (Pairing Code) 即为鉴权依据，将其输入 OpenClaw（或中的飞书卡片绑定栏）即可完成双向绑定。

如果在后续配置、开发途中遭遇服务状态异常卡死，下列终端命令将非常高效：

完整文档：https://docs.openclaw.ai

整个配置与连通流程到此全部走通。

—— GeekPie 社团，2026 年 3 月 9 日