OpenClaw学习总结_I_核心架构_7：Streaming详解

I. 核心架构 - 7. Streaming 课程位置阶段I. 核心架构课序第 7 课前置知识I-6. Compaction后续课程I-8. Session Pruning 本课核心问题如果你问我“为什么回复是一个字一个字地显示而不是一次性显示完整这样有什么好处”我会这样回答这就是Streaming流式输出——它让 AI 的回复像打字机一样一个字一个字地出来用户体验更好。 两种输出模式1. Block阻塞模式是什么等 AI 生成完整个回复再一次性显示过程用户发送消息 ↓ AI 开始生成... ↓ 等待... (用户看不到任何东西) ↓ 生成完毕 → 一次性显示全部缺点用户等待时间长看不到任何反馈不知道 AI 是不是卡住了体验差2. Streaming流式模式是什么AI 生成一点就显示一点过程用户发送消息 ↓ AI 开始生成... ↓ 生成第一个字 → 立即显示 ↓ 生成第二个字 → 立即显示 ↓ ... 持续显示 ... ↓ 生成完毕优点用户立即看到反馈知道 AI 正在工作体验好很多 Streaming 的技术细节工作原理AI 模型生成的不是一个完整句子 而是一个一个的 token词块 Stream 模式 Token 1 → 显示 Token 2 → 显示 Token 3 → 显示 ... Token N → 显示Block vs PreviewBlock 模式等所有 token 生成完一次性发送所有内容不需要额外处理Preview 模式实时显示每个 token可以在完整回复前预览更早给用户反馈⏱️ 延迟控制为什么要加延迟问题AI 生成太快一个字一秒就出来了看起来像瞬间完成失去了正在思考的感觉用户体验反而不好解决方案加人性化延迟{ agents: { defaults: { streaming: { enabled: true, // 延迟选项 humanize: { enabled: true, // 启用人性化延迟 minDelay: 15, // 最小延迟毫秒 maxDelay: 50, // 最大延迟毫秒 probability: 0.5 // 延迟概率 } } } } } 实战配置 Streaming基本配置{ agents: { defaults: { streaming: { enabled: true, // 启用流式输出 preview: true, // 启用预览模式 // 人性化延迟 humanize: { enabled: true, minDelay: 15, maxDelay: 50 } } } } }调试# 查看 streaming 日志openclaw logs|grepstreaming# 测试不同延迟# 调整 minDelay 和 maxDelay 看看效果⚠️ 常见陷阱陷阱表现原因解决延迟太长回复太慢maxDelay 设置太大调小延迟没有延迟看起来像瞬间完成humanize 没启用启用并调整流式中断显示到一半停了网络问题检查网络Preview 混乱预览和最终不同Preview 只是草稿理解 Preview 性质 学习心得我学这一课时的体会我以前觉得 Streaming 就是显示功能没多想。学完后才知道它是用户体验的关键加延迟是故意的设计Preview 模式可以更早反馈这让我意识到技术不只是功能还要考虑体验。与其他课程的关联前置课程Compaction - 优化 Context后续课程Session Pruning - 另一个优化手段配合课程Agent Loop - 阶段 5✅ 你现在应该理解的解释 Block 和 Streaming 的区别知道为什么需要流式输出理解人性化延迟的作用能配置 Streaming 参数 快速参考表概念简单说Block等全部生成完再显示Streaming生成一点显示一点Preview实时预览草稿人性化延迟让输出看起来像打字 相关资源官方文档Streaminghttps://docs.openclaw.ai/concepts/streaming相关课程上一课I-6. Compaction下一课I-8. Session Pruning 本课总结最关键的 3 点用户体验Streaming 比 Block 体验好用户立即看到反馈人性化延迟不是bug是设计让 AI 看起来像人配置建议启用 Streaming启用人性化延迟调整到合适的速度现在你应该理解了输出方式的选择。下一课会讲如何优化存储Session Pruning。