AionClaw卸载或更新时“文件被占用”源于Gateway、node、electron等进程独占锁定核心文件或~/.openclaw/workspace/目录，需通过任务管理器结束相关进程、命令行停服（openclaw gateway stop/sc stop/launchctl unload）、清理.lock文件或lsof/handle定位PID后强制释放。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在卸载、更新或重启 AionClaw 时遇到“文件被占用”提示，系统弹窗显示类似「无法删除 xxx.dll」「目标文件正被另一个程序使用」或「拒绝访问 .openclaw/workspace/」等报错，说明某个进程正在锁定 AionClaw 的核心文件或工作目录——这会直接阻断后续所有操作。
确认哪个进程在占用文件
第一步：打开任务管理器（Windows）或活动监视器（macOS），切换到「详细信息」或「进程」标签页。
第二步：按 CPU 或名称排序，重点查找以下进程名：AionClaw、Gateway、node、electron、openclaw。macOS 用户还需留意 launchd 下名为 io.aionclaw.gateway 的子进程。
第三步：右键→「结束任务」或「强制退出」。⚠️ 注意：若看到多个 node 进程，只结束与 【~/.openclaw/ 或 AionClaw 安装路径】相关的那一个，误杀其他 node 服务可能导致你本地开发环境崩溃。
关闭后台隐藏的 Gateway 服务
方法一：用命令行彻底停服（推荐）
打开终端（Windows 用 PowerShell，macOS 用 Terminal），执行：
openclaw gateway stop
如果提示 command not found，说明 CLI 已失效，改用系统级服务控制：
Windows：运行 sc stop AionClawGateway
macOS：运行 launchctl unload ~/Library/LaunchAgents/io.aionclaw.gateway.plist
方法二：手动清空启动项
Windows 进入 任务管理器→启动 标签页，禁用所有含 AionClaw 或 OpenClaw 字样的条目；
macOS 打开 系统设置→登录项，移除对应启动项。这一步不做，重启后 Gateway 会自动拉起并再次锁死文件。
释放被占用的工作区目录
常见现象是 ~/.openclaw/workspace/ 文件夹无法删除或重命名，即使没看到相关进程在运行。
原因在于：AionClaw 的 Hermes Agent 模块会将部分数据库文件（如 workspace.db、cache.sqlite）以独占模式挂载，即使主界面已关闭，后台线程仍在维持内存映射。
解决方法：
① 先执行 openclaw workspace flush（如有 CLI）；
② 若失败，进入该目录，找到并删掉 .lock 文件（隐藏文件，需开启显示隐藏文件）；
③ 最后对整个 workspace/ 右键→「在终端中打开」→运行：lsof +D ~/.openclaw/workspace/（macOS）或 handle -u ~/.openclaw/workspace（Windows 需提前下载 Sysinternals Handle 工具），定位并 kill 对应 PID。
这一步操作起来很简单，直接把文件拖进去就行。
绕过占用强制清理（终极手段）
当以上方法全部失效，且你确认不需要保留任何配置与技能数据，可启用系统级强制解锁：
Windows：以管理员身份运行 PowerShell，执行：Remove-Item -Path "$env:USERPROFILE\.openclaw" -Recurse -Force -ErrorAction SilentlyContinue
macOS：在终端中执行：sudo chown -R $(whoami) ~/.openclaw && rm -rf ~/.openclaw
【执行前必须关闭所有微信、飞书、钉钉客户端】——这些 IM 软件若开启了「通过聊天窗口控制本地 AI」功能，会通过 IPC 通道持续持有 .openclaw/ 下的 Unix socket 文件句柄，导致 rm -rf 卡死或静默失败。
