本文へ移動
cccskills
knowledge-source-ingestデータ・AI

OpenClawでチャットや課題一覧を差分取り込み knowledge-source-ingest

cccskills 編集部読了 約 9 分

この記事の結論

こんな人に
OpenClawのKnowledgeに、Discordのチャットや課題一覧を定期的に取り込んで最新に保ちたい人
入れると
  • 今回の取得分と前回分の追加・変更・削除・未解決が、一覧で分かれて返ってくる
  • 取得範囲・時刻・件数・ハッシュがスナップショットに残り、次回の比較に使える
  • 削除と判定された項目でKnowledgeが勝手に消えず、確認してから反映できる
向かない人
OpenClawのKnowledgeを使わない人や、一度きりの資料を取り込むだけの場面には向きません。

OpenClawでチャットや課題一覧をKnowledgeへ定期的に取り込んでいるなら、knowledge-source-ingestが役立ちます。範囲を区切って取得したデータを前回分と比べ、追加・変更・削除を確かめてから反映できるスキルです。取得範囲とスナップショットも毎回記録に残ります。この記事では、返ってくる結果の中身、導入方法、依頼文の例、反映前に確認すべき点を説明します。

目次

使うとこうなる

このスキルを使うと、取得したデータを前回分と突き合わせた「差分の計画」が先に返ってきます。Knowledgeへの反映は、そのあとです。依頼の例は次のとおりです。

9月21日から28日までのDiscordチャンネルの書き出しをマニフェスト化して、前回分と比較してください

エージェントはまず、Discrawl向けの読み取り専用アダプターで指定期間のメッセージを取り出します。期間の区切りは「開始時刻以上、終了時刻未満」です。

取り出した結果は、投稿者の固定IDを含むJSONLファイルとして保存されます。人が読んで確かめたいときのために、行番号で引用できる読みやすいトランスクリプトも別に作られる仕組みです。

次に、各メッセージのIDと内容のハッシュ値を並べたマニフェスト(取得内容の目録)が作られます。続いて範囲が重なる過去のマニフェストと比べ、カバー済み・未カバーの期間と、次の5つの一覧を返します。

区分扱い
追加新しい項目として取り込む
変更既存のページや記述と突き合わせて直す
削除情報源で消えたという観測として扱い、Knowledgeは消さない
変更なし保存済みのデータと記録を再利用する
未解決部分取得などで有無を判断できず、未解決のまま残す

反映が終わると、スナップショットのページが公開されます。このページに記録されるのは、取得範囲・観測時刻・件数・ハッシュ値と、完全取得かどうかです。最後に各ページと添付ファイルを読み戻し、ハッシュと範囲が合っているかを確かめます。

knowledge-source-ingestでできること

このスキルの役割は、外部データを「どこから、どの範囲で、いつ取ったか」の管理です。取得した会話や文書の中身を整理する作業は、別の取り込みスキルへ渡します。

情報源を固定の識別子で管理する

情報源は、表示名ではなく提供元とソースキーの組み合わせで識別します。そのため、チャンネル名が変わっても同じ情報源として扱えます。情報源ごとに基準となるページを1つ持ち、毎回の取り込みで使い回す仕組みです。

範囲を区切って取得し、スナップショットを残す

取得のたびに、マニフェストを添付したスナップショットのページが作られます。マニフェストに残るのは項目のIDとハッシュ値で、本文そのものは含まれません。

**完全取得のスナップショットだけが、その範囲内で「項目がなくなった」ことを示せます。**部分取得の場合や取得状況が不明な場合、見当たらない項目は未解決のまま。

前回との重なりを考えて差分を出す

比較の前に行うのは、同じ情報源の過去のスナップショットをKnowledgeから探すことです。添付のハッシュを検証したうえで、範囲が重なるものをすべて比較に使います。会話の記憶には頼らないため、日をまたいだ運用でも前回の状態を取り違えません。

取得後の整理を専用スキルへ渡す

文書や会話はknowledge-ingestへ、会議はknowledge-meeting-ingestへ渡されます。チャットは返信のつながりごとにまとめ、knowledge-entitiesで人・会社・プロジェクト・概念のページを補強します。

新しい動きの反映先は、最も具体的な既存ページの現状欄です。その欄を書き換えるだけで、取り込みごとに節を増やすことはしません。

インストール方法

インストールは次のコマンドで行います。実行時に、Claude CodeやCodexなど入れる先のエージェントを選べます。

