Tools 导读

Trajectory bundles:它会替你伸哪只手

Trajectory bundles 不是名词卡片,而是一只会伸出来帮忙的手。你要看清它什么时候出手、抓进去什么、递回来什么,还有每个参数到底像哪颗按钮。原文最响的一记鼓点,其实是:Trajectory capture is OpenClaw's per-session flight recorder. It records a structured t…。

先讲这一页到底在解决什么

Trajectory bundles:它会替你伸哪只手

Trajectory bundles 不是名词卡片,而是一只会伸出来帮忙的手。你要看清它什么时候出手、抓进去什么、递回来什么,还有每个参数到底像哪颗按钮。原文最响的一记鼓点,其实是:Trajectory capture is OpenClaw's per-session flight recorder. It records a structured t…。

原文共 11 节,先看 Start Here 路径:/tools/trajectory 查看官方原文

第一站

它回答的是“刚才到底发生了什么”

排查 agent 问题时,你会想知道模型收到了什么、用了哪些工具、有没有超时、有没有被中断、当时开了哪些插件和技能。

像飞行记录仪

飞机落地后如果要复盘,不能只问乘客感受,还要看仪表记录。Trajectory 做的就是这类记录。

什么时候用

适合“为什么这轮没按预期做”“工具到底调了没”“是不是 provider 或超时问题”这类排查。

/export-trajectory

这是导出当前 session 支持包的命令。它像把这一轮相关资料装进一个文件袋。

owner command

导出不是谁都能做,发送者要通过正常命令授权和 owner 检查。

第二站

包里不是只有聊天记录,还有运行侧的脚印

Trajectory 默认会记录 OpenClaw agent run 的运行事件。导出的 bundle 里会有 manifest.json,告诉你这次包里实际放了哪些文件。

1

会话时间线

例如 session started、context compiled、prompt submitted 这类关键节点。

2

提示和上下文

帮助你确认模型当时看到的材料是不是完整,是否被压缩或裁剪过。

3

工具和 provider

帮助你查“工具有没有调用”“provider 有没有报错”“模型设置是不是对的”。

4

缺失也有信息

如果某些文件没有出现,可能是这次运行没捕获到对应数据,先看 manifest.json

第三站

隐私边界要先讲清:这是支持包,不是公开帖

Trajectory 会做脱敏和大小限制,但它仍然是为了支持和调试准备的资料包,不适合随手公开发布。

会脱敏什么

凭据、像秘密的字段、图片数据、本地状态路径、工作区路径等会被处理,工作区路径会替换成 $WORKSPACE_DIR

怎样关闭记录

启动前设置 OPENCLAW_TRAJECTORY=0 可以关闭运行侧 trajectory 捕获。

flush timeout

慢磁盘或大数据时,可以调 OPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS,这是清理阶段等待写完记录的时间。

排查空包

如果导出里没有运行事件,先确认没关掉 trajectory、目录可写,并再跑一条消息后重新导出。

最后总结

把 Trajectory 压成一句话

它是 OpenClaw 的运行记录袋:出问题时用来复盘过程,导出前会尽量脱敏,但仍要像处理调试资料一样谨慎。