agent space preview 是 openclaw 中依赖 session 双轨存储(快照+不可变日志)构建的只读实时视图,用于可视化多 agent 协作拓扑;它通过拉取活跃 session 的 snapshot 和 log 渲染执行链路,缺失日志则节点丢失,虚线消息流仅在双方 active 时显示。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Agent Space Preview 是 OpenClaw 中用于可视化和调试多 Agent 协作状态的实时界面,它依赖 Session 的完整事件日志与双轨存储结构才能准确还原执行现场。没有 Session 的持久化快照和不可变日志,Preview 就只能显示空白或断连的节点。
Agent Space Preview 的数据来源就是 Session
Agent Space Preview 不是独立运行的监控服务,它本质是一个基于 Session 数据构建的只读视图。每次你打开 Preview 页面,它会自动拉取当前 workspace 下所有活跃 Session 的最新快照(Snapshot)和增量日志(Log),然后按时间线+调用关系渲染成拓扑图。
如果你手动删除了某个 Session 的日志文件(例如 【session-abc123.log.jsonl】),Preview 中对应节点将永久丢失历史交互痕迹,即使该 Session 仍在运行。
OpenClaw改编自@mvanhorn的last30days技能,可在Reddit、X、YouTube、TikTok、Instagram、Hacker News、Poly...等平台研究过去30天的任意话题。
Preview 展示的每一条连线,都对应一次 sessions_spawn 或 sessions_send
方法一:查看 spawn 链路
当 MainAgent 调用 sessions_spawn 创建子 Agent 时,Preview 会在图中生成一个带箭头的实线,起点是父 Session,终点是子 Session,并标注 mode=run 或 mode=session。
方法二:追踪 send 消息流sessions_send 触发的消息传递,在 Preview 中显示为虚线双向箭头,且仅在双方 Session 都处于 active 状态时才可见。如果子 Session 已超时终止,这条虚线会变灰并标注“no response”。
注意:Preview 不显示被白名单拦截的 spawn 请求——这类操作连 Session 都没创建成功,自然不会进入日志系统。
如何让 Preview 显示更完整的执行路径
第一步:确保 Session 配置启用了双轨存储
检查 openclaw.yaml 中是否包含以下配置:
session: storage: snapshot: true log: true
第二步:为关键子任务显式指定 thread 绑定
在 sessions_spawn 调用中加入 thread: true,这样 Preview 才能把分散的子 Session 归并到同一个逻辑线程下展示,避免出现孤立节点。
第三步:禁用自动重置阈值
将 autoResetThreshold: 0.8 改为 autoResetThreshold: 0.0,否则 Preview 可能在你查看中途触发上下文清空,导致连线突然中断。










