适用于 Openclaw 的 Ontology Knowledge Graph

一个用于将 AI Agent 知识组织为可查询、高弹性图数据库的类型化词汇表和约束验证系统。

paudyyin
v2.0.0
2026年6月4日
0
606
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install ontology-knowledge-graph

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 ontology-knowledge-graph。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 Ontology Knowledge Graph?

Ontology Knowledge Graph 是一个类型化词汇表和约束验证系统,旨在将结构化的 AI Agent 记忆表示为可查询的图。它是为增强 Openclaw Skills 的可靠性而构建的,提供了一个严格的 schema 框架来定义 Person、Project、Task 和 Event 等实体,以及它们的多向关系。这可以防止上下文碎片化,并帮助 Agent 在长时间的交互中保持对工作状态、依赖关系和环境的一致理解。

通过维护一个仅追加(append-only)的事务分类账,本体系统提供了状态变更的历史记录。它也为多 Agent 同步提供了一个强大的基础,通过共享结构化数据 schema,使得不同的专业 Agent 能够轻松协作、传递任务并验证后置条件,而无需依赖不可预测的自然语言上下文窗口。

Ontology Knowledge Graph 应用场景

  • 结构化记忆检索:当 Agent 需要检索精确关系时,例如查找特定活跃项目下的所有任务阻塞依赖。
  • 多 Agent 共享工作空间状态:允许不同的 Agent 在具有严格 schema 的前提下安全地读写共享实体存储,以避免相互覆盖工作内容。
  • 富上下文知识图查询:使用基于 CLI 的路径查询,将简单的自然语言查询转换为显式的关系遍历。
  • 安全的凭据间接访问:通过强制执行间接访问模式并利用严格的约束验证来禁止明文密码,从而安全地存储凭据账号。

Ontology Knowledge Graph 工作原理

  1. 定义 Schema 规则:在 schema.yaml 中建立所需的属性、可接受的状态枚举和非循环关系准则。
  2. 实体实例化:通过脚本直接初始化或更新对象(如 Tasks、Goals 或 People),或在触发对话记忆提取规则时进行更新。
  3. 验证过滤:在写入之前,将每个变更负载通过约束验证器,以检查是否缺少要求或存在禁止的格式。
  4. 仅追加序列化:使用 JSON Lines 将经过验证的更改写入图存储(graph.jsonl),以保持历史完整性并方便进行 SQLite 迁移。
  5. 自动同步与回退:持续从日常工作空间笔记中拉取最新更新,并在主要向量或语义搜索返回零结果时充当活跃的备份记忆层。

Ontology Knowledge Graph 配置指南

初始化存储目录,建立基础 schema,并按照以下步骤执行首次实体插入:

# Initialize ontology storage
mkdir -p memory/ontology
touch memory/ontology/graph.jsonl

# Create schema constraints
python scripts/ontology.py schema-append --data '{
  "types": {
    "Task": { "required": ["title", "status"] },
    "Project": { "required": ["name"] },
    "Person": { "required": ["name"] }
  }
}'

# Create a verified entity
python scripts/ontology.py create --type Person --props '{"name":"Alice","email":"[email protected]"}'

# Relate entities together
python scripts/ontology.py relate --from proj_001 --rel has_task --to task_001

Ontology Knowledge Graph 数据架构与分类体系

Storage Layout

默认存储将文件保存在工作流工作空间内,以实现最佳的访问控制。

  • memory/ontology/graph.jsonl: 中心分类账,按顺序追踪所有变更(create、relate、update 等)。
  • memory/ontology/schema.yaml: 活动配置文件,规定了类型、属性、枚举、关系方向和基数。

Core Entity Schemas

Entity Type Required Fields Common Optional Fields Purpose
Person name email, phone, organization 代表人员/Agent
Project name status, goals, owner 追踪高层目标
Task title, status due, priority, assignee, blockers 管理运营任务
Credential service, secret_ref N/A (Forbidden: password, secret) 安全地引用 API 凭据

Ontology Knowledge Graph 高级特性

  • 备份记忆回退 (v2.0+): 当主要的搜索结构失效或返回低置信度答案时,自动作为辅助查询源介入,从而保障 Openclaw Skills 的性能。
  • 日常笔记自动同步: 与文件解析器集成,扫描 markdown 工作空间笔记,并异步将实体和关系导入图数据库。
  • 无环约束验证: 在链接任务对象时自动阻止创建循环依赖,从而确保执行计划的可靠性。
  • 图转换规划: 允许 Agent 将详细的多步项目计划构建为事务蓝图,如果任何约束验证失败,则完全回滚。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*