本体知识图谱

技能简介

Ontology 是一套带类型约束的知识图谱系统，用于为智能体提供结构化记忆能力。所有信息以实体-关系-属性的形式存储，支持跨技能共享状态、依赖追踪和多步骤任务规划。

业务背景

为智能体打造结构化记忆中枢，让AI助手像人类一样建立长期知识关联。通过实体-关系-属性的三元组存储，实现跨任务状态共享与复杂计划追踪，避免信息孤岛，提升多步骤任务的连贯性与可追溯性。

落地案例：销售团队部署智能客服时，可用本体图谱统一管理客户、订单、沟通记录三类实体。当客户咨询历史订单时，系统自动遍历"客户-下单-订单-包含-商品"关系链，调取完整上下文；服务经理还能在schema.yaml中定义"VIP客户必须关联专属顾问"等规则，确保数据质量。

能做什么

• 创建和查询各类实体（人员、项目、任务、事件、文档等）
• 建立实体间的关联关系，形成可遍历的知识网络
• 强制执行类型约束，确保数据一致性
• 将多步骤计划建模为图转换操作序列
• 为多个技能提供统一的状态读写接口
• 追踪任务依赖，检测循环阻塞

使用说明

安装准备

本技能依赖 Python 3 环境，需将脚本置于可执行路径：

# 克隆或复制技能文件
git clone https://github.com/openclaw/skills.git
cd skills/oswalpalash/ontology

# 确保 ontology.py 可执行
chmod +x scripts/ontology.py

# 创建默认存储目录
mkdir -p memory/ontology

基础操作

1. 创建实体

python3 scripts/ontology.py create --type Person --props '{"name":"Alice","email":"alice@example.com"}'

2. 查询实体

python3 scripts/ontology.py query --type Task --where '{"status":"open"}'
python3 scripts/ontology.py get --id task_001

3. 建立关系

python3 scripts/ontology.py relate --from proj_001 --rel has_task --to task_001

4. 验证约束

python3 scripts/ontology.py validate

配置类型约束

编辑 memory/ontology/schema.yaml 定义自定义类型和校验规则，包括必填字段、枚举值、关系基数、无环检测等。

输入与输出

见下方输入与输出表格。

风险提示

• 凭证类实体禁止直接存储密码，必须通过 secret_ref 间接引用
• 修改现有数据时遵循追加合并原则，避免覆盖历史记录
• 复杂图结构建议迁移至 SQLite，避免 JSONL 性能瓶颈
• 约束冲突会导致操作回滚，需在技能契约中声明前置条件

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/oswalpalash/ontology/SKILL.md
来源类型：GitHub 开源技能