openclaw-storage-plugin

OpenClaw Storage Plugin

A programmatic OpenClaw plugin that enables hash-based permanent storage for AI agents using the Universal Hash Resolution Protocol (UHRP).

Key Features

• Integrity: Every file is addressed by its hash, ensuring data cannot be tampered with.
• Efficiency: Agents share large files via hashes instead of large message bodies.
• Shared Identity: Uses the same BSV wallet as your other OpenClaw plugins.

Configuration

You can configure the plugin in your openclaw.json file. The plugin supports both a flat structure and a nested config object under its ID.

Example Configuration

{
  "plugins": {
    "entries": {
      "openclaw-storage-plugin": {
        "enabled": true,
        "storageHost": "https://storage.bsv.direct",
        "walletDir": "~/.openclaw/bsv-wallet"
      }
    }
  }
}

Options

Option	Default	Description
storageHost	https://storage.bsv.direct	Preferred UHRP storage host URL.
network	mainnet	The BSV network to target (mainnet, testnet, or local).
walletDir	~/.openclaw/bsv-wallet	Directory where wallet-identity.json is stored.

Slash Commands (Autoreply)

• /storage status — Check connection to the UHRP storage host.
• /storage upload <text> — Upload a quick snippet and get its hash.

AI Tool: storage

Agents can use the storage tool to perform the following actions:

Action	Description
upload	Save local content to a UHRP storage host and get its hash.
download	Retrieve and verify content using a SHA256 hash.
list	See all files uploaded or cached by this agent.
status	Check storage host connection and protocol status.

Architecture

Built with the OpenClaw Plugin SDK, this extension is distributed as a fully standalone bundle via esbuild (includes all JS dependencies) for maximum reliability. It uses better-sqlite3 for local file caching and hash indexing.

License

MIT