用途
openclaw-agent-transcript 用于在 GitHub PR/issue 工作中，按用户显式请求生成智能体会话记录（transcript）。它默认不包含会话记录，也不主动询问是否需要，仅在用户明确要求 transcript 或 preview 时使用。单独的预览请求不代表获得发布授权。
主要能力
- 在本地查找候选会话：从 Codex、Claude、Pi 和 OpenClaw 日志中匹配与 PR 标题、分支或 PR URL 相关的记录，默认扫描最新的 400 条匹配日志，可用
--max-files N扩大本地发现范围。 - 渲染会话：将指定会话渲染为 Markdown，文件渲染单次会话最多读取头尾各 8 MiB、解析最多 12,000 行，可用
--max-read-bytes N调整字节上限。 - 自动裁剪与脱敏：在显示、预览或插入前自动裁剪，保留任务相关用户提示、可见决策、简要工具摘要和验证结果，剔除系统/开发者提示、推理、原始工具输出、环境数据、本地路径、凭据、浏览器/会话/cookie 细节和认证 URL。
- 预览与插入：按请求展示裁剪后的 Markdown；若请求 HTML，则基于裁剪内容构建本地预览。仅将经检查、限定范围的文本插入到用户授权覆盖的指定 PR/issue 中。
使用方式
查找：
skills/openclaw-agent-transcript/scripts/agent-transcript find \
--query "$PR_TITLE $BRANCH_OR_PR_URL" --cwd "$PWD" --since-days 14
渲染：
skills/openclaw-agent-transcript/scripts/agent-transcript render \
--session "$SESSION_JSONL" --out /tmp/agent-transcript.md
在下游仓库中，若同步到 .agents/skills，将路径中的 skills/openclaw-agent-transcript 替换为 .agents/skills/openclaw-agent-transcript。
验证辅助脚本变更：
node --test skills/openclaw-agent-transcript/scripts/agent-transcript.test.mjs
对下游 .agents/skills 副本，需从 .agents/ 目录运行该测试命令，以便测试的相对辅助路径能够解析。
适用场景
- 用户在 PR/issue 工作中明确要求会话记录或预览。
- 需要将本地会话日志脱敏、裁剪后作为 PR/issue 的可折叠
<details>内容插入。 - 对
*.openclaw.ai托管的会话，在请求分享时优先使用原生会话分享；仅在用户明确要求单独副本时才导出独立记录。
限制
- 默认不包含会话记录，不主动提供，也不在普通 PR 工作中询问是否包含。
- 预览或生成会话记录不构成发布授权；插入前必须获得明确覆盖发布该记录到指定 PR/issue 的授权。若缺少该范围，应先展示裁剪结果并获取发布授权后再插入。
- 辅助脚本的
preview、html和append-body模式会重新渲染会话，不读取已编辑的 Markdown 文件，可能重新引入已移除的轮次，不应将其未裁剪输出作为已批准产物。 - 文件渲染存在读取上限，保留可见的部分记录提示和
sourceTruncated统计；省略的源内容不得描述为完整。 find和html在所有根目录下最多计数 20,000 个 JSONL 文件，超出上限会失败；--max-discovery-files N可接受正整数覆盖，建议优先缩窄根目录。- 意外 EOF 会停止渲染或发现，而不是将不完整输入当作完整会话。
- 验证辅助脚本时应使用合成日志和隔离的发现根目录，不得为验证该技能而发现真实用户日志。
- 未解决敏感内容时应省略该会话记录。
- 若没有安全匹配，应继续 PR 工作而不添加记录或占位符；当省略会妨碍用户明确请求的记录时，应说明省略原因。
- 不应将会话记录的纳入宣传为评审优先要求。