← Back to Skills Marketplace
garyyinclaw

Chat Summary

by GaryYinClaw · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
278
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install chat-summary
Description
聊天话题汇总技能(支持多语言)。用于整理和总结聊天记录/对话历史,按主题聚类生成结构化摘要。使用场景:(1) 每日讨论汇总,(2) 会议记录整理,(3) 长对话要点提取,(4) 多话题聊天归档。支持语言:中文、英文、繁体中文、日文、韩文等
README (SKILL.md)

Chat Summary

核心功能

将聊天记录按话题聚类,生成结构化摘要,支持输出到 Notion/Markdown/纯文本。

工作流程

1. 读取会话历史

# 使用 OpenClaw sessions 命令
openclaw sessions --json
openclaw sessions_history --session-key \x3Ckey> --limit \x3Cn>

2. 话题聚类

按以下维度识别话题边界:

  • 用户明确切换主题
  • 时间间隔 >5 分钟
  • 关键词/上下文变化

3. 生成摘要

每个话题包含:

  • 标题:简短描述(\x3C20 字)
  • 摘要:核心内容(\x3C200 字)
  • 关键数据:数字/结论/决定
  • 相关链接:URL/文件/引用

4. 输出格式

Notion 页面(推荐):

标题:YYYY-MM-DD - 讨论摘要
父页面:DRAFTS
内容:话题标题 (Heading 2) + 摘要段落

Markdown

# YYYY-MM-DD 讨论摘要

## 话题 1: [名称]
摘要内容...

## 话题 2: [名称]
摘要内容...

话题数量控制

场景 话题上限 摘要长度
每日汇总 10 个 200 字/话题
会议记录 5 个 300 字/话题
快速回顾 3 个 100 字/话题

输出目标

Notion

  • API Key: 从 skills.entries.notion 读取
  • 父页面 ID: 配置中指定(如 DRAFTS)
  • 页面命名:YYYY-MM-DD - [描述]

本地文件

  • 路径:~/Documents/chat-summaries/
  • 格式:Markdown
  • 命名:YYYY-MM-DD-summary.md

示例请求

用户说:

  • "总结今天的讨论"
  • "把刚才的聊天整理一下"
  • "生成会议记录"
  • "汇总这个话题的要点"

资源配置

scripts/

  • summarize_session.py - 会话摘要生成脚本
  • cluster_topics.py - 话题聚类算法
  • export_notion.py - Notion API 导出

references/

  • notion-api.md - Notion API 使用说明
  • clustering-rules.md - 话题聚类规则
  • output-templates.md - 输出模板示例

多语言支持

支持语言

语言 代码 自动检测
简体中文 zh-CN
繁体中文 zh-TW
英文 en
日文 ja
韩文 ko

语言检测

from langdetect import detect

def detect_language(text: str) -> str:
    """检测文本语言"""
    return detect(text)  # 返回 ISO 639-1 代码

多语言摘要生成

  • 输入语言检测:自动识别消息语言
  • 混合语言处理:按消息级别检测,支持中英混合
  • 输出语言:默认跟随主要语言,可显式指定

用户指定输出语言

# 命令行参数
summarize_session.py \x3Csession_key> --lang zh-CN
summarize_session.py \x3Csession_key> --lang en
summarize_session.py \x3Csession_key> --lang auto  # 自动检测(默认)

# 自然语言请求
"用英文总结今天的讨论"
"Summarize today's chat in Chinese"
"日本語で要約して"

翻译集成(可选)

如需跨语言汇总(如中文聊天→英文摘要):

  • 使用 DeepL API / Google Translate / OpenAI 翻译
  • references/translation.md

注意事项

  1. 隐私:不汇总敏感/私人对话
  2. 准确性:保留原始数据/结论,不臆造
  3. 简洁:摘要控制在 200 字以内
  4. 可追溯:重要结论标注消息来源
  5. 多语言:优先保持原文语言,除非用户指定翻译
