← Back to Skills Marketplace
ontology
by
oswalpalash
· GitHub ↗
· v1.0.4
· MIT-0
198961
Downloads
659
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install ontology
Description
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
Usage Guidance
Review this carefully before installing. It does not appear malicious or network-enabled, but it can persist and delete shared memory records in your workspace. Use it only where persistent ontology state is intended, avoid storing secrets directly, and consider adding confirmation plus pre-commit validation before relying on it for trusted cross-skill memory.
Capability Analysis
Type: OpenClaw Skill
Name: ontology
Version: 1.0.4
The 'ontology' skill provides a robust framework for managing a local knowledge graph (entities and relations) stored in JSONL format. The implementation in `scripts/ontology.py` includes proactive security measures such as a `resolve_safe_path` function to prevent path traversal and schema constraints in `references/schema.md` that explicitly forbid storing raw secrets like passwords or tokens. The logic is transparent, well-documented, and strictly focused on its stated purpose of structured memory management.
Capability Assessment
Credentials
File access is mostly proportionate to the stated purpose and path resolution confines graph, schema, and schema-fragment files to the workspace root, though writable paths are not limited only to memory/ontology.
Install Mechanism
No install hook, remote payload retrieval, package-install step, network call, subprocess execution, or tool spoofing behavior was found; the package consists of documentation plus a local Python CLI.
Instruction Scope
The trigger scope includes broad phrases like remember and cross-skill shared-state access, which can lead to persistent ontology mutations in ordinary conversations unless the agent adds its own confirmation boundaries.
Persistence & Privilege
The skill intentionally persists shared agent memory in workspace files and supports active-state deletion without an explicit confirmation flag; invalid or sensitive records can remain in the append-only graph and affect downstream consumers.
Purpose & Capability
The purpose of a typed local knowledge graph matches the included CLI, but SKILL.md claims mutations are validated before commit and rolled back on constraint violation while the implementation appends create, update, relate, delete, and schema changes without pre-commit validation or rollback.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ontology - After installation, invoke the skill by name or use
/ontology - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
- Initial release of the ontology skill for typed, constraint-validated knowledge graphs.
- Supports entity and relation CRUD, property and relation validation, and graph traversal for common types such as Person, Project, Task, Event, and Document.
- Provides schema-driven constraints including required properties, enums, forbidden fields, cardinality, and acyclicity.
- Enables multi-step planning and shared memory across skills via structured ontology objects.
- Includes CLI tooling for creating, querying, linking, and validating graph data using JSONL storage.
v0.1.2
No functional or documentation changes were detected in this release.
- Version bumped to 0.1.2 with no file or content changes.
v0.1.1
- Added an "Append-Only Rule" to encourage appending or merging ontology data and schema changes rather than overwriting files, preserving history and prior definitions.
- Updated quick start instructions to use `schema-append` for safely modifying schemas instead of direct file editing.
- Expanded the documentation to clarify that runtime commands and validations operate on local files, create necessary directories, and are within the skill's supported behaviors.
- Clarified the scope of validation: property, enum, forbidden checks, relation validation, acyclicity, and specific Event constraints are supported; higher-level constraints remain documentation unless implemented.
v0.1.0
Initial release: typed knowledge graph for agent memory, entity CRUD, relations, constraints, skill interop
Metadata
Frequently Asked Questions
What is ontology?
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin... It is an AI Agent Skill for Claude Code / OpenClaw, with 198961 downloads so far.
How do I install ontology?
Run "/install ontology" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is ontology free?
Yes, ontology is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does ontology support?
ontology is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created ontology?
It is built and maintained by oswalpalash (@oswalpalash); the current version is v1.0.4.
More Skills