← Back to Skills Marketplace
Chat Summary
by
GaryYinClaw
· GitHub ↗
· v1.0.0
· MIT-0
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
注意事项
- 隐私:不汇总敏感/私人对话
- 准确性:保留原始数据/结论,不臆造
- 简洁:摘要控制在 200 字以内
- 可追溯:重要结论标注消息来源
- 多语言:优先保持原文语言,除非用户指定翻译
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
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install chat-summary - After installation, invoke the skill by name or use
/chat-summary - 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
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.
More Skills