openclaw-paid-actions

What This Skill Does

The openclaw-paid-actions skill serves as a secure gateway for monetizing agent capabilities. It provides a robust framework to enforce payment before executing specific tasks. By integrating with the Solana blockchain, the skill generates USDC invoices, tracks on-chain payment status, and only unlocks task execution once a valid payment transaction is verified. This ensures that the agent's computing resources and specialized services are protected against unauthorized use while providing a seamless, automated checkout experience for end-users.

Installation

To integrate this skill into your OpenClaw environment, ensure your Node.js runtime is at least version 20. Install the skill via the ClawHub CLI using the command: clawhub install openclaw/skills/skills/icetroll/openclaw-paid-actions. Once installed, you must populate the environment variables in your plugin configuration. Required fields include the OPENCLAW_USDC_PAY_TO address for your wallet and the OPENCLAW_PAID_ACTIONS_INVOICE_SECRET for cryptographically signing payment requests. Ensure the invoiceStorePath is configured to allow the agent to track payment state across sessions, and confirm that all paid scripts are safely located within the reviewedScriptsRoot directory to prevent arbitrary code execution.

Use Cases

This skill is ideal for service-oriented AI agents. Use it to monetize social media management (e.g., paid shoutouts on X), gated data generation (e.g., specialized market reports or API lookups), or to recoup costs for high-compute tasks that involve third-party API consumption. It allows agents to act as independent micro-service providers, charging USDC for specific, discrete operations.

Example Prompts

1. "List the available paid actions I can use to monetize my agent services today."
2. "I need to send a shoutout on X, please generate an invoice for the x-shoutout action so I can process the payment."
3. "I have just sent the USDC payment for invoice ID INV-12345, here is the transaction signature: 5vjK... please confirm the payment and execute the task."

Tips & Limitations

To maintain high security, the allowRunAsRoot configuration is disabled by default; keep it that way to minimize system risk. Always use the confirm action with a verified transaction signature to prevent replay attacks. Note that the agent relies on the Solana network's speed for confirmation, so users should be advised to wait for a few confirmations before expecting the execute action to trigger. The maxOutputBytes limit prevents potential memory issues if your scripts return large datasets, so ensure your paid scripts are optimized for performance.