Usage Guidance
要不要安装/启用这个技能前请考虑: - 作者和来源不明 —— 请求作者身份和代码维护者信息;如果是内部团队开发,要求代码审计或签名。 - 凭据和隐私边界不明确 —— SKILL.md 会读取 Notion API Key(skills.entries.notion)并可能调用第三方翻译服务,但注册表未列出任何 required env vars。确认你愿意把聊天内容发送给 Notion、DeepL/Google/OpenAI 等服务,并明确这些 API Key 应如何安全提供(prefer secrets manager / platform secret store,而不是把密钥硬编码到脚本)。 - 功能未实现/文档不一致 —— 多处 TODO、load_session_history 是空实现,SKILL.md 列出的脚本名与 manifest 不符。要求作者提供完整实现或更新文档,并在隔离环境中测试。 - 建议的安全步骤:在受控环境(非生产数据)中运行,观察脚本是否真正只访问会话历史并将输出写到预期路径;确认 Notion 导出和翻译调用在可控范围内并使用最小权限的 API Key;如果你担心隐私,可禁用翻译或 Notion 导出,先只输出本地 Markdown。 总结:技能目的合理,但实现与凭据处理不够透明;在信任并启用前,要求作者澄清/修正凭据声明、补全实现,并在隔离环境中测试。
Capability Analysis
Type: OpenClaw Skill Name: chat-summary Version: 1.0.0 The 'chat-summary' skill is a legitimate utility designed to cluster and summarize chat histories for export to Markdown or Notion. The implementation in 'scripts/summarize_session.py' and 'scripts/lang_detect.py' uses standard Python libraries and regex for language detection without any suspicious network activity, obfuscation, or unauthorized data access. The instructions in 'SKILL.md' and the API documentation in the 'references/' directory align perfectly with the stated purpose of the tool.
Capability Assessment
Purpose & Capability
技能名称/描述与实际功能大体一致:从会话历史聚类并生成摘要,支持导出到 Notion/Markdown/本地。调用 openclaw sessions 命令读取会话历史属于该用途范围。但是 SKILL.md 中列出的脚本名(如 cluster_topics.py、export_notion.py)与清单中实际文件(lang_detect.py、summarize_session.py)不一致,且许多功能在脚本中仅为 TODO/占位,表明实现不完整或文档没同步。
Instruction Scope
运行指令会读取会话历史(openclaw sessions / sessions_history),并写出本地文件或调用 Notion API,这符合汇总目的。需要注意:SKILL.md 明确指出会从 skills.entries.notion 读取 Notion API Key,但技能清单并未声明需要的凭据;references 还建议调用第三方翻译服务(DeepL/Google/OpenAI/LibreTranslate),这些会将聊天内容发送到外部服务。没有指示读取与会话无关的系统文件,但文档/脚本存在占位实现(load_session_history 是 pass,话题切换逻辑未实现),运行前可能会要求交互或修改。
Install Mechanism
这是指令 + 脚本包(无安装规范),没有远程下载或安装步骤,风险较低。没有发现不明来源的二进制或 extract 操作。
Credentials
SKILL.md 和 references 明确会使用/建议外部 API(Notion、DeepL、Google Translate、OpenAI 等),但 registry 元数据未列出任何 required env vars 或主凭据。具体问题:1) Notion API Key 被描述为“从 skills.entries.notion 读取”,但没有在 requires.env/primaryEnv 中声明;2) translation.md 显示需提供多个翻译服务的 API key(示例中出现 sk-xxx 等),没有明确说明哪个是必须或可选;3) 若启用翻译/导出功能,聊天内容将发送到第三方服务(隐私/合规风险)。这些不一致使凭据管理与隐私边界不明确。
Persistence & Privilege
技能未设置 always:true,也未声明修改其他技能或系统级配置。默认可以被代理自主调用(disable-model-invocation:false),这是平台默认行为且在本例没有与其他高风险因素(如 broad credential access + always:true)结合。
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install chat-summary
  3. After installation, invoke the skill by name or use /chat-summary
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Chat-summary 1.0.0 released — a multi-language chat summarization skill for structuring and clustering conversations by topic. - Summarizes chat history by topic, clusters by subject switches, message times, and context. - Outputs structured summaries in Notion, Markdown, or plain text, customizable by scenario. - Built-in multi-language support: Chinese (Simplified/Traditional), English, Japanese, Korean (auto-detect and per-message handling). - Includes scripts for topic clustering, session summarization, and direct Notion export. - Flexible for different workflows: daily summary, meeting notes, quick reviews, topic archiving. - Privacy respected; does not summarize sensitive chats and retains original conclusions.
Metadata
Slug chat-summary
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Chat Summary?

聊天话题汇总技能(支持多语言)。用于整理和总结聊天记录/对话历史,按主题聚类生成结构化摘要。使用场景:(1) 每日讨论汇总,(2) 会议记录整理,(3) 长对话要点提取,(4) 多话题聊天归档。支持语言:中文、英文、繁体中文、日文、韩文等. It is an AI Agent Skill for Claude Code / OpenClaw, with 278 downloads so far.

How do I install Chat Summary?

Run "/install chat-summary" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Chat Summary free?

Yes, Chat Summary is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Chat Summary support?

Chat Summary is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Chat Summary?

It is built and maintained by GaryYinClaw (@garyyinclaw); the current version is v1.0.0.

💬 Comments