Skip to content

GoPlausible/openclaw-algorand-plugin

Repository files navigation

OpenClaw Algorand Plugin

🔷 Algorand blockchain integration for OpenClaw — by GoPlausible

Features

  • Local MCP Server: Bundled algorand-mcp (99 tools) — wallet, transactions, smart contracts, TEAL, indexer, DEX, NFD, knowledge base
  • x402 Payment Protocol: Built-in x402_fetch tool for HTTP-native payments on Algorand
  • Interactive Setup: Guided wizard for configuration
  • Skills Included (6 skills):
    • algorand-development — AlgoKit CLI, project creation, general workflows
    • algorand-typescript — TypeScript smart contracts (PuyaTs)
    • algorand-python — Python smart contracts (PuyaPy)
    • algorand-interaction — Blockchain interaction via MCP (wallet, transactions, swaps, NFD)
    • algorand-x402-typescript — x402 payments in TypeScript
    • algorand-x402-python — x402 payments in Python

Installation

openclaw plugins install @goplausible/openclaw-algorand-plugin

Or install from local path:

openclaw plugins install ./path/to/openclaw-algorand-plugin

Post-Installation Setup

After installing, run these commands:

# 1. Initialize plugin (write memory file + configure mcporter)
openclaw algorand-plugin init

# 2. Run interactive setup (configure x402 toggle)
openclaw algorand-plugin setup

# 3. Restart the gateway
openclaw gateway restart

Commands

openclaw algorand-plugin init        # Write plugin memory + configure mcporter
openclaw algorand-plugin setup       # Run interactive setup wizard
openclaw algorand-plugin status      # Show plugin status (binary, mcporter, config)
openclaw algorand-plugin mcp-config  # Show MCP config snippet for external coding agents

MCP Server

The plugin bundles @goplausible/algorand-mcp as an npm dependency. It runs locally via stdio through mcporter.

  • 99 tools across 11 categories (wallet, transactions, algod, indexer, NFD, Tinyman, TEAL, knowledge base, and more)
  • Multi-network: mainnet, testnet, localnet
  • Secure wallet: Per-transaction and daily spending limits, private keys never exposed to agents

x402 Payment Protocol

When enableX402 is enabled (default), the plugin registers the x402_fetch tool — an HTTP fetch with x402 payment protocol support.

  • Fetches URLs normally; on HTTP 402, returns structured PaymentRequirements with step-by-step instructions
  • Agent builds payment using algorand-mcp wallet tools (atomic group with facilitator-sponsored fees)
  • Agent retries with signed PAYMENT-SIGNATURE header to complete the payment and access the resource

Configuration

Config is stored in ~/.openclaw/openclaw.json under plugins.entries.openclaw-algorand-plugin.config:

{
  "plugins": {
    "allow": ["openclaw-algorand-plugin"],
    "entries": {
      "openclaw-algorand-plugin": {
        "config": {
          "enableX402": true
        }
      }
    }
  }
}

Skills Overview

Skill Purpose
algorand-development AlgoKit CLI, project creation, general workflows
algorand-typescript TypeScript smart contracts (PuyaTs)
algorand-python Python smart contracts (PuyaPy)
algorand-interaction MCP-based blockchain interaction (wallet, txns, DEX, NFD, x402)
algorand-x402-typescript x402 payments in TypeScript
algorand-x402-python x402 payments in Python

Links

License

MIT © GoPlausible

About

Algorand Blockchain plugin for OpenClaw agent including Algorand Remote MCP lite edition (wallet edition), Algorand blockchain operations and x402 operations skills and tools.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors