会话时间线
例如 session started、context compiled、prompt submitted 这类关键节点。
Tools 导读
Trajectory bundles 不是名词卡片,而是一只会伸出来帮忙的手。你要看清它什么时候出手、抓进去什么、递回来什么,还有每个参数到底像哪颗按钮。原文最响的一记鼓点,其实是:Trajectory capture is OpenClaw's per-session flight recorder. It records a structured t…。
先讲这一页到底在解决什么
Trajectory bundles 不是名词卡片,而是一只会伸出来帮忙的手。你要看清它什么时候出手、抓进去什么、递回来什么,还有每个参数到底像哪颗按钮。原文最响的一记鼓点,其实是:Trajectory capture is OpenClaw's per-session flight recorder. It records a structured t…。
第一站
排查 agent 问题时,你会想知道模型收到了什么、用了哪些工具、有没有超时、有没有被中断、当时开了哪些插件和技能。
飞机落地后如果要复盘,不能只问乘客感受,还要看仪表记录。Trajectory 做的就是这类记录。
适合“为什么这轮没按预期做”“工具到底调了没”“是不是 provider 或超时问题”这类排查。
/export-trajectory这是导出当前 session 支持包的命令。它像把这一轮相关资料装进一个文件袋。
导出不是谁都能做,发送者要通过正常命令授权和 owner 检查。
第二站
Trajectory 默认会记录 OpenClaw agent run 的运行事件。导出的 bundle 里会有 manifest.json,告诉你这次包里实际放了哪些文件。
例如 session started、context compiled、prompt submitted 这类关键节点。
帮助你确认模型当时看到的材料是不是完整,是否被压缩或裁剪过。
帮助你查“工具有没有调用”“provider 有没有报错”“模型设置是不是对的”。
如果某些文件没有出现,可能是这次运行没捕获到对应数据,先看 manifest.json。
第三站
Trajectory 会做脱敏和大小限制,但它仍然是为了支持和调试准备的资料包,不适合随手公开发布。
凭据、像秘密的字段、图片数据、本地状态路径、工作区路径等会被处理,工作区路径会替换成 $WORKSPACE_DIR。
启动前设置 OPENCLAW_TRAJECTORY=0 可以关闭运行侧 trajectory 捕获。
慢磁盘或大数据时,可以调 OPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS,这是清理阶段等待写完记录的时间。
如果导出里没有运行事件,先确认没关掉 trajectory、目录可写,并再跑一条消息后重新导出。
最后总结
它是 OpenClaw 的运行记录袋:出问题时用来复盘过程,导出前会尽量脱敏,但仍要像处理调试资料一样谨慎。