oneshot_skill

This skill enables autonomous agents to perform real world transactions such as email, calls, research, and commerce with built in x402 payments.

Python

2.5k

GitHub Stars

2

Bundled Files

2 months ago

Catalog Refreshed

3 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill openclaw/skills --skill oneshot

_meta.json275 B
SKILL.md7.8 KB

Overview

This skill provides the OneShot SDK for autonomous AI agents to execute real-world commercial transactions: send email, SMS, voice calls, perform research, enrich data, and make purchases with native x402 (USDC on Base) payments. It supports Coinbase CDP wallets (recommended for no private keys) or raw wallet private keys and includes utilities for inbox management, balance checks, and website builds. Use it when an agent must act in the real world and handle payments securely and auditable.

How this skill works

The SDK exposes high-level methods (email, sms, voice, research, findEmail, commerceBuy, build, getBalance, etc.) that an agent calls to perform external actions. Payments use x402 on Base; authentication can be via Coinbase CDP (server-side signing) or a raw private key or custom wallet provider. The SDK runs in test mode by default and returns structured results, costs, and error types for programmatic handling.

When to use it

When an agent must send transactional or marketing email autonomously
When an agent needs to place purchases or handle e-commerce tasks with on-chain payments
For agent-driven data enrichment: finding emails, verifying addresses, or scraping profiles
To automate outbound voice calls or SMS notifications with cost control
When you need research reports with citations or to build/modify websites programmatically

Best practices

Use Coinbase CDP wallet for production to avoid storing private keys on your server
Start in test mode (Base Sepolia) and fund test USDC before switching to production
Check getBalance before expensive actions and handle InsufficientBalanceError programmatically
Throttle bulk operations (bulk email, peopleSearch) and monitor costs returned by SDK
Capture and log SDK error types (ContentBlockedError, InsufficientBalanceError) for auditability and retry logic

Example use cases

Autonomous agent that onboards users: sends welcome email, verifies contact via SMS, and purchases a domain/hosting
Sales assistant agent: finds prospect emails, enriches profiles, schedules calls via voice, and logs transactions to a CRM
Research agent: runs deep research queries, returns a cited report, and bills the requester in USDC
E-commerce agent: searches products, purchases items within a max_price, and arranges shipping to a provided address
Developer tooling: run an MCP server to expose OneShot tools inside Claude Desktop or local agent platforms

FAQ

Use the Coinbase CDP wallet. It stores keys in a secure enclave, removes private-key management from your stack, and is the recommended production option.

How do I control costs and avoid unexpected charges?

Run in test mode first, check agent.getBalance before actions, set max_price limits for commerceBuy, and inspect returned cost metadata for each tool call to enforce budget rules.

Can I build a custom signer or integrate a different wallet?

Yes. Provide walletProvider with address and signTypedData implementation to bring your own signing flow while still using the SDK methods.