entroly-openclaw
v1.0.54
Published
Auditable, budget-aware Entroly context engine for OpenClaw
Downloads
425
Readme
Entroly for OpenClaw
Entroly provides budget-aware, auditable context assembly for OpenClaw while leaving OpenClaw's persisted transcript untouched.
Unlike uniform history summarization, Entroly scores older messages against the current request, reserves a bounded part of the context budget for matching evidence, and keeps evidence messages verbatim when they fit. Lower-value history is compressed around those evidence pins. The receipt records every score, matched query term, allocation, and transformation.
Install from ClawHub
Install the Python engine, then install the plugin from OpenClaw's official ClawHub registry:
pip install entroly
openclaw plugins install clawhub:entroly-openclaw
openclaw plugins enable entrolyThe npm-only fallback remains available as:
openclaw plugins install npm:entroly-openclaw
openclaw plugins enable entrolyFrom an Entroly source checkout:
pip install entroly
openclaw plugins install ./integrations/openclaw
openclaw plugins enable entrolySelect the engine in ~/.openclaw/openclaw.json:
{
plugins: {
slots: {
contextEngine: "entroly"
}
}
}Restart the Gateway and verify the loaded plugin with:
openclaw plugins inspect entroly --runtime --json
openclaw plugins doctorAfter the first agent turn, run /entroly-context in any connected channel to
see the estimated before/after context size, reduction, warnings, and receipt.
Run /entroly-context doctor to verify the configured Python executable and
local JSONL bridge before inviting users onto the Gateway.
Reproduce the evidence-pinning control
python -m benchmarks.openclaw_evidence_pinningThe committed synthetic workload compares query-aware evidence pinning with uniform budget compression at the same estimated token budget. See the result JSON. It uses no model calls and does not claim downstream task accuracy.
Receipts are written under <workspace>/.entroly/receipts/openclaw/ unless
receiptDir is configured. They record per-message hashes and decisions,
estimated tokens, reduction, warnings, and whether context changed. The
original content remains recoverable from OpenClaw's unchanged transcript.
Entroly makes no remote calls in this path.
Safety contract
- System and developer messages are never modified.
- Structured message content is never modified.
- Recent messages are preserved verbatim.
- Bridge errors return the exact original message list.
- Entroly does not rewrite the OpenClaw transcript or claim persistent compaction.
