【OpenClaw】Windows 安装OpenClaw
OpenClaw系统要求
在开始动手部署之前,我们得先看看手头的“装备”是否齐全。OpenClaw对运行环境有明确的要求,提前准备好,能帮你避开不少后续的麻烦。
核心依赖是Node.js 22+。如果你的系统上还没安装,别担心,安装脚本通常很智能,会帮你自动搞定这一步。当然,手动先装好也行,看个人习惯。
至于操作系统,选择面很广:无论是macOS、Linux,还是Windows,OpenClaw都能跑起来。不过话说回来,如果你用的是Windows系统,强烈建议在WSL2(Windows Subsystem for Linux)环境下运行。这并非强制性要求,但却是无数前人经验换来的最佳实践,能让你的安装和后续使用过程顺利得多。
最后是pnpm这个包管理器。它并非运行OpenClaw的必需品,但如果你后续打算从源码构建项目,那就得用到它了。这里先提一嘴,有个印象就好。
安装步骤详解
第一步:获取并运行安装脚本
安装过程的起点,是一条命令行指令。打开你的终端,根据系统直接执行对应的命令即可。
如果你希望安装完成后,直接进入那个贴心的引导配置向导,可以执行这条PowerShell命令:
iwr -useb https://openclaw.ai/install.ps1 | iex
当然,有些朋友喜欢先装好软件,再慢慢配置。如果你想“只安装,不向导”,那么下面这条命令更适合你:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
命令执行后,你会看到类似下图的安装进程,这意味着一切正在按部就班地进行。
第二步:启动引导配置向导
假设你选择了直接进入向导,那么有趣的互动环节就开始了。整个过程其实就是跟着提示,一步步做出选择。
首先,系统会询问你是否知晓相关风险。这是个标准的安全提示,直接选择 yes 即可进入下一步。
第三步:配置模式选择
紧接着,你会面临第一个重要选择:配置模式。为了快速上手,这里建议直接选择 QuickStart(快速开始)模式。它能帮你用最少的配置,先把核心服务跑起来。
第四步:选择模型服务商
OpenClaw的强大之处在于能连接多种大模型。在服务商选择界面,我们以 Qwen(通义千问)为例进行配置。
选择千问模型后,屏幕上会弹出一个授权链接。你需要完整复制这个链接,然后粘贴到浏览器的地址栏中打开。
第五步:完成模型授权
在浏览器中打开链接后,你会跳转到千问的官方授权页面。按照提示登录你的账户,并完成授权操作。
授权完成后,回到命令行终端。向导会列出所有可用的千问模型,对于初学者,直接选择默认推荐的模型就是最稳妥的方案。
确认模型后,你会看到成功的反馈信息,这意味着模型通道已经成功建立。
第六步:配置Channel与Skills
接下来是配置Channel(渠道)。Channel可以理解为你与AI交互的特定方式或平台接口。初次安装时,事情可以简单点:直接选择 Skip for now,以后再根据需求添加也不迟。
然后是Skills(技能)配置。Skills是一些预定义的、增强AI能力的模块。同样,在快速开始的阶段,我们先选择 No,跳过这部分。
第七步:配置Hooks与完成安装
最后是Hooks(钩子)配置。Hooks允许你在AI处理的特定节点注入自定义逻辑。使用键盘的空格键选中 Skip for now 选项,然后按回车确认。
一路“跳过”下来,是不是感觉轻松了不少?恭喜你,核心配置已经完成了!向导最后会给出一个总结界面。
按回车确认后,系统会开始拉取必要的Docker镜像并启动所有服务。这个过程可能需要几分钟,请耐心等待,你会看到一系列服务启动成功的日志。
当最终看到“Setup completed successfully!”的提示时,就大功告成了。终端会清晰地告诉你如何访问OpenClaw的Web管理界面。
安装后检查与服务管理
安装完成后,第一件事就是检查服务状态。在终端输入以下命令:
openclaw status
这个命令会清晰地列出所有核心服务(如API服务器、模型网关等)的运行状态,让你一目了然。
常见问题排解:未授权状态
如果你在访问Web界面时遇到“未授权”的错误,别慌。通常是因为浏览器会话问题。最直接的解决办法是回到服务器,输入这条命令:
openclaw dashboard
这个命令会直接输出或重新激活Web控制台的访问地址和令牌,帮你快速重新登录。
参考资料
如果在安装过程中想深入了解细节,官方文档永远是最好的朋友:
安装指南:https://docs.openclaw.ai/install
入门教程:https://docs.openclaw.ai/start/getting-started















