aionclaw部署失败主因是路径含中文或空格，因其底层依赖c++ fopen和python pathlib.path在windows下对非ascii字符处理不稳定，导致.env读取、缓存生成等操作触发filenotfounderror；正确做法是将安装目录设为纯英文无空格路径如d:\aionclaw，并以管理员身份运行start.bat。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
部署 AionClaw 时文件路径含中文或空格会导致启动失败、Gateway 服务离线、配置文件写入异常，甚至智能体任务执行中途崩溃——这不是软件缺陷，而是底层框架对路径字符的硬性限制。
为什么中文和空格会直接导致报错
OpenClaw 衍生的所有商用发行版（包括 AionClaw）都继承了原生框架的路径解析逻辑：它依赖 C++ 标准库 fopen 和 Python 的 pathlib.Path 进行初始化，而这两者在 Windows 上对非 ASCII 字符和空格的处理极不稳定。一旦路径中出现「D:\我的项目\AionClaw」或「D:\Aion Claw」这类结构，程序在读取 .env、生成缓存目录、加载浏览器驱动时就会触发 FileNotFoundError 或 OSError: [WinError 123]。
你看到的报错可能伪装成“Gateway 未响应”“模型配置加载失败”“工具插件注册超时”，但日志里真正卡住的位置永远是第一行：Failed to resolve base path: D:\...\Aion Claw。
正确设置安装路径的三步操作
第一步：在磁盘根目录新建纯英文无空格文件夹，例如 D:\AionClaw 或 C:\aic；【不要用桌面、文档、下载等系统默认中文路径，也不要加版本号后缀如 AionClaw-v2.3】
第二步：将 AionClaw 安装包完整解压到该文件夹内，确保所有子目录（dist、settings、models）都在同一级英文路径下；
第三步：右键点击 start.bat →「以管理员身份运行」，观察控制台输出是否出现 Gateway online 和 Agent ready 字样——只有这时才代表路径层已通过校验。
如果已经装在中文路径下怎么办
方法一：直接剪切整个文件夹，粘贴到 D:\AionClaw，然后重新运行 start.bat；
方法二：不移动文件，用 Windows 符号链接绕过限制——以管理员身份打开 PowerShell，执行：mklink /D D:\AionClaw "C:\用户\张三\桌面\我的AI工具\AionClaw"，再从 D:\AionClaw 启动；
方法三：彻底重装——卸载前先清空杀毒软件隔离区，再从官网或可信源重新下载安装包，解压时全程禁用输入法，键盘保持英文状态。
