Aarondb

What This Skill Does

AaronDB is a high-performance, distributed Datalog engine specifically designed for sovereign AI agents. At its core, it implements a 'Database as a Value' paradigm, treating the agent's knowledge base as an immutable, queryable state. By utilizing datoms—triplets of Entity, Attribute, and Value—it allows agents to store complex relational data and perform logical reasoning across their memory. Unlike traditional key-value stores, AaronDB enables time-travel debugging and complex inference, making it an essential tool for agents that require a persistent, verifiable source of truth.

Installation

To integrate AaronDB into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/criticalinsight/aarondb. Additionally, ensure your runtime supports the dependency by running npm install @criticalinsight/aarondb-edge. Once installed, import the AaronDB class into your agent logic to begin managing facts.

Use Cases

AaronDB is ideal for agents acting as personal assistants, knowledge managers, or collaborative reasoning partners. Use it to track user preferences over time, maintain a record of past interactions for contextual reasoning, or manage state in multi-agent workflows. Because it supports distributed sync, you can use it to build a shared memory layer where multiple agents contribute to a unified knowledge graph.

Example Prompts

1. 'Store a new fact in the database: entity 'agent_core', attribute 'status', value 'operational'.'
2. 'Query the database for all entities that have the attribute 'principle' and return the associated values.'
3. 'Review the last three transactions in the database to reconcile the current agent state with recent user inputs.'

Tips & Limitations

When using AaronDB, remember that state is managed through transactions. Avoid direct mutations to ensure your audit trail remains intact and immutable. Because Datalog is a declarative logic language, structure your queries to filter broad sets of entities rather than iterating manually, as this will drastically improve reasoning speed. Keep in mind that while it excels at complex relationship management, it is not a replacement for high-bandwidth binary storage; store references to large assets rather than the binary files themselves.