AionClaw安装后若无法启动或执行报错，须立即隔离运行环境：先用三条命令检测bun、cargo、python3版本是否合规；再通过重置PATH、停止网关进程、创建独立Rust工作区、启用bun沙箱、硬指定Python解释器路径五步完成环境隔离。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当AionClaw安装后无法启动、技能执行报错、或与本地已有的Node.js/Rust/Python项目产生命令行冲突时，必须立即隔离运行环境，否则后续所有AI自动化任务都会失败。
确认冲突来源
打开终端，依次执行以下三条命令，观察输出是否异常：
→ bun --version（应返回 1.1+）
→ cargo --version（应返回 rustc 1.82+）
→ python3 --version（应返回 3.11+）
若任一命令报“command not found”或版本低于要求，说明AionClaw的安装脚本已覆盖或屏蔽了系统PATH中的原有二进制路径。
重置PATH优先级
方法一：临时修复（仅当前终端生效）
执行：export PATH="/usr/local/bin:/opt/homebrew/bin:$PATH"（macOS）或export PATH="C:Program FilesGitusrin;C:Users%USERNAME%AppDataLocalMicrosoftWindowsApps;$PATH"（Windows WSL/PowerShell）
这一步强制把系统级工具路径提到最前，绕过AionClaw installer 自动注入的干扰路径。
方法二：永久修复（影响所有新终端）
编辑 shell 配置文件：~/.zshrc（macOS）、~/.bashrc（Linux）或 $PROFILE（PowerShell）
在文件末尾添加一行：export PATH="/usr/local/bin:/opt/homebrew/bin:$PATH"（macOS/Linux）或 $env:Path = "C:Program FilesGitusrin;C:Users$env:USERNAMEAppDataLocalMicrosoftWindowsApps;" + $env:Path（PowerShell）
【务必删除AionClaw installer 自动写入的 PATH 行】——它通常形如export PATH="/opt/aionclaw/bin:$PATH"，该行会把AionClaw私有工具链永远置于最前，导致cargo build失败或bun run被劫持。
隔离AionClaw运行时依赖
第一步：停止AionClaw后台进程
执行：pkill -f "aionclaw-gateway"（macOS/Linux）或 Stop-Process -Name "aionclaw-gateway" -Force（PowerShell）
第二步：创建独立Rust工作区
新建目录：mkdir ~/aionclaw-dev && cd ~/aionclaw-dev
初始化空Cargo项目：cargo init --lib --vcs none
进入该项目后，再运行aionclaw-gateway --no-daemon，此时Rust编译器将只加载本项目依赖，不再与全局cargo或用户主目录下的Cargo.toml冲突。
第三步：为Node.js项目启用bun沙箱
AionClaw的前端UI（如AionUi）使用bun构建，但你的现有项目可能依赖npm或pnpm。不要全局切换包管理器——在项目根目录下执行：bun add --dev @types/node，然后用bun run dev单独启动AionUi；其余项目继续用npm start或pnpm dev，互不干扰。
第四步：Python环境硬隔离
AionClaw调用Python插件时默认使用python3命令，但它可能激活你全局的venv或conda环境。解决方案是：在AionClaw配置文件~/.aionclaw/config.yaml中显式指定解释器路径：python_interpreter: "/usr/bin/python3"（macOS/Linux）或python_interpreter: "C:\Python311\python.exe"（Windows）
这一步能防止AionClaw意外触发你数据科学项目的conda activate逻辑，避免pip install污染。
