Maestro SDK Vault Agent for Openclaw

An AI agent skill powered by the Maestro SDK that operates Solana policy-controlled vaults for secure, automated asset management.

yamancan
v0.1.0
Mar 9, 2026
0
980
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install maestro-sdk

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 maestro-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 Maestro SDK Vault Agent?

The Maestro SDK skill enables AI agents to function as operators for Solana vaults rather than simple wallet holders. By leveraging the @trionlabs/maestro-sdk, agents can manage funds within a Program Derived Address (PDA), ensuring that all transactions follow strict policy-controlled workflows. This Openclaw Skills integration allows for professional-grade treasury management where the agent handles gas fees while the primary assets remain protected within the vault infrastructure.

This skill is essential for developers building autonomous agents that require high security and granular control over token transfers and swaps. It automates the discovery of vaults and session keys, enforces health checks before any financial activity, and provides a robust framework for interacting with the Maestro policy engine on the Solana blockchain.

Maestro SDK Vault Agent Use Cases

  • Automating secure USDC transfers from a policy-controlled vault to whitelisted recipients.
  • Managing decentralized treasury operations where an AI agent acts as a restricted operator.
  • Performing automated token swaps via DEX integrations within vault-defined spending limits.
  • Monitoring vault health and session key validity to ensure continuous, uninterrupted agent performance.
  • Implementing daily spending trackers and recipient-specific transaction policies for AI-driven payments.

How Maestro SDK Vault Agent Works

  1. The agent initializes by loading or generating a unique Solana keypair to establish its identity.
  2. Upon loading, the agent automatically identifies its public key and prompts the user to link it as a session key within the Maestro app.
  3. The discoverVaults function scans the blockchain to locate vaults and session keys associated with the agent's public key.
  4. Before any transaction, the agent performs a mandatory health check to verify SOL for gas, vault status, and session key expiration.
  5. For payments, the agent resolves recipient accounts against the vault's whitelist and executes transfers via the executeTransfer method.
  6. The agent persists all state changes, including vault addresses and trusted owners, to a local memory file for consistent cross-session operation.

Maestro SDK Vault Agent Setup

To integrate this skill into your environment, install the required SDK and configure your Solana environment:

# Install the Maestro SDK
pnpm add @trionlabs/maestro-sdk

# Set your environment variable for the agent key
export SOLANA_PRIVATE_KEY='your_secret_key_here'

The agent will automatically create a configuration at ~/.maestro/agent-keypair.json if no key is provided. Ensure the agent has at least 0.05 SOL for transaction fees.

Maestro SDK Vault Agent Data Schema & Taxonomy

The Maestro SDK skill maintains a structured memory format to track the agent's operational state and transaction history:

Data Point Description
Pubkey The Solana public key of the AI agent operator.
Vault Address The PDA address of the policy-controlled vault.
Trusted Owners A list of verified public keys authorized to manage the vault.
Tracker PDA Daily UTC-based tracker for enforcing spending limits.
Session Key The specific key providing temporary transaction authority.

All significant events and transaction signatures are logged in memory/YYYY-MM-DD.md for auditing.

Maestro SDK Vault Agent Advanced Features

  • Multi-lane transaction support including executeTransfer, executeSwap, and executeAction.
  • Daily spending tracker initialization (initTracker) to automate UTC-based limit resets.
  • Automated error parsing for specific vault policy violations like CooldownActive or DailyLimitExceeded.
  • Persistent trusted owner verification to prevent unauthorized vault interactions.
  • Integrated health check system that blocks transactions during critical failures (e.g., frozen vaults or insufficient gas).

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*