【Bug已解决】openclaw: workspace cleanup failed / Temporary files not removed — OpenClaw 工作区清理失败解决方案1. 问题描述OpenClaw 运行后临时文件未被清理工作区残留大量文件# 临时文件残留 $ ls .openclaw/ sessions/ logs/ cache/ tmp/ tmp_file_123.js tmp_output.txt # 或清理失败 $ openclaw --cleanup Error: Failed to clean workspace Permission denied: .openclaw/tmp/lock # 或磁盘空间被占用 $ du -sh .openclaw/ 2.5G .openclaw/ # 或锁文件残留 $ openclaw task Error: Lock file exists Another OpenClaw instance may be running.这个问题在以下场景中特别常见异常退出导致临时文件残留锁文件未释放清理权限不足磁盘空间被缓存占用多个实例冲突清理命令失败2. 原因分析原因分类具体表现占比异常退出残留约 35%锁文件lock约 25%权限不足EACCES约 15%缓存占用cache约 15%多实例冲突约 5%清理失败error约 5%3. 解决方案方案一手动清理临时文件最推荐# 步骤 1检查临时文件 ls -la .openclaw/tmp/ du -sh .openclaw/tmp/ # 步骤 2删除临时文件 rm -rf .openclaw/tmp/* rm -f .openclaw/tmp_*.js rm -f .openclaw/tmp_*.txt # 步骤 3清理缓存 rm -rf .openclaw/cache/* # 步骤 4验证 du -sh .openclaw/ openclaw task方案二删除锁文件# 步骤 1检查锁文件 ls -la .openclaw/*.lock ls -la .openclaw/tmp/lock # 步骤 2删除锁文件 rm -f .openclaw/*.lock rm -f .openclaw/tmp/lock # 步骤 3或检查是否有进程运行 ps aux | grep openclaw # 步骤 4验证 openclaw task方案三修复权限# 步骤 1检查权限 ls -la .openclaw/ # 步骤 2修复权限 sudo chown -R $(whoami) .openclaw/ chmod -R urw .openclaw/ # 步骤 3验证 ls -la .openclaw/ # 步骤 4清理 rm -rf .openclaw/tmp/* openclaw task方案四使用 openclaw --cleanup# 步骤 1使用内置清理命令 openclaw --cleanup # 步骤 2如果失败 sudo openclaw --cleanup # 步骤 3强制清理 openclaw --cleanup --force # 步骤 4验证 du -sh .openclaw/ openclaw task方案五配置自动清理# 步骤 1配置自动清理 cat .openclaw/config.json EOF { autoCleanup: true, cleanupOnExit: true, maxCacheSize: 100MB } EOF # 步骤 2验证 python3 -m json.tool .openclaw/config.json # 步骤 3或使用 cron 定期清理 echo 0 0 * * * rm -rf ~/.openclaw/tmp/* ~/.openclaw/cache/* | crontab # 步骤 4验证 openclaw task方案六检查多实例冲突# 步骤 1检查运行中的实例 ps aux | grep openclaw # 步骤 2如果有多个终止 kill $(ps aux | grep openclaw | grep -v grep | awk {print $2}) # 步骤 3清除锁文件 rm -f .openclaw/*.lock # 步骤 4重新启动 openclaw task4. 各方案对比总结方案适用场景推荐指数难度方案一手动清理通用⭐⭐⭐⭐⭐低方案二删除锁lock⭐⭐⭐⭐⭐低方案三修复权限EACCES⭐⭐⭐⭐低方案四--cleanup内置⭐⭐⭐⭐⭐低方案五自动清理长期⭐⭐⭐⭐⭐低方案六多实例冲突⭐⭐⭐⭐低5. 常见问题 FAQ5.1 临时文件在哪里.openclaw/tmp/目录下。5.2 如何手动清理rm -rf .openclaw/tmp/* rm -rf .openclaw/cache/*5.3 锁文件是什么防止多实例同时运行的文件。异常退出后可能残留。5.4 如何删除锁文件rm -f .openclaw/*.lock5.5 清理权限不足sudo chown -R $(whoami) .openclaw/ chmod -R urw .openclaw/5.6 如何自动清理配置autoCleanup: true或使用 cron 定期清理。5.7 多实例冲突ps aux | grep openclaw检查kill终止。5.8 --cleanup 命令openclaw --cleanup openclaw --cleanup --force5.9 缓存占用空间du -sh .openclaw/cache/ rm -rf .openclaw/cache/*5.10 排查清单速查表□ 1. ls .openclaw/tmp/ 检查临时文件 □ 2. rm -rf .openclaw/tmp/* 清理 □ 3. rm -f .openclaw/*.lock 删除锁 □ 4. ps aux | grep openclaw 检查实例 □ 5. kill 终止多余实例 □ 6. sudo chown -R $(whoami) 权限 □ 7. openclaw --cleanup 内置清理 □ 8. autoCleanup: true 自动清理 □ 9. cron 定期清理 □ 10. du -sh 检查大小6. 总结根本原因工作区清理失败最常见原因是异常退出残留35%和锁文件未释放25%最佳实践使用rm -rf .openclaw/tmp/*手动清理临时文件删除锁文件rm -f .openclaw/*.lock解决锁文件残留修复权限sudo chown -R $(whoami) .openclaw/修复清理权限最佳实践建议配置autoCleanup: true自动清理使用exit正常退出故障排查流程图flowchart TD A[工作区清理失败] -- B[ls .openclaw/ 检查] B -- C[手动清理] C -- D[rm -rf .openclaw/tmp/*] D -- E[rm -rf .openclaw/cache/*] E -- F[openclaw task 验证] F -- G{成功?} G --|是| H[✅ 问题解决] G --|否| I[检查锁文件] I -- J[ls .openclaw/*.lock] J -- K{有锁文件?} K --|是| L[rm -f .openclaw/*.lock] K --|否| M[检查权限] L -- F M -- N[ls -la .openclaw/] N -- O{权限正确?} O --|否| P[sudo chown -R $(whoami)] O --|是| Q[检查多实例] P -- F Q -- R[ps aux | grep openclaw] R -- S{多个实例?} S --|是| T[kill 终止] S --|否| U[使用 --cleanup] T -- L U -- V[openclaw --cleanup --force] V -- F F -- W{成功?} W --|是| H W --|否| X[配置自动清理] X -- Y[autoCleanup: true] Y -- Z[cron 定期清理] Z -- H H -- AA[长期: autoCleanup exit cron] AA -- AB[✅ 长期方案]