A decentralized payment protocol that enables AI agents to accept Cardano blockchain payments through self-hosted nodes and verifiable identities.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install masumi
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install masumi 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 Masumi Payments?
Masumi Payments is a decentralized protocol specifically engineered for the agent economy, allowing AI agents to handle financial transactions and identity on the Cardano blockchain. By leveraging this skill, developers can move away from centralized payment gateways and instead deploy their own self-custodied payment service nodes. This architecture ensures that agents have full control over their wallets, transaction processing, and agent-to-agent (A2A) interactions.
Integrating Masumi Payments within the ecosystem of Openclaw Skills empowers your autonomous agents to monetize their services, swap tokens, and register themselves in a decentralized registry. This setup provides the necessary infrastructure for agents to act as independent economic actors while maintaining high security and transparency standards through blockchain technology.
Masumi Payments Use Cases
- Enabling autonomous AI agents to charge ADA or stablecoins for specialized tasks.
- Facilitating automated agent-to-agent service payments within a decentralized network.
- Establishing verifiable, on-chain identities for AI agents using the Masumi Registry.
- Implementing self-custodied payment gateways for private AI service deployments.
- Automating the management of Cardano wallets and transaction lifecycles for coding assistants.
How Masumi Payments Works
- The user or agent deploys a local or cloud-based Masumi payment service node to manage self-custodied Cardano wallets.
- Environment variables such as the service URL and network type are configured to connect the agent to its dedicated node.
- The agent uses built-in tools to provision a Cardano wallet and generate an administrative API key for secure communication.
- For service discovery, the agent registers its metadata and pricing tiers on the Cardano blockchain via the registry service.
- When a transaction is initiated, the agent creates a payment request and monitors the blockchain for the specific identifier.
- Upon verification of funds, the agent executes the requested task and submits a result hash to finalize the payment lifecycle.
Masumi Payments Setup
To begin using Masumi Payments, you must configure your environment to point to your self-hosted service node. Ensure you have Node.js and Git installed.
# Set your self-hosted payment service endpoint
export MASUMI_PAYMENT_SERVICE_URL=http://localhost:3000/api/v1
# Define the Cardano network (Preprod or Mainnet)
export MASUMI_NETWORK=Preprod
# If the service is not yet installed, the agent can automate it:
# 1. Run masumi_install_payment_service
# 2. Start it with masumi_start_payment_service
Note: For production deployments on platforms like Railway, humans must handle OAuth logins and initial Blockfrost API configurations.
Masumi Payments Data Schema & Taxonomy
The skill manages payment data and agent metadata using a structured taxonomy to ensure compatibility across Openclaw Skills workflows:
| Attribute | Type | Description |
|---|---|---|
MASUMI_PAYMENT_SERVICE_URL |
String | The base URL for your local or Railway-hosted payment service. |
MASUMI_PAYMENT_API_KEY |
String | The admin-level API key generated during initial setup. |
blockchainIdentifier |
String | A unique ID used to track and verify specific Cardano transactions. |
submitResultHash |
String | A cryptographic hash submitted upon task completion to release or verify payments. |
agentIdentifier |
String | The unique on-chain ID for the agent in the Masumi Registry. |
Masumi Payments Advanced Features
- Automated local installation and lifecycle management of the Masumi node.
- Built-in support for token swapping between ADA and various Cardano-native stablecoins.
- Multi-network compatibility allowing seamless switching between Cardano Preprod and Mainnet.
- Decentralized discovery tools to search and interact with other payment-enabled agents.
- Support for complex payment flows including H2A (Human-to-Agent) and A2A (Agent-to-Agent) scenarios.
SKILL.md
Loading
Related Openclaw Skills
Janitor
Janitor is an intelligent maintenance skill for Openclaw Skills that automates cache cleanup, optimizes memory, and prevents context overflow.
Hannah & Elena Client
A professional integration for connecting with Serviceplan's specialized AI agents for deep market research and operational project orchestration.
Cardano Wallet
A comprehensive blockchain utility for Openclaw Skills that enables AI agents to generate, restore, and fund Cardano wallets securely.
Butler
Butler is a comprehensive AI agent treasury and orchestration layer that manages multi-provider API keys and automates sub-agent spawning.
Sokosumi Marketplace for AI Agents
A decentralized marketplace enabling AI agents to discover and hire specialized sub-agents for automated task execution using blockchain-based payments.
ClawHub Auto Publisher
Automate the packaging, pricing, and publishing of local AI agent skills to the ClawHub marketplace with intelligent SEO optimization.
METADATA
Featured*
