OpenClaw中文路径报错？纯英文目录设置规范详解
在Windows环境下部署OpenClaw时，绝大多数故障都直接指向同一个元凶——中文路径。中文用户名、带中文或空格的安装目录、混合特殊符号的路径，会触发npm报错code128、Git克隆中断、日志写入异常，甚至服务进程无预警退出。社区故障统计显示，这类问题占新手阻塞性故障的70%以上。不彻底切断中文路径，后续所有操作都如同沙上筑塔。
解决方案并不复杂，核心策略是：路径隔离。强制将OpenClaw涉及的所有路径——用户目录、缓存目录、运行时数据目录——全部迁移至纯英文路径下。以下是具体操作。
第一步：从根上切断中文路径
打开“此电脑”，右键点击C:Users下中文命名的用户文件夹，选择“属性” → “位置” → “移动”，将路径改为纯英文，例如C:UsersOpenClawUser。若系统提示需管理员权限，不要硬改，直接新建一个英文名的本地账户，将数据迁移过去。必须明确：这一步是彻底解决问题的根基，跳过它，后续所有操作都是在绕远路。
改完后重启，用新英文账户登录。在命令行执行echo %USERPROFILE%，确认返回结果为C:UsersOpenClawUser这类无中文的干净路径。
第二步：给npm缓存和临时目录做一次强制搬迁
用户目录改完，npm依然可能残留中文路径隐患。需要将其缓存和临时目录强制迁移到D盘。两步操作缺一不可。
方法一：全局重设缓存与临时目录
在PowerShell中逐行执行：
mkdir D:npm_cachemkdir D:npm_tmpnpm config set cache "D:npm_cache" --globalnpm config set tmp "D:npm_tmp" --global
方法二：环境变量接力
为何需要双重设置？因为npm v11及以上版本在git clone操作时，可能忽略npm config中的tmp路径，转而使用系统默认值。因此必须通过系统变量加固。右键“此电脑” → 属性 → 高级系统设置 → 环境变量，在“系统变量”中新建两个变量：
NPM_CONFIG_TMP = D:npm_tmpNPM_CONFIG_CACHE = D:npm_cache
必须同时设置npm config和系统变量，缺一不可。只改config而不设系统变量，某些Git操作仍会绕回默认的中文tmp目录，导致失败。
第三步：把OpenClaw的运行根目录锁死在D盘
① 在D盘创建两个目录：D:OpenClaw（程序主目录），D:OpenClawData（数据统一存放点）。
② 在系统环境变量中继续追加两条：OPENCLAW_DATA_DIR = D:OpenClawData，OPENCLAW_LOG_DIR = D:OpenClawDatalogs。
③ 打开D:OpenClawconfig.yaml，逐项检查并手动替换所有路径字段——包括data_dir、log_path、cache_dir、session_store——全部改为D:OpenClawData下的对应子路径。一条都不能遗漏。
这一步不能依赖IDE的全局搜索替换。config.yaml中可能混用相对路径、~符号或环境变量引用，只有人工逐行核对并手动替换才能确保绝对可靠。
第四步：确认路径真正生效
关闭所有终端窗口，新开一个PowerShell，执行以下三条命令：
echo $env:OPENCLAW_DATA_DIRnpm config get cachenpm config get tmp
三条命令的输出必须全部是D盘的纯英文路径，不能包含任何中文、空格、括号或$HOME符号。只要其中一条输出仍含中文或为空，则说明环境变量未被当前会话读取，旧会话的缓存仍在起作用。
最后一步，运行openclaw gateway start，然后检查D:OpenClawDatalogs目录。若gateway.log文件已生成，则配置生效。有日志即成功；无日志则说明仍有中文路径残留，需回头逐项排查。