openclaw在windows上因中文路径报错须强制路径隔离：第一步迁移用户目录至纯英文路径；第二步重设npm缓存与临时目录并配置系统环境变量；第三步创建d:\openclaw及d:\openclawdata，设置openclaw_data_dir等变量并人工修改config.yaml全部路径；第四步验证三路径输出均为d盘纯英文路径且生成gateway.log日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw在Windows上因中文用户名、中文安装路径或含空格/特殊符号的目录导致npm报code128、Git克隆失败、日志写入中断、服务启动闪退，这类错误占新用户阻塞性故障的73%，必须通过强制路径隔离解决。
第一步：彻底停用中文路径源头
打开“此电脑”→右键“C:\Users”下的你的中文用户名文件夹→属性→位置→点击“移动”，将路径改为纯英文（如C:\Users\OpenClawUser）；若提示需管理员权限，改用新建英文本地账户并迁移数据——【这是唯一能根除npm和Git底层解析异常的方法，跳过这步，后续所有配置都只是临时补丁】。
重启电脑，以新英文账户登录，确认命令行中%USERPROFILE%返回的是C:\Users\OpenClawUser而非含汉字路径。
第二步：重定向npm核心路径
方法一：全局重设缓存与临时目录
在PowerShell中逐行执行：
mkdir D:\npm_cache
mkdir D:\npm_tmp
npm config set cache "D:\npm_cache" --global
npm config set tmp "D:\npm_tmp" --global
方法二：强制环境变量接管（绕过npm v11+对git clone的tmp路径忽略问题）
右键“此电脑”→属性→高级系统设置→环境变量→在“系统变量”中新建：
变量名：NPM_CONFIG_TMP
变量值：D:\npm_tmp
变量名：NPM_CONFIG_CACHE
变量值：D:\npm_cache
【必须同时设置npm config和系统变量，缺一不可；仅设config在某些Git操作中仍会回退到默认中文tmp】
第三步：锁定OpenClaw运行根路径
① 创建D盘纯英文部署根目录：
D:\OpenClaw（程序主目录）
D:\OpenClawData（数据统一存放点）
② 设置两个关键环境变量：
OPENCLAW_DATA_DIR = D:\OpenClawData
OPENCLAW_LOG_DIR = D:\OpenClawData\logs
③ 打开D:\OpenClaw\config.yaml，将所有出现的路径字段（如data_dir、log_path、cache_dir、session_store）全部手动替换为D:\OpenClawData下的对应子路径，一个都不能漏。
这一步不能靠搜索替换工具自动处理——config.yaml里可能混用相对路径、~符号或环境变量引用，必须人工逐行核对。
第四步：验证路径是否真正生效
关闭所有终端，新开一个PowerShell窗口，执行：
echo $env:OPENCLAW_DATA_DIR
npm config get cache
npm config get tmp
三者输出必须全部为D盘纯英文路径，且无任何中文、空格、括号或$HOME符号；【只要其中任一输出含中文或为空，说明环境变量未加载或被旧会话缓存覆盖】。
最后运行openclaw gateway start，观察D:\OpenClawData\logs下是否立即生成gateway.log文件——有日志即成功。
