核心用法
chats-share 是专为 OpenClaw 生态设计的对话分享工具,可将本地会话记录转换为公开可访问的静态网页。用户通过 CLI 工具选择特定会话(按 ID、主题关键词或最新会话),经解析、脱敏、确认后生成 Markdown 文件并部署。
关键流程:
1. 会话定位:扫描 ~/.openclaw/agents/main/sessions/*.jsonl,支持多维度过滤
2. 内容处理:自动解析为带 frontmatter 的 Markdown,提取参与者信息并支持别名自定义
3. 安全脱敏:内置规则自动识别 API 密钥、token、邮箱、IP、用户目录路径等敏感信息
4. 版本管理:集成 Git 工作流(add → commit → push),默认输出至 {projectDir}/chats/
显著优点
- 零配置分享:基于
create-openclaw-chats-share脚手架一键初始化,降低技术门槛 - 隐私优先设计:强制脱敏步骤 + 用户二次确认机制,减少误泄露风险
- 结构化输出:保留 role/model 元信息,便于后续文档化或知识库沉淀
- Git-native 工作流:天然支持版本追溯与协作,适合团队知识共享场景
潜在缺点与局限性
- 生态绑定:依赖 OpenClaw 特有的会话存储路径(
~/.openclaw/agents/main/sessions/),跨平台/工具迁移成本高 - 静态输出限制:生成内容为静态 Markdown,不支持交互式组件或实时更新
- 手动确认负担:多轮确认(会话选择→参与者→预览→Git 操作)在批量处理时效率较低
- 脱敏规则有限:依赖正则匹配,可能漏检变形敏感信息(如 base64 编码的密钥)
适合人群
- OpenClaw 重度用户需将高质量对话沉淀为可公开文档
- 技术团队建立内部知识库,需版本化管理的对话存档
- 开发者博客/教程作者,快速生成带格式的对话示例
常规风险
- 路径遍历风险:若
projectDir配置不当或从参数注入恶意路径,可能导致文件写入任意目录 - 敏感信息残留:自动脱敏非绝对可靠,人工复核环节不可跳过
- Git 凭证泄露:
git push步骤若未配置权限隔离,可能意外推送至公开仓库 - 会话文件权限:原始
.jsonl会话文件若权限过宽,可能被其他进程读取