🎬 OpenClaw Transcripts完全指南

凌晨3点27分，我发现自己的Agent在凌晨2点做了个荒唐决定——但幸好有了Transcripts，我终于知道它当时在想什么...

🎬 什么是Transcripts？

Transcripts是OpenClaw v2026.5.27的核心新功能，它能完整记录Agent的每一次思考、工具调用、决策过程。就像给AI装了个"黑匣子"，每次对话都有完整回放。

想象一下，你的Agent是个侦探，Transcripts就是它的破案笔记——每次推理、每个线索、每个判断，全都记下来，还能倒回去重看。

💡 核心价值：Transcripts = 可审计 + 可调试 + 可学习。出了bug？看转录就知道哪步错了。

⚙️ Transcripts核心功能

1. 完整对话记录

# 查看最新transcript
openclaw transcripts list --limit 10

# 输出示例：
# ID: tr_7f3a2b  |  2026-05-28 01:23:45  |  session:abc123  |  工具调用: 5次
# ID: tr_8e4c1d  |  2026-05-28 01:20:12  |  session:abc123  |  工具调用: 3次

2. 时间旅行回放

# 回放到指定时间点
openclaw transcripts replay tr_7f3a2b --until "2026-05-28T01:25:00"

# 单步调试模式
openclaw transcripts replay tr_7f3a2b --step

3. 关键节点标记

# 在transcript中标记重要决策点
openclaw transcripts annotate tr_7f3a2b \
  --at "2026-05-28T01:24:30" \
  --note "发现成本异常，开始切换模型"

💡 实战场景

场景1：Debug"智障"决策

你的Agent突然开始用GPT-5做简单问答，成本飙升。用Transcripts一看：

openclaw transcripts show tr_7f3a2b --filter "model_switch"

# 发现：
# [01:24:15] Reasoning: "用户可能需要深度推理"
# [01:24:16] Action: switch_model(gpt-5)
# [01:24:17] User query: "今天天气怎么样？"
# 😅 破案了，过度推理了

场景2：合规审计

企业需要审计AI的所有操作，Transcripts提供完整证据链：

# 导出为PDF报告
openclaw transcripts export tr_7f3a2b \
  --format pdf \
  --include-tool-calls \
  --include-reasoning

场景3：Agent学习优化

分析历史transcripts，找出最佳决策模式：

# 分析成本优化机会
openclaw transcripts analyze --session abc123 \
  --metric cost \
  --suggest-optimizations

🛠️ 配置Transcripts

基础配置

# ~/.openclaw/config.yaml
transcripts:
  enabled: true
  storage: ~/.openclaw/transcripts/
  retention_days: 30  # 保留30天
  include_reasoning: true  # 记录推理过程
  include_tool_results: true  # 记录工具返回结果

选择性录制

# 只在特定场景录制
transcripts:
  rules:
    - session_type: "production"  # 生产环境全录
      record: all
    - session_type: "testing"     # 测试环境只录错误
      record: errors_only

🚀 最佳实践

  • 生产环境全录：出了问题有证据，别省那点存储空间
  • 定期清理：设置retention策略，避免磁盘爆满
  • 关键操作标记：用annotate标记重要决策点，方便事后分析
  • 压缩存储：超过7天的transcripts自动压缩
  • 权限控制：transcripts包含敏感信息，设置好文件权限

📊 Transcripts vs 传统日志

特性Transcripts传统日志
完整对话上下文✅ 完整记录❌ 只有片段
可回放✅ 时间旅行❌ 只能看
推理过程✅ 包含Chain-of-Thought❌ 不可见
工具调用链✅ 完整追踪⚠️ 部分记录
成本分析✅ 内置分析❌ 需要额外工具

🔗 相关资源