aionclaw采用自包含式打包方案，安装包内置全部运行依赖并自动注入进程级环境变量，无需用户手动配置；仅在非默认路径运行或使用第三方知识库时需少量干预。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
本地部署AionClaw时，无需手动配置任何环境变量——这是它区别于原生OpenClaw的核心设计之一。安装包已内置全部运行依赖，包括Python解释器、模型调用通道、向量计算库及国产大模型适配层，系统启动后自动加载所需路径与参数。
为什么不用配环境变量
AionClaw采用自包含式打包方案，所有二进制文件、动态链接库、预编译模型适配器均被打包进安装目录的runtime/子目录中。安装程序执行时，会将该目录临时注入当前进程的PATH和LD_LIBRARY_PATH（Linux/macOS）或PATH与DLL_DIRECTORY（Windows），仅对AionClaw自身生效，不污染系统全局环境。
这一步完全静默完成，用户无感知。你打开终端输入aionclaw --version能直接返回版本号，就说明路径已就绪。
哪些情况可能需要额外干预
方法一：在非默认路径运行AionClaw可执行文件
若你将安装包解压到/opt/aionclaw以外的路径（如/home/user/tools/aionclaw），且未通过安装向导执行“注册为系统命令”，则需手动添加软链接：sudo ln -s /home/user/tools/aionclaw/bin/aionclaw /usr/local/bin/aionclaw。否则终端报command not found。
方法二：使用第三方向量数据库（如Milvus或Weaviate）
此时只需配置对应服务的host和port，填入AionClaw WebUI的「知识库设置」页即可。不需要设置MILVUS_URI等环境变量——AionClaw内部封装了连接池初始化逻辑，所有外部服务参数均由UI表单驱动，实时写入config.yaml并热重载。
【关键提醒】不要手动修改config.yaml中的env字段：该字段为保留字段，仅用于未来扩展，当前版本读取即忽略。强行写入会导致服务启动失败且无错误提示。
验证是否真正免配置
第一步：下载官方安装包（.exe/.dmg/.AppImage），双击运行安装向导
第二步：全程点击“下一步”，不勾选“自定义安装路径”、“添加到PATH”等高级选项
第三步：安装完成后，打开终端（Windows用CMD或PowerShell，macOS用Terminal，Linux用任意终端），输入：aionclaw status
第四步：看到输出包含status: running和http://127.0.0.1:8080即表示部署成功，环境变量零干预已生效。
