夜雨聆风说实话，把 OpenClaw（或者说你的智能助手中枢）搬到 Windows 上不是想象中那么简单。明明 Linux 上一路顺，就到了 Windows 上各种怪癖：权限、路径、服务……本篇把我自己踩过的坑全部列出来，帮你少走弯路。
1. 路径别用系统盘根目录（C:\Program Files……）
• Windows 的 UAC、权限控制会让 OpenClaw 无法写日志、生成缓存。
• 建议：用 D:\openclaw-workspace之类的路径，权限直接赋给当前账号。
• 补充：如果你非要用 Program Files，务必右键→“以管理员身份运行“，并修改 openclaw.json 中的 root 路径。
2. PowerShell/WSL vs CMD：选对终端- OpenClaw CLI依赖 Node.js 和 bash-like 工具链。Windows 的 CMD 对路径展开、反斜杠处理太弱。
• 推荐：直接用 PowerShell7 或 WSL2 Ubuntu，WSL还原 Linux 行为。
• Tip：在 PowerShell里跑 openclaw status，如果报 “找不到 openclaw”，先执行 npx openclaw config 切换节点。
3. 服务启动不稳定？用openclaw gateway 着手- Windows 的服务/托盘程序有时会抢占端口，导致 gateway 启动失败。
• 做法：
1. openclaw gateway stop
2. 检查 openclaw.json里 gateway.port（避免常用端口冲突）
3. openclaw gateway start 并观察 ~/.openclaw/workspace/openclaw.log
• 小提示：用 openclaw gateway restart --force 清缓存，防止残留锁。
4.免提授权：避免 “权限不足” 的 UAC 弹窗- 有些插件（如 Feishu、微信）需要访问网络/文件，系统会弹 UAC。
• 避坑：新建一个服务账户（非 Administrator），给予对 .openclaw 所有权，再把 Gateway设为该用户启动。
• 插件建议：在 Windows 服务里把 openclaw gateway设为“自动”启动，避免每次登录都要确认。
5. 环境变量（APPDATA vs 用户变量）要对齐- Windows 有「系统变量」+「用户变量」，OpenClaw 常用 env（如 MX_APIKEY）必须写在“用户变量”里，否则 Gateway读不到。
• 可以通过 setx MX_APIKEY "xxx" 永久写入，并重启 PowerShell。
• 检查：PowerShell Get-ChildItem Env: 确认。
6. 路径/分隔符一定要统一- OpenClaw skills、日志默认 ~/.openclaw/workspace，但在 Windows里 ~ 会自动变 C:\Users\xxx。
• 避坑：
• 配置路径时尽量使用 /（Node能识别），不要混反斜杠；
• openclaw run scripts/some.sh 在 Windows 下要先装 bash（WSL/ Git Bash），否则脚本跑不起来。
7. 集成技能注意依赖- 有些 skill（例如 free-ride）在 Linux 下能 pip install，但 Windows 缺 pip/权限。
-解决：优先使用 python -m venv ~/.venvs/openclaw + venv\Scripts\pip install -r requirements.txt。
-还可以用 wsl统一管理 Python，避免 Windows 原生 pip 缺失。
Windows不是不能跑 OpenClaw，而是要把“Linux 思维”稍微改一改。按照这7 条避坑清单设置一下，你的微信/QQ 助手就能像在云端一样稳。需要我帮你把整个部署脚本写成 PowerShell 模板，还是建一个配置清单/组件自动化？告诉我，我可以继续帮你推进。