【Bug已解决】openclaw: workspace path too long / File path exceeds limit — OpenClaw 工作区路径过长解决方案1. 问题描述OpenClaw 因工作区路径过长导致文件操作失败# 路径过长 $ openclaw 分析 src/deeply/nested/folder/structure/very/long/path/file.js Error: File path too long Path exceeds 260 character limit. # 或工作区路径过长 $ cd /very/long/workspace/path/that/exceeds/normal/limits/project $ openclaw task Error: Workspace path too long Cannot create session files in deep path. # 或 Windows 路径限制 $ openclaw 分析 C:\\Users\\very\\long\\path\\project\\src\\file.js Error: Path exceeds MAX_PATH (260) # 或临时文件路径过长 $ openclaw task Error: Cannot create temp file Path too long: /very/long/.../tmp/file.js这个问题在以下场景中特别常见深层嵌套目录项目路径过长Windows MAX_PATH 限制临时文件路径符号链接累积长文件名2. 原因分析原因分类具体表现占比深层嵌套 260 字符约 35%项目路径长workspace约 25%Windows 限制MAX_PATH约 20%临时文件tmp约 10%符号链接symlink约 5%长文件名filename约 5%3. 解决方案方案一缩短项目路径最推荐# 步骤 1检查路径长度 echo $(pwd) | wc -c # 步骤 2移动到短路径 mv /very/long/workspace/path/project /short/project cd /short/project # 步骤 3或创建符号链接 ln -s /very/long/workspace/path/project /short/project cd /short/project # 步骤 4验证 openclaw --print hello方案二缩短文件路径# 步骤 1检查文件路径长度 echo src/deeply/nested/folder/structure/very/long/path/file.js | wc -c # 步骤 2移动文件到浅层目录 mv src/deeply/nested/folder/structure/very/long/path/file.js src/file.js # 步骤 3或创建符号链接 ln -s src/deeply/nested/folder/structure/very/long/path/file.js src/short.js # 步骤 4验证 openclaw 分析 src/file.js方案三使用绝对路径# 步骤 1使用绝对路径 openclaw 分析 /short/project/src/file.js # 步骤 2或使用 ~ 缩写 openclaw 分析 ~/project/src/file.js # 步骤 3避免深层相对路径 # 错误: openclaw 分析 ../../../../deeply/nested/file.js # 正确: openclaw 分析 /short/file.js # 步骤 4验证 openclaw --print hello方案四使用 --working-dir# 步骤 1指定短的工作目录 openclaw --working-dir /short/project task # 步骤 2避免长路径 # 错误: openclaw --working-dir /very/long/path/project task # 正确: openclaw --working-dir /short/project task # 步骤 3使用符号链接 ln -s /very/long/path/project /p openclaw --working-dir /p task # 步骤 4验证 openclaw --working-dir /short/project --print hello方案五修改临时文件路径# 步骤 1设置短临时目录 export TMPDIR/tmp # 步骤 2或自定义 export OPENCLAW_TMPDIR/tmp/oc # 步骤 3创建目录 mkdir -p /tmp/oc # 步骤 4验证 openclaw --print hello方案六重构目录结构# 步骤 1扁平化目录结构 # 从: src/deeply/nested/folder/structure/file.js # 到: src/modules/file.js # 步骤 2移动文件 mkdir -p src/modules mv src/deeply/nested/folder/structure/*.js src/modules/ # 步骤 3更新引用 grep -r deeply/nested src/ --include*.js -l # 更新 import 路径 # 步骤 4验证 openclaw 分析 src/modules/file.js4. 各方案对比总结方案适用场景推荐指数难度方案一缩短路径通用⭐⭐⭐⭐⭐低方案二缩短文件文件⭐⭐⭐⭐⭐低方案三绝对路径路径⭐⭐⭐⭐低方案四--working-dir指定⭐⭐⭐⭐⭐低方案五临时路径tmp⭐⭐⭐⭐低方案六重构长期⭐⭐⭐⭐⭐中5. 常见问题 FAQ5.1 路径长度限制多少Linux/macOS: 通常 4096 字符Windows: 260 字符MAX_PATH5.2 如何检查路径长度echo $(pwd) | wc -c echo path/to/file | wc -c5.3 如何缩短路径移动项目到短路径或使用符号链接。5.4 符号链接有用吗是的。ln -s /long/path /short可以缩短路径。5.5 --working-dir 怎么用openclaw --working-dir /short/project task5.6 Windows MAX_PATH 限制启用长路径支持或缩短路径。5.7 如何修改临时目录export TMPDIR/tmp export OPENCLAW_TMPDIR/tmp/oc5.8 深层嵌套怎么办重构目录结构扁平化嵌套层级。5.9 如何创建符号链接ln -s /very/long/path/project /short/project5.10 排查清单速查表□ 1. echo $(pwd) | wc -c 检查路径长度 □ 2. mv 移动到短路径 □ 3. ln -s 创建符号链接 □ 4. openclaw --working-dir /short □ 5. 使用绝对路径或 ~/project □ 6. export TMPDIR/tmp □ 7. export OPENCLAW_TMPDIR/tmp/oc □ 8. 扁平化目录结构 □ 9. 缩短文件名 □ 10. 避免深层相对路径6. 总结根本原因路径过长最常见原因是深层嵌套35%和项目路径长25%最佳实践移动项目到短路径mv /long/path /short/path符号链接使用ln -s /long/path /short缩短路径--working-dir使用openclaw --working-dir /short/project指定短路径最佳实践建议保持项目路径简短 100 字符扁平化目录结构故障排查流程图flowchart TD A[路径过长] -- B[检查路径长度] B -- C[echo $(pwd) | wc -c] C -- D{路径 260?} D --|是| E[缩短项目路径] D --|否| F[检查文件路径] E -- G[mv 到短路径] G -- H[或 ln -s 符号链接] H -- I[openclaw 验证] F -- j[检查文件路径长度] j -- K{文件路径长?} K --|是| L[移动文件到浅层] K --|否| M[使用 --working-dir] L -- I M -- N[openclaw --working-dir /short] N -- I I -- O{成功?} O --|是| P[✅ 问题解决] O --|否| Q[修改临时路径] Q -- R[export TMPDIR/tmp] R -- S[export OPENCLAW_TMPDIR/tmp/oc] S -- I I -- T{成功?} T --|是| P T --|否| U[重构目录结构] U -- V[扁平化嵌套层级] V -- W[mv src/deep/.../file src/file] W -- I P -- X[长期: 短路径 符号链接 扁平化] X -- Y[✅ 长期方案]