用途：当需要以浏览器方式查看、导出、检查或分享 Codex、Claude Code、OpenClaw 或 Pi 的会话记录（transcript）时使用。
主要能力：自动检测 codex、claude 或 pi-openclaw 会话格式；将规范化后的会话数据嵌入单个 HTML 文件，便于分享与浏览器内搜索（工具输入/输出文本保留在 DOM 中以便检索）；完整读取会话文件并在两种导出模式下保留完整历史。--raw 模式嵌入原始 JSONL 并由浏览器解析；--blank 模式生成可复用的文件选择器查看器。
使用方式：若未知会话路径且存在 agent-transcript 技能，可先用其查找：
.agents/skills/openclaw-agent-transcript/scripts/agent-transcript find
--query "$USER_GOAL_OR_TITLE $BRANCH_OR_URL"
--cwd "$PWD"
--since-days 14
选定置信度最高的文件后用 session-viewer 渲染： node skills/openclaw-session-viewer/scripts/session-viewer.ts <session.jsonl> --out /tmp/session.html --open
常用模式： node skills/openclaw-session-viewer/scripts/session-viewer.ts <session.jsonl> --out session.html node skills/openclaw-session-viewer/scripts/session-viewer.ts <session.jsonl> --raw --out session.html node skills/openclaw-session-viewer/scripts/session-viewer.ts --blank --out viewer.html --open
在下游仓库中若共享技能位于 .agents/skills，将 skills/openclaw-session-viewer 替换为 .agents/skills/openclaw-session-viewer。
会话存放位置：Codex 通常在 ${CODEX_HOME:-$HOME/.codex}/sessions 下查找 rollout-*.jsonl；OpenClaw/Pi 在 ${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/agents/$AGENT_ID/sessions，可用同目录 sessions.json 映射 session key 与 id；Claude Code 在 $HOME/.claude/projects 下查找 *.jsonl。
限制：--max-read-bytes N（正整数字节上限）为可选的部分导出，超限文件保留头尾并在 CLI 与导出查看器中显示省略警告，截断边界记录可能被省略；该限制仅作用于 CLI 文件导出，浏览器文件选择器仍加载完整文件。短读会重试，意外 EOF 会使导出失败。开发约束：脚本为原生 Node TypeScript，须保持可擦除语法（可用 types、interfaces、unions、satisfies；避免 enums、namespaces、decorators、parameter properties），不使用 tsconfig 路径别名，使用相对导入。