A self-custodial SDK and CLI for automating crypto transfers, merchant payments via Bitrefill, and policy-driven wallet management.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install agentpay-sdk
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 agentpay-sdk 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 AgentPay SDK?
The AgentPay SDK is a robust framework designed for developers and AI agents to manage self-custodial crypto wallets and execute complex payment workflows. Built as an essential component of Openclaw Skills, it provides a local Rust-based daemon that handles keys, policy enforcement, and transaction broadcasting across EVM-compatible chains.
By using the AgentPay SDK, users can automate everything from native asset transfers to purchasing gift cards via Bitrefill, all while maintaining high security through local vault encryption and manual approval gates. It removes the complexity of designing command flows or policy objects from scratch, offering a deterministic operator playbook for agentic financial operations.
AgentPay SDK Use Cases
- Automating native and ERC-20 token transfers on EVM chains like BSC.
- Integrating crypto-to-gift card payments for traditional merchants using the Bitrefill plugin.
- Implementing secure, policy-based manual approval workflows for high-value transactions.
- Paying for AI services and APIs using the MPP (402) protocol without pre-funding accounts.
- Managing self-custodial wallets on macOS and Linux with automated backup and recovery paths.
How AgentPay SDK Works
- Initialize the environment by installing the agentpay CLI and bootstrapping the local daemon using provided scripts.
- Configure a self-custodial wallet using a secure local vault for key management, ensuring no sensitive credentials enter the chat interface.
- Define spending policies, such as daily limits or manual approval ranges, using the built-in TUI or administrative CLI commands.
- Trigger payment commands (transfer, buy, or mpp) which are automatically validated against the local policy engine.
- The local Rust daemon handles transaction signing and broadcasting to the blockchain once all policy and manual approval requirements are met.
AgentPay SDK Setup
Install the SDK using the one-click installer for macOS or Linux:
curl -fsSL https://wlfi.sh | bash
To install Openclaw Skills only without the full runtime:
curl -fsSL https://wlfi.sh | bash -s -- --skills-only
Initialize your local wallet (managed via macOS Keychain or Linux Secret Service):
agentpay admin setup
Check the wallet status to ensure funding is ready:
agentpay wallet --json
AgentPay SDK Data Schema & Taxonomy
The AgentPay SDK organizes its data across secure system storage and local configuration files to ensure high security and portability.
| Data Component | Management Method |
|---|---|
| Keys & Auth | Managed via macOS Keychain or Linux Secret Service |
| Wallet Vault | Encrypted local storage with support for offline backups |
| Policies | JSON configuration defining per-token limits and approval ranges |
| Approvals | Local UUID-based queue for pending manual transaction approvals |
| Plugins | Session and merchant metadata stored locally (e.g., Bitrefill integration) |
AgentPay SDK Advanced Features
- Multi-chain EVM support with optimized defaults for Binance Smart Chain (BSC) and USD1 assets.
- MPP (402) protocol integration for inline, keyless API payments across various LLM and search services.
- Bitrefill merchant payment flow for purchasing gift cards and prepaid cards directly via the CLI.
- Encrypted offline backup and restoration tools to prevent data loss across machine migrations.
- Interactive Policy TUI for real-time management of spending limits and transaction overrides.
- Native support for EIP-3009 signing and Tempo session-based escrow channels.
SKILL.md
Loading
Related Openclaw Skills
Awesome Design Skill
A professional UI design style selector that integrates over 50+ industry-leading design systems as development guides for AI coding agents.
CN Client Investigation
A specialized investigation skill for high-stakes analysis of mainland Chinese and Hong Kong entities with strict guards against data fabrication and character-level typos.
AI Image to Video — Convert Images Into Video Clips
A professional AI-powered animation tool that converts static images into high-quality 1080p video clips via a cloud-based rendering pipeline.
AgentYield
AgentYield is a high-performance observability layer that detects waste and optimizes costs for LLM and tool calls without compromising data privacy.
Openclaw Cron Standard
A standardization framework for OpenClaw cron wrappers and delivery contracts to ensure reliable, conflict-free automated agent execution.
Code Review Assistant
An intelligent auditing tool that automates the identification of bugs, security risks, and performance bottlenecks within pull requests.
Featured*
