Session2blog Clawhub

把 OpenClaw 里你与 AI 真实协作解决问题的过程，沉淀成带真人决策链的结构化博文（技术复盘/学习笔记/排障记录），自动保存为 Markdown 文件。在会话中输入 /s2b 即可触发。

Session2Blog (s2b)

⚠️ 本工具会读取并处理您的完整会话历史，并写入本地 Markdown 文件。 会话可能包含 API Key、Token、私人路径、邮箱等敏感信息。工具会做最佳努力脱敏（非 100% 保证），运行前请确认会话不含机密，发布/外发前请人工复核。

把当前或指定的 OpenClaw 会话中你与 AI 协作解决问题、创作、决策的过程，按模板整理成一篇带真人决策链的结构化博文，保存为 Markdown 文件到本地。

它不是 AI 替你写文章，而是把你们真实的协作痕迹沉淀成可读的内容——平台抵制的是无脑 AIGC 注水，而这里的每个观点都来自真人在 loop 里的判断与拍板。

Trigger

当用户明确想要把当前/指定会话整理成博文时触发：

• 斜杠命令：/s2b 或 /session2blog
• 明确的自然语言意图，例如："把这个会话整理成博文""帮我导出成博客""写篇技术复盘/学习笔记/排障记录"

限定范围：仅在用户意图清晰时触发。不响应模糊闲聊（如单说"博客""整理一下"等可能在日常对话里随机命中的表述），避免误把普通会话写盘。

用法

text

/s2b                          # 处理当前会话（或最近一次会话），默认通用风格
/s2b -n 3                     # 处理列表里第 3 个会话
/s2b --session <id>           # 用完整 session ID 指定
/s2b --template tech-review   # 指定模板：tech-review | learning-notes | troubleshooting | auto(默认)
/s2b --platform wechat        # 指定平台风格：中文 wechat|juejin|csdn|zhihu；英文 devto|hashnode|medium|hn|generic；none(默认) | all(按语言出全平台各一版)
/s2b --lang en --platform devto  # 生成英文 Dev.to 风格博文
/s2b --platform all --template tech-review             # 中文: 一次生成微信+掘金+CSDN+知乎 4 版
/s2b --lang en --platform all --template tech-review    # 英文: 一次生成 Dev.to+Hashnode+Medium+HN 4 版
/s2b --with-collab            # 文末追加「协作过程与关键决策点」区块(协作溯源, 显式真人决策)

发布（Pro 版功能）

免费版只生成本地 Markdown 文件，不发布到任何平台。一键发布（掘金/微信/CSDN/知乎）为 Pro 版功能，配置与用法见文末「升级到 Pro 版」。

平台风格适配（关键）：

生成博文时，必须根据用户指定的 --platform 参数套用对应平台的爆款文风格。

bash

bash <skill_dir>/s2b.sh --list          # 先列出可用会话（带序号）
bash <skill_dir>/s2b.sh -n <N> --template <T>   # 提取指定会话对话

脚本会输出：

• 会话基本信息（ID / Agent / 时间 / 消息数）
• 自动检测的模板类型
• 完整对话文本（已过滤工具调用等噪声）
• 写作指令（模板结构 + 保存路径）

Step 2: AI 润色生成博文

根据脚本输出的对话文本和模板结构，写一篇完整的博文（Markdown 格式）。

生成博文时，必须根据用户指定的 --platform 参数套用对应平台的爆款文风格。 不同平台的读者预期、标题习惯、正文结构差异很大，不能只改个标题就完事。

--platform 可选值（中文）：wechat(微信公众号) | juejin(掘金) | csdn(CSDN) | zhihu(知乎) --platform 可选值（英文）：devto | hashnode | medium | hn(Hacker News 风格) | generic(通用英文) 通用：none(默认，通用风格) | all(按 --lang 出对应语言的全平台版本) --lang 可选值：zh(中文，默认) | en(English)

各平台爆款文风格定义

微信公众号 (wechat) — 故事感、情绪、代入感

• 标题：痛点/悬念/数字驱动。例：「我踩了3个坑，终于搞懂了XX」「做了5年开发，我才明白XX」
• 开头：场景代入，用「你有没有遇到过…」拉近距离
• 正文：口语化，像朋友聊天，有情绪起伏，适当加粗金句
• 结尾：总结一句扎心的话 + 引导「关注我，持续分享」
• 禁忌：不要太硬核堆代码，读者是泛技术人群

掘金 (juejin) — 硬核、体系化、代码密集

• 标题：直给技术关键词 + 价值感。例：「万字长文讲透XX」「从0到1实现一个XX」
• 开头：前置摘要（本文讲什么、你能学到什么）
• 正文：分节清晰带小标题，代码块密集，步骤可复现，可用目录锚点
• 结尾：技术总结 + 延伸思考
• 特征：专业术语直接用，读者是资深开发者

CSDN (csdn) — 实用主义、问题导向、步骤化

• 标题：问题+解决方案。例：「XX报错怎么办？【已解决】」「手把手教你XX」
• 开头：直接说问题现象
• 正文：步骤1/2/3，完整可复制代码，注意事项单列
• 结尾：验证结果 + 常见坑提示
• 特征：搜索友好，解决具体问题，不要铺垫

知乎 (zhihu) — 观点感、深度、辩证

英文平台风格（需 --lang en）：

