AionClaw通过系统级环境变量AION_ENV识别运行模式,值必须为development或production(严格区分大小写),否则启动失败;Windows需在系统变量中配置,macOS/Linux须通过shell配置并终端启动验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在AionClaw中区分开发与生产环境运行逻辑,必须通过环境变量控制模型调用路径、日志级别、本地文件读写权限及安全审计开关,否则同一套技能在测试时正常,上线后可能因未启用AES256加密或跳过三层代码扫描而触发安全拦截。
确认AionClaw运行模式识别机制
AionClaw不依赖传统.env文件,而是通过启动时读取系统级环境变量AION_ENV来判断当前上下文。该变量值必须为development或production,其他任何值(包括空值、大小写错误如Development)都会导致客户端拒绝启动并报错ERR_INVALID_ENV_MODE。
这一步不能跳过——AionClaw的Hermes Agent模块在初始化阶段即校验该变量,若缺失或非法,后续所有配置加载将中断。
Windows系统配置方法
方法一:命令行临时生效(仅当前终端有效)
打开CMD或PowerShell → 执行:set AION_ENV=development → 启动AionClaw安装目录下的AionClaw.exe。
方法二:系统级永久设置(推荐用于生产)
右键“此电脑”→“属性”→“高级系统设置”→“环境变量”→在“系统变量”区域点击“新建”→变量名填AION_ENV,变量值填production → 确定后重启AionClaw客户端。
【注意:修改系统变量后必须重启AionClaw进程,仅关闭再打开主界面无效】
macOS/Linux系统配置方法
第一步:确认shell类型
执行echo $SHELL,若返回/bin/zsh(M系列Mac默认),则编辑~/.zshrc;若返回/bin/bash,则编辑~/.bash_profile。
第二步:追加环境变量声明
执行echo 'export AION_ENV=development' >> ~/.zshrc(开发环境)或echo 'export AION_ENV=production' >> ~/.zshrc(生产环境)。
第三步:立即生效配置
执行source ~/.zshrc,然后在终端中运行echo $AION_ENV验证输出是否为设定值。
第四步:启动客户端
必须通过终端执行open -a "AionClaw"启动,图形界面双击启动会绕过shell环境变量加载,导致AION_ENV为空。
验证环境变量是否生效
启动AionClaw后,进入「个人中心」→「系统诊断」→「环境信息」页签,检查「运行模式」字段:
• 显示Development Mode且日志面板顶部出现黄色DEBUG标识,表示开发环境激活成功;
• 显示Production Mode且绿色「安全保护中」状态标识常亮、无调试日志输出,表示生产环境配置完成。
若此处显示Unknown Mode,说明环境变量未被正确读取,需回溯前几步检查拼写、大小写、shell配置文件路径及启动方式。


















