Soul Blocks for Openclaw

A powerful tool for minting and managing permanent, on-chain identities and behavioral traits for AI agents on the Base network.

hburgoyne
v0.1.0
Feb 14, 2026
0
1.7k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install soulblock

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install soulblock using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Soul Blocks?

Soul Blocks is a specialized skill designed to bridge the gap between blockchain-based identity and AI agent personality. By utilizing this Openclaw Skills integration, developers can create souls on the Base mainnet that store immutable fragments of data. These fragments define an agent's voice, traits, and history, allowing for a persistent persona that remains consistent across different sessions and platforms.

The skill offers a hybrid approach to wallet management, prioritizing the evm-wallet skill for direct transactions while providing deep-link fallbacks for manual execution. It emphasizes safety through mandatory local backups of SOUL.md files and strict confirmation workflows for irreversible on-chain actions, ensuring that your agent identity is handled with professional-grade security.

Soul Blocks Use Cases

  • Establishing a persistent on-chain identity for autonomous AI agents.
  • Storing immutable behavioral patterns and personality traits as append-only soul fragments.
  • Embodying specific agent personas by loading on-chain metadata into local runtime environments.
  • Maintaining a verifiable history of agent evolution through permanent blockchain records.

How Soul Blocks Works

  1. The agent fetches on-chain data for a specific token ID to populate a local SOUL.md file.
  2. Local identity files are automatically backed up with timestamps to prevent data loss during edits or re-formatting.
  3. Users can mint new Soul Blocks on the Base network via integrated wallet commands or web-based deep links.
  4. New identity fragments are drafted, encoded, and appended to the blockchain after explicit user confirmation of the permanent write.
  5. The agent embodies the soul by internalizing the contents of SOUL.md and setting up scheduled reinforcement triggers to maintain its persona.

Soul Blocks Setup

To begin using this identity framework within Openclaw Skills, ensure you have the prerequisite wallet tools installed and pinned to a verified version.

clawhub install evm-wallet --version 1.0.3

Configure your environment if using custom contracts or specific RPC endpoints:

export SOULBLOCKS_CONTRACT_ADDRESS=0x...   # Optional contract override
export SOULBLOCK_RPC_URL=https://...       # Optional RPC override

Review the security guidelines in the source code before connecting a hot wallet to the agent environment.

Soul Blocks Data Schema & Taxonomy

Component Type Description
.soulblock YAML Local configuration tracking active and embodied token IDs.
SOUL.md Markdown A disposable snapshot of all on-chain fragments for the current soul.
Fragments On-chain Permanent data entries limited to 2048 bytes and 64 entries per soul.
SOUL.md.backup File Mandatory timestamped backups created before any local modifications.

Soul Blocks Advanced Features

  • Automated soul reinforcement via scheduled cron jobs to maintain persona consistency over long-running sessions.
  • Support for both direct contract interaction through evm-wallet and user-friendly web fallbacks.
  • Seamless embodiment logic that forces the agent to adapt its voice and philosophy based on fragment analysis.
  • Integrated ownership verification and fragment capacity management for reliable on-chain operations.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*