📦 Ontology KG — 智能体记忆图谱
v1.0.0为 AI 智能体打造的强类型知识图谱，可创建实体、建立关系并约束校验；采用仅追加 JSONL 存储，零外部依赖，帮助智能体在本地持久化结构化记忆。
0· 100·0 当前·0 累计
by @2233admin下载技能包
最后更新
2026/4/2
安全扫描
OpenClaw
可疑
medium confidence该技能描述的仅追加 JSONL 本体概念合理，但运行时指令反复调用 python3 scripts/ontology.py 命令，而包内既未提供脚本也无安装说明——这一不一致现象存疑，使用前需澄清。
评估建议
在确认实现来源前请勿安装或启用此技能。向发布者提问：1) scripts/ontology.py 及配套代码在哪？SKILL.md 的 CLI 示例依赖该文件。2) 若代码单独提供，运行前先检查其对文件系统与网络的访问。3) 若计划由智能体自行实现语义，需知它会创建并修改 memory/ontology/graph.jsonl（本地文件）——请备份该目录并限制文件权限。4) 确认凭据处理方式：schema 要求 secret_ref（合理），但需确保运行时不把密钥写入 JSONL。若作者无法提供源码或清晰安装路径，视为不完整包，避免自动调用。...详细分析 ▾
⚠ 用途与能力
该技能声称提供零依赖的 JSONL 存储来实现类型化知识图谱，概念自洽，但 SKILL.md 的示例与引用默认存在 Python CLI（scripts/ontology.py）。包内与清单中均未包含此类脚本或安装步骤，导致实现缺失：要么由智能体自行实现行为，要么包本身不完整。
⚠ 指令范围
指令让智能体通过运行 python 脚本创建/读取/关联/验证实体，并读写 memory/ontology/graph.jsonl。指令涉及本地文件系统路径和文档路径（可能指向任意本地文件）。虽然操作符合记忆/本体工具定位，但 SKILL.md 默许读写本地文件并运行任意 Python 脚本——而脚本未提供，故实际运行代码未知。
ℹ 安装机制
无安装规范（仅指令），理论上风险较低。然而，缺失实现却指示使用特定脚本存在不一致：要么应附带安装或代码文件，要么 SKILL.md 需说明智能体如何提供等效功能。
✓ 凭证需求
技能未请求环境变量或凭据。schema 通过 secret_ref 引用凭据（避免直接存储），属合理安全约束。未声明过度比例的 env/凭据需求。
✓ 持久化与权限
always 为 false，默认允许模型调用。技能指示写入本地 graph.jsonl（智能体本地存储），符合记忆工具预期。无迹象表明其试图修改其他技能或获取更高平台权限。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.02026/4/2
面向 AI 智能体记忆的强类型知识图谱。实体 + 关系 + 约束。JSONL 存储，零依赖。灵感来自 oswalpalash/ontology。
● 无害
安装命令
点击复制官方npx clawhub@latest install ontology-kg
镜像加速npx clawhub@latest install ontology-kg --registry https://cn.longxiaskill.com
技能文档
“Alice 负责哪个项目？” —— grep Alice，翻 10 条记录，猜。 “什么任务 block 了发布？” —— 没法回答，因为依赖关系没存。 “上次会议谁参加了？” —— 运气好能找到，运气不好淹在 200 行里。
问题不是记忆太少，是记忆没有结构。 Ontology KG 给 agent 的记忆加上类型、关系和约束。Person 有 name，Task 有 status 和 blocker，Project 有 owner。entity 之间用 relation 连接，约束自动校验。 存储是 JSONL append-only 文件，零依赖，git 友好。
核心概念 `` Entity = { id, type, properties } Relation = { from → rel_type → to } Constraint = { type rules, relation rules, acyclic checks } ` ## 类型 | 类别 | Types | |----------|-------| | 人员 | Person, Organization | | 工作 | Project, Task, Goal | | 时间 | Event, Location | | 信息 | Document, Message, Note | | 资源 | Account, Device, Credential | | 元数据 | Action, Policy | ## 快速开始 `bash # 初始化存储 mkdir -p memory/ontology touch memory/ontology/graph.jsonl # 创建实体 python3 scripts/ontology.py create --type Person --props '{"name":"Alice"}' python3 scripts/ontology.py create --type Project --props '{"name":"Website","status":"active"}' # 建立关系 python3 scripts/ontology.py relate --from proj_001 --rel has_owner --to p_001 # 查询 python3 scripts/ontology.py query --type Task --where '{"status":"open"}' python3 scripts/ontology.py related --id proj_001 --rel has_task # 校验所有约束 python3 scripts/ontology.py validate ` ## 存储格式 (JSONL) `jsonl {"op":"create","entity":{"id":"p_001","type":"Person","properties":{"name":"Alice"}}} {"op":"relate","from":"proj_001","rel":"has_owner","to":"p_001"} ` 仅追加。Git 友好。大图可迁移到 SQLite。 ## 关键约束 - Credential 不能直接存储 secret（必须使用 secret_ref）
blocksrelation 无环（禁止循环依赖）Event.end >= Event.startTask必须包含title+status
何时使用 | 触发条件 | 操作 | |---------|--------| | “记住……” | 创建/更新 entity | | “我对 X 了解什么？” | 查询 graph | | “把 X 关联到 Y” | 创建 relation | | “什么依赖 X？” | 遍历依赖 | | “显示项目状态” | 按 relation 聚合 | | 技能需要共享状态 | 读写 entity | ## 参考资料 - references/schema.md — 完整类型定义、relation 类型、约束
references/queries.md` — 查询模式、遍历示例、聚合方法