用OpenClaw差量导入聊天记录和任务列表 knowledge-source-ingest
機械翻訳 / Machine-translated
原文链接: 用OpenClaw差量导入聊天记录和任务列表 knowledge-source-ingest(cccskills)
技能页面: knowledge-source-ingest
本文结论
如果你正在定期将聊天记录或任务列表导入OpenClaw的Knowledge,knowledge-source-ingest将大有帮助。
这是一个可以划定范围获取数据,与上次内容比对,确认新增、变更、删除后再反映的技能。
每次获取范围和快照也都会留有记录。
本文将介绍返回结果的内容、安装方法、请求示例,以及反映前需要确认的事项。
使用此技能后,系统会先返回将获取数据与上次内容比对后生成的"差量计划"。
之后再将内容反映到Knowledge。
请求示例如下:
请将9月21日至28日的Discord频道导出内容清单化,并与上次内容进行比较
Agent首先通过面向Discrawl的只读适配器提取指定时间段内的消息。
时间段的划分方式为"大于等于开始时间,小于结束时间"。
提取结果将保存为包含发送者固定ID的JSONL文件。
为方便人工核查,系统还会单独生成一份可通过行号引用的易读文字记录。
接下来,系统会生成一份包含每条消息ID及内容哈希值的清单(Manifest)。
随后与范围重叠的历史Manifest进行比较,返回已覆盖/未覆盖的时间段,以及以下五类列表:
| 类别 | 处理方式 |
|---|---|
| 新增 | 作为新条目导入 |
| 变更 | 与现有页面或记述比对后修正 |
| 删除 | 作为在数据源中消失的观测结果处理,不删除Knowledge中的内容 |
| 无变化 | 复用已保存的数据和记录 |
| 未解决 | 因部分获取等原因无法判断是否存在,保持未解决状态 |
反映完成后,快照页面将被发布。
该页面记录的内容包括:获取范围、观测时刻、数量、哈希值,以及是否为完整获取。
最后会回读各页面和附件,确认哈希值与范围是否一致。
此技能的职责是管理外部数据"从哪里、哪个范围、何时获取"的信息。
对获取到的对话或文档内容进行整理的工作,将交由其他导入技能处理。
数据源的识别依据不是显示名称,而是提供方与源键的组合。
因此,即使频道名称发生变化,也能作为同一数据源进行处理。
每个数据源有一个基准页面,每次导入时复用。
每次获取时,都会创建一个附有Manifest的快照页面。
Manifest中保存的是条目的ID和哈希值,不包含正文内容。
只有完整获取的快照,才能表明该范围内某条目已消失。
部分获取或获取状态不明的情况下,未找到的条目将保持未解决状态。
比较前,系统会先从Knowledge中查找同一数据源的历史快照。
验证附件哈希值后,将所有范围重叠的快照用于比较。
不依赖对话记忆,因此跨天运营时也不会误判上次的状态。
文档和对话交由knowledge-ingest处理,会议交由knowledge-meeting-ingest处理。
聊天记录按回复线索归组,通过knowledge-entities补充人员、公司、项目、概念的页面。
新动态的反映目标是最具体的现有页面的当前状态栏。
只更新该栏的内容,不会在每次导入时新增章节。
使用以下命令进行安装。
执行时可以选择安装到Claude Code或Codex等目标Agent。
npx skills add https://github.com/openclaw/openclaw --skill knowledge-source-ingest
如需让Agent代为安装,请直接发送以下内容:
请安装以下 Agent Skill。
https://github.com/openclaw/openclaw/tree/main/extensions/knowledge/skills/knowledge-source-ingest
请先确认 SKILL.md 及附属文件的内容,确认不存在可疑操作(向外部发送数据、读取认证信息等)后,Claude Code 请放置到 ~/.claude/skills/knowledge-source-ingest/,Codex 请放置到 ~/.agents/skills/knowledge-source-ingest/。
存放位置根据是在所有项目中使用还是仅在特定项目中使用来选择。
| Agent | 所有项目共用 | 按项目区分 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Codex | ~/.agents/skills/ | .agents/skills/ |
在请求中明确写出目标数据源、时间范围以及希望确认的内容,表达会更清晰。
请生成一份可确认任务列表新增、变更、删除项目的计划
系统会根据通过已批准的只读方式获取的任务列表生成Manifest,并返回与历史内容比对后的计划文件。
计划文件中列出了新增、变更、删除、无变化、未解决的列表,以及已覆盖/未覆盖的时间段。
请将获取的会议数据移交给Knowledge的会议导入处理
会议数据将被转交给knowledge-meeting-ingest处理。
此技能负责数据源识别和获取范围记录,并将快照作为依赖源保留。
上次省略了人员和项目的整理,请从已保存的数据继续处理
系统将复用已保存的原始数据,继续进行之前省略的补充工作。
即使Manifest没有变化,也不代表补充工作已经完成。
反映前,请务必确认被判定为删除的条目和获取范围记录。
删除仅代表在数据源侧观测到的状态。
Knowledge中记述的修正或撤回,仅在证据充分时进行。
导入前请确认以下几点:
如需整理从导入的对话中提取的人员和组织信息,可搭配使用knowledge-entities。
这是一个用于识别对话和资料中出现的人员、公司、项目、概念,并整理带有依据的Knowledge页面和相互链接的技能。
在聊天导入流程中,它处于被knowledge-source-ingest调用的位置。
不会。
系统不提供调度器或常驻连接进程。
这是一个支持Agent在获得授权后执行操作的技能。
如需配置定期导入,请先使用knowledge-automation。
可以。
适用于任务列表、Feed、邮箱等可划定范围获取的数据源。
但随附的适配器仅面向Discrawl。
其他数据源请通过已批准的只读方式获取后,使用通用Manifest工具进行处理。
不会。
删除被视为在数据源侧观测到的状态,并不意味着可以删除Knowledge中的内容。
修正或撤回仅在证据充分时进行。
不会。
Manifest中只包含条目的ID和内容哈希值。
原始数据会在允许范围内另行保存为证据。
knowledge-source-ingest是专为需要将聊天记录或任务列表反复导入OpenClaw Knowledge的用户设计的技能。
它能划定范围获取数据,确认与上次的差量列表后再进行反映。
每次获取范围和快照都会保留,因此下次导入时也能以相同基准进行比较。
安装方法和附属文件可在cccskills页面查看。
本文转载自 cccskills 的文章「用OpenClaw差量导入聊天记录和任务列表 knowledge-source-ingest」。
技能详情和安装方法请访问 cccskills 的 knowledge-source-ingest 页面。