OpenClaw Ontology技能学习笔记

一、技能核心基础1. 技能定位OpenClaw的长效知识图谱技能打造AI本地结构化记忆解决AI对话健忘、无关联推理、上下文断层问题让AI持久记住人物、任务、项目等信息及关联关系。2. 核心解决问题- 普通AI对话结束即遗忘无法跨会话记忆信息- 无结构化记忆信息零散无法梳理实体间关系- 问答不准无法基于历史信息精准推理回复3. 核心原理1. 触发机制Agent读取 MEMORY.md 中的触发规则匹配关键词后自动调用技能2. 规则约束读取 memory/ontology/schema.yaml 限定可记录的实体、属性与关联关系3. 数据存储将结构化信息写入/读取 memory/ontology/graph.jsonl 数据文件4. 执行逻辑无后台常驻指令触发→规则校验→文件读写→结果返回按需调用二、核心工作启动逻辑1. 无独立启动安装配置完成后重启网关即激活无需单独启动服务2. 触发方式- 自动触发 MEMORY.md 配置规则对话提及关键词自动调用- 手动触发输入指令 /skill ontology 主动调用3. 文件关联Agent严格按官方路径主动读取 memory/ontology 目录下配置和数据文件路径错误则技能失效三、前置准备1. 已安装OpenClaw环境2. 终端可执行OpenClaw相关命令3. 确认工作区路径默认 ~/.openclaw/workspace 四、一键安装配置脚本# 1. 进入工作区路径cd ~/.openclaw/workspace# 2. 创建技能专属存储目录mkdir -p memory/ontology# 3. 创建空数据存储文件touch memory/ontology/graph.jsonl# 4. 生成官方标准 schema.yaml 配置文件cat memory/ontology/schema.yaml EOFtypes:person:required: [name]optional: [role, contact]project:required: [name]optional: [status, deadline, owner]task:required: [title, status]optional: [assignee, deadline, project]event:required: [title, date]optional: [location, participants]document:required: [title]optional: [author, tags]relations:belongs_to: [task, project]created_by: [task, person]related_to: [*]deadline_for: [task, event]EOF# 5. 确保 MEMORY.md 存在并配置自动触发规则touch MEMORY.mdcat MEMORY.md EOF## Ontology 自动调用规则当用户提及人物、项目、任务、事件、文档相关内容时自动调用Ontology技能记录实体信息及关联关系查询相关信息时优先从Ontology知识图谱中检索数据保证回答精准连贯。EOF# 6. 重启网关使配置全部生效openclaw gateway restart# 7. 配置完成验证ls memory/ontology/ echo -e \n✅ Ontology技能配置完成可正常使用五、关键配置说明1. schema.yaml核心配置文件定义可记录的实体类型、必填/可选属性、实体关联关系技能唯一认可的配置文件2. graph.jsonl数据文件存储所有结构化记忆内容本地保存不上传云端3. MEMORY.md触发规则文件告知AI何时自动调用技能无规则则需手动触发4. 路径要求文件路径必须为 工作区/memory/ontology/ 不可随意修改六、使用要点1. 仅安装技能无法使用必须完成上述配置重启网关2. 配置后无需额外操作正常对话即可自动记录信息3. 手动调用可直接执行 /skill ontology 指令4. 修改配置后需重启网关才能生效本文档由AI生成仅供学习参考实际操作请结合官方文档规范执行。