openclaw-ledger-pro

What This Skill Does

OpenClaw Ledger Pro provides a robust, hash-chained audit trail for agent workspaces. Unlike standard logging, this tool creates a cryptographically verifiable chain of every modification made within your environment. If a log entry is tampered with, the hash chain breaks, immediately flagging unauthorized changes. Beyond basic logging, the Pro version includes advanced countermeasures such as workspace freezing for read-only backups, forensic analysis tools for deep-dive investigations, and automated chain restoration. It acts as an immutable ledger that ensures accountability for every command executed and every file altered by an AI agent, bridging the gap between "untraceable automation" and "auditable operations."

Installation

To add this security suite to your agent environment, execute the following installation command in your terminal:

clawhub install openclaw/skills/skills/atlaspa/openclaw-ledger-pro

Ensure that your workspace directory permissions allow for the creation of the .ledger sub-directory, as the tool relies on this for storing snapshots and hash chains.

Use Cases

• Forensic Auditing: When an agent produces unexpected output, use forensics to trace back the exact sequence of workspace changes and identify the precise moment of deviation.
• Recovery and Rollback: Use freeze to create checkpoints, allowing you to restore the state of your workspace to a known-good configuration using restore after a failed experiment.
• Regulatory Compliance: Maintain a tamper-evident record of all AI actions for teams working in high-stakes environments where auditability of automated tasks is a legal or operational requirement.
• Anomaly Detection: Utilize the automated analysis features to scan for unusual activity patterns, such as bulk file deletions or timestamp regressions, which may indicate malicious activity or configuration errors.

Example Prompts

1. "OpenClaw, run a full forensic analysis on the workspace since yesterday and tell me if there have been any unauthorized file modifications."
2. "Perform a system freeze now to create a recovery checkpoint, then run a status check to verify the current integrity of the ledger."
3. "Show me the last 20 log entries to see which skills were installed and modified within the directory during the previous session."

Tips & Limitations

• Performance: Hash-chaining adds slight overhead to operations. For workspaces with thousands of rapid file changes, consider setting longer intervals between record calls.
• Storage: Frequent snapshots will consume disk space. Regularly clean up old frozen backups that are no longer needed for recovery.
• Integrity: Never manually edit the files in the .ledger directory; doing so will break the hash chain and render the current chain unverifiable.