Elephas is the system's long-term memory -- the sole writer to Chronicle, the authoritative knowledge graph where entities, relationships, events, and inferences live permanently once confirmed. It ingests structured signals from every skill's journals, scores candidate facts for confidence, resolves identity across possible duplicates, and promotes what survives into durable Chronicle facts with full provenance.
Every other skill in the OCAS suite generates signals -- Elephas is what makes those signals permanent. It ingests structured signal files from all skill journals, scores candidate facts for confidence, resolves identity across potential duplicates using a staged merge protocol, and promotes what survives into Chronicle as durable facts with full provenance. As the sole writer to Chronicle, Elephas is the single source of truth for long-term world knowledge in the system. The Chronicle database (LadybugDB, embedded single-file graph) initializes automatically on first use at ~/openclaw/db/ocas-elephas/chronicle.lbug.
| Command | Description |
|---|---|
elephas.ingest.journals |
Ingest structured signals from skill journal files and signal intake directory |
elephas.consolidate.immediate |
Score candidate confidence, promote above threshold, flag possible matches |
elephas.consolidate.deep |
Full identity reconciliation, inference generation, graph cleanup |
elephas.identity.resolve |
Attempt to resolve whether two Entity records are the same real-world entity |
elephas.identity.merge |
Merge two confirmed-same Entity records (always reversible) |
elephas.candidates.list |
List pending candidates by confidence tier and age |
elephas.candidates.promote |
Manually promote a candidate to a confirmed Chronicle fact |
elephas.candidates.reject |
Reject a candidate with stated reason |
elephas.query |
Query Chronicle for entities, relationships, events, or inferences |
elephas.init |
Diagnostic and repair: checks schema, creates missing tables, verifies indexes |
elephas.status |
Chronicle health: entity counts, pending candidates, last consolidation timestamps |
elephas.journal |
Write journal for the current run |
elephas.init runs automatically on first invocation and creates all required directories, config.json, the Chronicle database, and JSONL files. It also registers the elephas:ingest and elephas:deep cron jobs. No manual setup is required.
OCAS Skills
- All skills -- ingest structured signals from skill journals and signal intake directory
- Weave -- read-only cross-DB queries for social graph enrichment
- Mentor -- reads Chronicle read-only for evaluation context
External
- LadybugDB -- embedded single-file graph database (auto-created at
~/openclaw/db/ocas-elephas/chronicle.lbug)
| Job | Mechanism | Schedule | Command |
|---|---|---|---|
elephas:ingest |
cron | */15 * * * * (every 15 min) |
Ingest journals then immediate consolidation |
elephas:deep |
cron | 0 4 * * * (daily 4am) |
Full identity reconciliation, inference, cleanup |
- Routing improvements
- Automated maintenance with cron registration
- Ingestion pipeline with staged signal promotion
- Deep consolidation pass with identity reconciliation
- Initial release as part of the unified OCAS skill suite
Elephas is part of the OpenClaw Agent Suite -- a collection of interconnected skills for personal intelligence, autonomous research, and continuous self-improvement. Each skill owns a narrow responsibility and communicates with others through structured signal files, shared journals, and Chronicle, a long-term knowledge graph that accumulates verified facts over time.