OpenClaw Windows安装避坑指南

👋 关于我 我是「信息小客栈」的主理人，一个正在用AI重塑工作方式的普通人。我会分享OpenClaw的使用心得、踩过的坑、以及AI如何真正提升效率。目标很简单：让更多人用上好用的AI工具，少走弯路。 

先说结论：Windows装OpenClaw能用，但有几个坑必须提前知道。

环境准备

你需要：Node.js 18+（推荐22 LTS）、npm 9+、PowerShell 5.1+（或PowerShell 7）

# 检查版本 node --version npm --version $PSVersionTable.PSVersion

坑1：PowerShell执行策略限制

症状：运行命令报"无法加载文件，因为在此系统上禁止运行脚本"

解决：

# 以管理员身份运行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

坑2：路径中的中文和空格

症状：各种奇怪的报错，文件找不到

原因：Windows用户名如果是中文，路径中会包含中文字符，某些工具处理不了。

解决：尽量把OpenClaw装在纯英文路径下，workspace路径避免空格和特殊字符

坑3：npm全局安装权限

症状：npm install -g openclaw 报EACCES权限错误

# 方法1：用管理员身份运行PowerShell  # 方法2：修改npm全局目录 mkdir C:\npm-global npm config set prefix C:\npm-global # 然后把C:\npm-global加到系统PATH

坑4：Gateway端口被占用

症状：Gateway启动失败，提示端口18789被占用

# 查看谁占了端口 netstat -ano | findstr :18789  # 换个端口 openclaw gateway --port 18790

坑5：防火墙拦截

症状：手机Node配对连不上，飞书Webhook收不到

# 添加防火墙规则 New-NetFirewallRule -DisplayName "OpenClaw Gateway" \   -Direction Inbound -LocalPort 18789 \   -Protocol TCP -Action Allow

安装步骤（避坑版）

# 1. 安装Node.js（去官网下载LTS版本） # https://nodejs.org  # 2. 安装OpenClaw npm install -g openclaw  # 3. 初始化 openclaw init  # 4. 配置API Key openclaw config set models.providers.xiaomi-coding.apiKey "你的key"  # 5. 启动Gateway openclaw gateway start  # 6. 检查状态 openclaw status