• Dev.to (devto) — 实用、友好、代码导向；标题直给结果，正文短章节+可运行代码，结尾「你学到了什么」
• Hashnode (hashnode) — 精致、个人品牌向；标题抛读者收益，强开头钩子，结构化小标题，结尾给 takeaway
• Medium (medium) — 叙事、思辨、长文；标题是承诺或温和反共识，靠例子推进论点，代码服务于故事
• Hacker News (hn) — 极简、重实质、无营销；标题是事实陈述或问句，正文密集直接，讲清是什么/为什么/权衡
• 标题：问答/观点句式。例：「如何评价XX？」「做XX是一种什么体验？」
• 开头：先亮核心观点（我的看法是…）
• 正文：分层论证，引案例/数据/他人观点，承认局限性，辩证看待
• 结尾：收敛结论 + 开放讨论引导
• 特征：有个人见解，不是纯教程，要体现思考深度

通用 (none/默认) — 平衡风格，适合先生成再手动改

• 标题：[模板类型] <核心问题> 结构
• 正文：结构清晰，代码适量，专业但不堆砌

模板结构（内容骨架，不随平台变）：

• 技术复盘 [复盘] <核心问题>

  1. 背景 — 当时在做什么
  2. 踩坑过程 — 遇到了什么问题
  3. 关键决策 — 怎么分析的，权衡了什么
  4. 最终方案 — 怎么解决的，代码/配置要点
  5. 总结与教训 — 学到了什么

• 学习笔记 [笔记] <主题>

  1. 学习动机 — 为什么学
  2. 核心概念 — 用自己的话解释
  3. 实践过程 — 踩过的坑、跑过的代码
  4. 心得体会 — 真正理解了什么

• 排障记录 [排障] <问题现象>

  1. 问题现象 — 具体表现
  2. 排查过程 — 怎么查的，用了什么工具
  3. 根因分析 — 根本原因
  4. 解决方案 — 具体怎么修的
  5. 预防措施 — 下次怎么避免

写作要求：

• 语言：中文
• 语气：按平台风格调整（微信口语 / 掘金硬核 / CSDN 实用 / 知乎辩证）
• 不要出现【AI生成】类标签
• 该贴代码就贴代码，该贴配置就贴配置（微信平台可减少代码密度）
• 标题从对话内容中提炼，不要用占位符，且必须符合指定平台的标题调性
• 敏感信息保护（强制）：
  • 博文中禁止出现任何 API Key、Access Token、Secret、appkey 等凭证
  • 禁止出现真实用户名、邮箱、手机号、真实全文件路径（如 /Users/xxx/...）
  • 如果对话中涉及上述内容，s2b.sh 已自动脱敏为 <REDACTED> / <USER_HOME>/... 等占位符，请保持脱敏状态，不要还原
  • 如需引用路径，用模糊化写法（如 ~/.openclaw/... 或 <项目目录>/...）
  • 发布前自查：grep 一遍生成的 .md，确认无 sk-、无 eyJ、无真实 @用户名、无 /Users/ 绝对路径

Step 3: 保存文件

保存到 ~/openclaw/session2blog/articles/（或 config 指定的路径），文件名规则：

text

YYYY-MM-DD-<模板名>-<平台>-<简短英文slug>.md

例如：2026-07-11-tech-review-wechat-session2blog-pivot.md

同时支持一次生成多平台版本：若用户指定 --platform all，则按 --lang 生成对应语言的全平台文件（中文: wechat/juejin/csdn/zhihu；英文: devto/hashnode/medium/hn），共用同一对话内容但风格不同。

用 write 工具直接写出文件，并在会话里告知用户文件路径。

配置

配置文件：~/.openclaw/session2blog/config.yaml（安装时自动生成，权限 600）

yaml

default_template: auto
language: zh-CN
author: ""
default_platform: none      # none | wechat | juejin | csdn | zhihu | all
articles_dir: ~/.openclaw/session2blog/articles

# 协作溯源：是否在博文末尾追加「协作过程与关键决策点」区块（默认 false 不加）
# 也可在命令里用 /s2b --with-collab 临时开启，无需改配置
include_collab_trace: false

# 配置项（本地可选）
# 免费版仅需 articles_dir；发布相关配置为 Pro 版功能，此处不展开。

## 文件结构

session2blog/ ├── SKILL.md # 本文件 ├── s2b.sh # 内部实现：读 session JSONL → 提取对话 → 输出 ├── install.sh # 安装脚本（复制到 ~/.openclaw/skills/ 或 ~/.local/bin） ├── README.md # 用户文档 └── gumroad-product-copy.md # 产品页文案

text

## 依赖

- `python3`（macOS 自带）
- 生成博文：默认使用 OpenClaw 会话自带模型（零额外依赖）；本地 `ollama` 为可选，用于脚本自动写文（未安装则走会话模型写文路径）

## 升级到 Pro 版（一键发布 + 定时推送）

免费版生成本地 Markdown 文件。想要以下功能，升级 Pro 版（$5 一次购买，终身更新）：

- **一键发布**到微信公众号 / 掘金 / CSDN / 知乎（无需手动复制）
- **定时自动推送**：配置 cron 后每天自动检查近期对话并生成博文
- **优先支持**

👉 获取 Pro 版：https://jasonlizy.gumroad.com/l/session2blog-pro
👉 开源免费版（GitHub）：https://github.com/jasonleezy/session2blog

（Pro 版包含本免费版的全部功能，并额外支持多平台直接发布。）

## 生成质量说明

- **博文生成质量与您使用的大模型直接相关。** 工具只负责按平台风格整理结构，文风与准确性由实际写文模型决定。
- **发布前请人工复核：** 技术细节、代码、数据，以及脱敏是否彻底。
- 已内置「去 AI 味·仿人写作」要求，但模型遵循程度不一，以人工检查为准。

## 支持这个项目

如果免费版帮到了你，欢迎到 GitHub 点个 ⭐：

👉 https://github.com/jasonleezy/session2blog

你的 star 是对开源创作者最好的鼓励。