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 standard sqlite3 for local file caching and hash indexing.

License

MIT