Ontology Knowledge Graph para Openclaw

Um sistema de vocabulário tipado e validação de restrições para organizar o conhecimento de agentes de IA como um banco de dados de grafo consultável e resiliente.

paudyyin
v2.0.0
Jun 4, 2026
0
606
0

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install ontology-knowledge-graph

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<project>/skills/

Prioridade: Espaço de Trabalho > Local > Integrado

3. Instalação do Prompt

Copie este prompt para o OpenClaw para instalá-lo automaticamente.

Ajude-me a instalar o ontology-knowledge-graph usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).

Prefere baixar?

Obtenha os arquivos originais da habilidade em um arquivo ZIP.

O que é Ontology Knowledge Graph?

O Ontology Knowledge Graph é um sistema de vocabulário tipado e verificação de restrições projetado para representar a memória estruturada de agentes de IA como um grafo consultável. Construído para expandir a confiabilidade do Openclaw Skills, ele fornece um framework de schema rigoroso para definir entidades como Pessoa, Projeto, Tarefa e Evento, juntamente com seus relacionamentos multidirecionais. Isso evita a fragmentação do contexto e ajuda os agentes a manter uma compreensão coerente dos estados de trabalho, dependências e ambientes ao longo de interações de longa duração.

Ao manter um registro de transações apenas de adição (append-only), o sistema de ontologia fornece um histórico de alterações de estado. Ele também serve como uma base robusta para sincronização multi-agente, onde o compartilhamento de schemas de dados estruturados torna fácil para agentes especializados distintos cooperarem, passarem tarefas e validarem condições posteriores sem depender de janelas de contexto de linguagem natural imprevisíveis.

Casos de uso do Ontology Knowledge Graph

  • Recuperação de Memória Estruturada: Quando um agente precisa recuperar relacionamentos precisos, como encontrar todas as dependências de bloqueio de tarefas em um projeto ativo específico.
  • Estado de Workspace Compartilhado Multi-Agente: Permitir que diversos agentes leiam e escrevam com segurança em um armazenamento de entidade compartilhado com schemas estritos para evitar a sobrescrita do trabalho uns dos outros.
  • Consultas de Grafo de Conhecimento Ricas em Contexto: Transição de consultas simples em linguagem natural para navegação explícita de relacionamentos usando consultas de caminho orientadas por CLI.
  • Indireção Segura de Credenciais: Armazenar contas de credenciais com segurança forçando padrões de indireção e bloqueando senhas em texto simples por meio de validação estrita de restrições.

Como o Ontology Knowledge Graph funciona

  1. Definir Regras de Schema: Estabeleça propriedades necessárias, enums de status aceitáveis e diretrizes de relação acíclica em schema.yaml.
  2. Instanciação de Entidade: Inicialize ou atualize objetos (como Tarefas, Metas ou Pessoas) diretamente via scripts ou quando disparado por regras de extração de memória de conversação.
  3. Filtragem de Validação: Passe cada payload de mutação por um validador de restrições para verificar requisitos ausentes ou formatos proibidos antes de escrever.
  4. Serialização Apenas de Adição: Escreva as alterações validadas no armazenamento do grafo (graph.jsonl) usando JSON Lines para integridade histórica e migrações SQLite fáceis.
  5. Sincronização Automatizada e Fallback: Puxe continuamente atualizações recentes de notas diárias do workspace e sirva como uma camada de memória de backup ativa sempre que as buscas semânticas ou vetoriais primárias retornarem resultados zero.

Configuração do Ontology Knowledge Graph

Inicialize o diretório de armazenamento, estabeleça um schema básico e execute sua primeira inserção de entidade com as etapas abaixo:

# 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

Esquema de Dados e Taxonomia de Ontology Knowledge Graph

Storage Layout

O armazenamento padrão mantém arquivos localmente dentro do workspace do fluxo de trabalho para controles de acesso ideais.

  • memory/ontology/graph.jsonl: O registro central rastreando todas as mutações (create, relate, update, etc.) em ordem sequencial.
  • memory/ontology/schema.yaml: A configuração ativa ditando tipos, propriedades, enums, direção de relacionamento e cardinalidade.

Core Entity Schemas

Entity Type Required Fields Common Optional Fields Purpose
Person name email, phone, organization Representa pessoas/agentes
Project name status, goals, owner Rastreia objetivos de alto nível
Task title, status due, priority, assignee, blockers Gerencia tarefas operacionais
Credential service, secret_ref N/A (Forbidden: password, secret) Protege referências de API

Recursos avançados do Ontology Knowledge Graph

  • Backup Memory Fallback (v2.0+): Intervém automaticamente como uma fonte de consulta secundária quando as estruturas de busca primária falham ou retornam respostas de baixa confiança, protegendo o desempenho no Openclaw Skills.
  • Auto-Sync de Notas Diárias: Integra-se com um parser de arquivos que escaneia notas de workspace em markdown, importando entidades e relacionamentos para o grafo de forma assíncrona.
  • Validação de Restrições Acíclicas: Bloqueia automaticamente a criação de dependências circulares ao vincular objetos de tarefa, garantindo planos de execução confiáveis.
  • Planejamento como Transformação de Grafo: Permite que o agente construa planos de projeto detalhados de várias etapas como blueprints de transação que revertem totalmente se qualquer validação de restrição falhar.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

Apresentou*