【Bug已解决】openclaw: output truncation / Response cut off mid-sentence — OpenClaw 输出截断解决方案1. 问题描述OpenClaw 的响应在输出过程中被截断内容不完整# 输出截断 $ openclaw --print 生成 500 行代码 # 输出到 200 行突然停止 # 没有完成标记 # 或流式截断 $ openclaw 长任务 # 流式输出到一半停止 Error: Response cut off mid-sentence. # 或 max_tokens 不足 $ openclaw --print --max-tokens 2048 长任务 # 输出被截断因为 max_tokens 不够 # 或代码生成不完整 $ openclaw 生成完整的项目结构 # 只生成了一半的文件这个问题在以下场景中特别常见max_tokens 设置过小长代码生成长文本分析流式中断复杂任务需要长输出模型输出限制2. 原因分析原因分类表原因分类具体表现占比max_tokens 小2048约 40%长代码生成 4000 行约 25%长文本分析大量文本约 15%流式中断网络问题约 10%模型限制输出上限约 5%上下文超限输入太长约 5%3. 解决方案方案一增加 max_tokens最推荐# 步骤 1增加 max_tokens openclaw --print --max-tokens 8192 task # 步骤 2或更大值 openclaw --print --max-tokens 16384 长任务 # 步骤 3在配置中设置 cat .openclaw/config.json EOF { model: claude-sonnet-4-20250514, maxTokens: 8192 } EOF # 步骤 4验证 openclaw --print --max-tokens 8192 hello方案二使用 --continue 继续# 步骤 1第一次输出截断后 openclaw --print 生成代码 --max-tokens 4096 # 步骤 2继续输出 openclaw --continue --print 继续生成 --max-tokens 4096 # 步骤 3多次继续 for i in 1 2 3; do openclaw --continue --print 继续 --max-tokens 4096 done # 步骤 4验证 openclaw --print hello --max-tokens 1024方案三分步执行# 步骤 1拆分长任务 openclaw --print 生成 src/index.js 前 100 行 --max-tokens 4096 openclaw --print 生成 src/index.js 后 100 行 --max-tokens 4096 # 步骤 2分文件生成 openclaw --print 生成 src/index.js --max-tokens 4096 openclaw --print 生成 src/auth.js --max-tokens 4096 # 步骤 3分函数生成 openclaw --print 生成 login 函数 --max-tokens 2048 openclaw --print 生成 logout 函数 --max-tokens 2048 # 步骤 4验证 openclaw --print hello --max-tokens 1024方案四使用 --no-stream# 步骤 1非流式模式 openclaw --no-stream --print task --max-tokens 8192 # 步骤 2或 --print --no-stream openclaw --print --no-stream 长任务 # 步骤 3增加超时 export OPENCLAW_REQUEST_TIMEOUT120000 openclaw --print --no-stream --max-tokens 8192 task # 步骤 4验证 openclaw --print --no-stream hello方案五精简输入# 步骤 1减少输入长度 # 错误: openclaw 分析 $(cat large_file.js) # 正确: openclaw 分析 src/index.js 的前 200 行 # 步骤 2使用 grep 过滤 openclaw 分析 $(grep function src/large_file.js | head -20) # 步骤 3减少上下文 openclaw --print 只分析 src/index.js --max-tokens 8192 # 步骤 4验证 openclaw --print hello --max-tokens 1024方案六切换大窗口模型# 步骤 1使用 Sonnet 200K 窗口 openclaw --model claude-sonnet-4-20250514 --print task --max-tokens 8192 # 步骤 2或 Opus openclaw --model claude-opus-4-20250514 --print task --max-tokens 8192 # 步骤 3验证 openclaw --model claude-sonnet-4-20250514 --print hello # 步骤 4大窗口 大 max_tokens openclaw --model claude-sonnet-4-20250514 --print 长任务 --max-tokens 163844. 各方案对比总结方案适用场景推荐指数难度方案一增加 max_tokens通用⭐⭐⭐⭐⭐低方案二--continue继续⭐⭐⭐⭐⭐低方案三分步长任务⭐⭐⭐⭐⭐低方案四--no-stream稳定性⭐⭐⭐⭐⭐低方案五精简输入输入大⭐⭐⭐⭐⭐低方案六大窗口超大⭐⭐⭐⭐低5. 常见问题 FAQ5.1 max_tokens 默认多少通常 4096。可能不够长任务使用。5.2 如何增加 max_tokensopenclaw --print --max-tokens 8192 task5.3 max_tokens 最大多少通常 8192-16384取决于模型。5.4 输出被截断怎么办使用openclaw --continue继续或增加--max-tokens。5.5 如何分步执行拆分长任务为多个小任务每步使用--max-tokens 4096。5.6 --no-stream 有帮助吗有时。非流式模式减少流式中断导致的截断。5.7 上下文超限导致截断精简输入使用head -n 200或grep过滤。5.8 如何在配置中设置{maxTokens: 8192}5.9 代码生成不完整使用--continue继续生成或分文件/分函数生成。5.10 排查清单速查表□ 1. --max-tokens 8192 增加 □ 2. --max-tokens 16384 长任务 □ 3. config.json: maxTokens 8192 □ 4. --continue 继续截断的输出 □ 5. 分步执行长任务 □ 6. 分文件/分函数生成 □ 7. --no-stream 非流式 □ 8. head -n 200 精简输入 □ 9. grep 过滤大文件 □ 10. --model sonnet 200K 窗口6. 总结根本原因输出截断最常见原因是 max_tokens 过小40%和长代码生成25%最佳实践使用openclaw --print --max-tokens 8192 task增加输出限制--continue截断后使用openclaw --continue继续输出分步执行拆分长任务为多个小任务分文件/分函数生成最佳实践建议在 config.json 中设置maxTokens: 8192使用--no-stream提高稳定性故障排查流程图flowchart TD A[输出截断] -- B[增加 max_tokens] B -- C[--max-tokens 8192] C -- D[openclaw 验证] D -- E{完整?} E --|是| F[✅ 问题解决] E --|否| G[使用 --continue] G -- H[openclaw --continue --print] H -- I{完整?} I --|是| F I --|否| j[分步执行] j -- K[拆分长任务] K -- L[分文件生成] L -- D D -- M{完整?} M --|是| F M --|否| N[使用 --no-stream] N -- O[openclaw --no-stream --print] O -- P{完整?} P --|是| F P --|否| Q[精简输入] Q -- R[head -n 200 过滤] R -- S[或 grep 过滤] S -- D D -- T{完整?} T --|是| F T --|否| U[切换大窗口模型] U -- V[--model sonnet --max-tokens 16384] V -- D D -- W{完整?} W --|是| F W --|否| X[在配置中设置] X -- Y[config.json: maxTokens 8192] Y -- D F -- Z[长期: max-tokens 分步 --continue] Z -- AA[✅ 长期方案]