Refactor database stats to return raw byte counts and CLI command grouping and support OpenClaw Plugins

[fajarhide]

PR Auto Describe

Summary

This PR adds official support for the OpenClaw agent framework, renames the deprecated omni learn --status flag to --discover across the codebase, improves command savings tracking, and updates release tooling to sync plugin versions.

---

Key Changes

• Official OpenClaw integration plugin suite
• Breaking flag rename: --status → --discover for omni learn
• Enhanced stats tracking with command grouping
• Updated release scripts and documentation

---

Detailed Breakdown

• OpenClaw Integration: Added integrations/openclaw/ with a full plugin setup: README guide, Node.js tool handlers for omni_shell (wraps omni exec) and omni_rewind (retrieves full archived logs), and a plugin manifest with configurable options. Updated scripts/bump_version.sh and scripts/omni-release.sh to sync the plugin's version with the core OMNI binary.
• Flag Rename: Replaced all instances of omni learn --status with --discover across CLI code (src/cli/learn.rs), all documentation examples, checklists, and help text.
• Stats & Tracking Improvements:
  • Updated SQLite store methods to track raw input/output bytes instead of precomputed reduction percentages for accurate command grouping
  • Added command grouping logic in src/cli/stats.rs to aggregate similar commands (e.g., npm install variants)
  • Fixed src/hooks/post_tool.rs to use cleaned command strings when recording distillation data
  • Updated test assertions in tests/savings_assertions.rs to match the new stats API schema
• Documentation Updates: Added an OpenClaw integration link to the root README's user resources, updated the agent flowchart to include OpenClaw, and revised all omni learn examples in docs/HOW_TO_USE.md.

---

Notes (Optional)

The OpenClaw integration reduces terminal output token usage by up to 90% by filtering out noise, while preserving full access to raw logs via the omni_rewind tool when needed.

---

Breaking Changes (If any)

• The omni learn --status flag has been fully removed and replaced with --discover; existing scripts or automation using the old flag will fail until updated.

Last updated: 2026-04-12 14:21:53