npx skills add https://github.com/openclaw/openclaw --skill knowledge-source-ingest

エージェントに入れてもらう場合は、次の文面をそのまま送ってください。

次の 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/ に配置してください。

置き場所は、すべてのプロジェクトで使うか、特定のプロジェクトだけで使うかで選びます。

エージェント全プロジェクト共通プロジェクト単位
Claude Code~/.claude/skills/.claude/skills/
Codex~/.agents/skills/.agents/skills/

使い方の例

依頼文には、対象の情報源と期間、やりたい確認をはっきり書くと伝わります。

課題一覧の追加・変更・削除項目を確認できる計画を作ってください

承認済みの読み取り手段で取得した課題一覧からマニフェストが作られ、過去分と比較した計画ファイルが返ります。計画ファイルに並ぶのは、追加・変更・削除・変更なし・未解決の一覧と、カバー済み・未カバーの期間です。

取得した会議データをKnowledgeの会議取り込みへ渡してください

会議のデータはknowledge-meeting-ingestへ回されます。このスキル側は情報源の識別と取得範囲の記録を受け持ち、スナップショットを依存元として残します。

前回は人やプロジェクトの整理を省いたので、保存済みのデータから続きをしてください

保存済みの元データを再利用して、省いていた補強の続きを進めます。マニフェストに変化がなくても、補強が済んでいるとは限らないためです。

注意点

反映前に、削除と判定された項目と取得範囲の記録を必ず確認してください。削除は、あくまで情報源側で観測された状態にすぎません。Knowledgeの記述の訂正や取り下げは、根拠がそろったときに限られます。

導入前に確認しておきたい点は次のとおりです。

  • 前提はOpenClawのKnowledge機能です。再起動後に保存先が想定と違っていたら、書き込む前に止めて正しい保存先へ戻します。
  • 取得には承認済みの読み取り手段が必要です。同梱のDiscrawlアダプターは読み取り専用で、設定済みのアーカイブを読みます。
  • 付属スクリプトはnodeで実行します。
  • 定期実行のジョブやスケジューラーは作りません。定期取り込みを組む場合はknowledge-automationを先に使います。
  • 資格情報、アーカイブの置き場所、非公開の生データをKnowledgeページの本文に書かないでください。
  • ライセンスはMITです。付属の参照ファイルとスクリプトが多いため、SKILL.mdと合わせて中身を読んでから入れてください。

関連スキル

取り込んだ会話から人や組織の情報を整えるなら、knowledge-entitiesを組み合わせます。会話や資料に登場する人・会社・プロジェクト・概念を特定し、根拠付きのKnowledgeページと相互リンクを整えるスキルです。チャットの取り込みでは、knowledge-source-ingestから呼ばれる位置づけになります。

まとめ

knowledge-source-ingestは、OpenClawのKnowledgeへチャットや課題一覧を繰り返し取り込む人のためのスキルです。範囲を区切って取得し、前回との差分を一覧で確かめてから反映します。取得範囲とスナップショットが毎回残るので、次の取り込みでも同じ基準で比べられるでしょう。導入方法と付属ファイルはcccskillsのページで確認できます。

よくある質問

定期的に自動で取り込むジョブも作ってくれますか
作りません。スケジューラーや常駐の接続プロセスは用意されていません。エージェントが承認を受けて実行する流れを支えるスキルです。定期取り込みを作る場合はknowledge-automationを先に使います。
Discord以外の情報源にも使えますか
使えます。課題一覧、フィード、メールボックスなど、範囲を区切って取得できる情報源が対象です。ただし同梱のアダプターはDiscrawl向けだけ。それ以外は承認済みの読み取り手段で取得してから、汎用のマニフェストツールにかけます。
削除と判定された項目はKnowledgeから消えますか
消えません。削除は情報源で観測された状態として扱われ、Knowledgeを消してよいという意味にはなりません。訂正や取り下げは、根拠がそろったときだけ行います。
マニフェストにメッセージの本文は残りますか
残りません。マニフェストに入るのは項目のIDと内容のハッシュ値です。元データは、許可された範囲で証拠として別に保存します。

このスキルを試す

knowledge-source-ingest の入れ方とインストールコマンドは、cccskills のスキルページにまとめてあります。

この記事は、公開されている SKILL.md と cccskills の紹介文をもとに AI(Claude)が下書きし、cccskills 編集部の方針に沿って推敲・公開しています。正確な仕様はスキルのページで原文を確認してください。

他の記事