Windows系统安装OpenClawAI详细教程与步骤指南

在Windows系统上部署OpenClaw，过程其实相当直接。真正的诀窍在于，提前避开几个新手最容易“踩坑”的地方：安全软件的误拦截、安装路径包含中文字符，以及权限不足。只要把这几点处理好，通常五分钟内就能看到控制台亮起“Gateway在线”的绿灯。

安装前必须做的三件事

准备工作做得好，安装过程没烦恼。下面这三件事，务必在动手前完成：

• 暂时关闭安全防护：包括Windows Defender的实时保护，以及任何第三方安全软件，如火绒、360或腾讯电脑管家。它们可能会将工具的核心文件误判为威胁而直接删除。
• 获取管理员权限：无论是后续使用PowerShell还是运行安装程序，都必须右键选择“以管理员身份运行”，否则会因权限不足导致失败。
• 规划纯英文路径：安装目标文件夹的路径必须全部由英文字母、数字和下划线组成，不能包含中文、空格或特殊符号。例如，D:\OpenClaw是理想选择，而像D:\我的AI工具或C:\Program Files\OpenClaw这类路径则必然会导致问题。

两种主流安装方式怎么选

根据你的技术偏好，可以选择不同的入门路径：

追求效率的新手，推荐一键安装包：这是最省心的方式。下载压缩包后，用WinRAR或7-Zip解压，直接双击启动程序。遇到系统提示时点击“仍要运行”，然后选择一个符合前述要求的纯英文路径，勾选同意协议，接下来等待3到5分钟，所有环境配置和依赖安装都会自动完成。

喜欢掌控细节的用户，可以尝试PowerShell脚本安装：这种方式更透明，适合有一定命令行操作经验的用户。首先，你需要确保系统已安装Node.js v22或更高版本。然后，以管理员身份打开PowerShell，输入并执行以下命令：

iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

这个脚本会自动检测系统环境，补全所需依赖，并部署本地服务。整个过程无需再输入其他命令，只需静待完成即可。

安装成功后第一件事

当安装程序运行完毕，打开OpenClaw控制台。确认右上角清晰显示Gateway在线状态，这才意味着一切就绪。接下来，你可以：

• 直接体验：在底部的输入框里尝试发送指令，例如“帮我整理一下D盘的下载文件夹，按文件类型分类”。
• 配置联动：点击右上角的设置图标，进入“聊天”选项，启用微信、钉钉或飞书联动功能。扫码授权后，就能直接在常用的聊天窗口里对OpenClaw下达命令。
• 重要设置：首次使用时，建议在命令行执行 openclaw-cn config set gateway.mode local 这条命令。这能确保所有请求都通过本地网关处理，数据不会上传至云端，兼顾了效率与隐私。

遇到报错别急着重装

安装或启动时遇到问题先别慌，大部分常见错误都有明确的解决思路：

• 程序启动后立即闪退：这通常意味着前置条件未满足。请回头彻底检查安全软件是否已完全关闭，以及安装路径是否绝对不含中文。
• 网关显示“离线”：可以先尝试在管理员PowerShell中运行 openclaw-cn gateway start 命令来手动启动网关。如果问题依旧，查看程序日志能提供更具体的错误线索。
• 发送指令后没有反应：首先确认你已在设置中选择了可用的模型（对于国内用户，阿里云百炼或Kimi都是不错的起点），并确保填入的API密钥正确且仍在有效期内。