OneShot provides the infrastructure for autonomous AI agents to execute real-world commercial transactions using native x402 payments.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install oneshot-agent
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 oneshot-agent 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 OneShot?
OneShot is a comprehensive SDK and MCP server designed to bridge the gap between AI agents and real-world actions. By utilizing x402 payments—specifically USDC on the Base network—this tool allows agents to autonomously handle tasks like sending emails, making voice calls, conducting deep research, and even purchasing physical products. It is a vital addition for developers building with Openclaw Skills who require their agents to have economic agency without the friction of traditional API keys.
The system leverages the agent's own wallet private key to sign transactions, ensuring a decentralized and streamlined workflow for commercial interactions. Whether you are building a sales bot or an automated research assistant, OneShot enables your agent to operate as a first-class economic citizen on the web, making it a cornerstone for advanced Openclaw Skills development.
OneShot Use Cases
- Automating outbound sales via email and SMS with personalized, autonomous content.
- Scheduling meetings and conducting follow-ups using AI-driven voice calls.
- Performing deep market research and data enrichment for lead generation and competitive analysis.
- Enabling AI agents to procure hardware, office supplies, or software subscriptions autonomously.
- Building and updating landing pages for new products through simple agent instructions.
How OneShot Works
- The developer installs the OneShot SDK or MCP server into their agentic environment.
- An agent's wallet is funded with USDC on the Base network (or Base Sepolia for testing purposes).
- The ONESHOT_WALLET_PRIVATE_KEY is configured as an environment variable to allow the agent to sign transactions.
- The agent calls specific SDK methods such as email, voice, or commerceBuy to trigger real-world actions.
- Each transaction is automatically signed and paid for using x402 protocols, with small micro-payments deducted directly from the agent's balance.
OneShot Setup
Install the SDK via npm to start building your Openclaw Skills integration:
npm install @oneshot-agent/sdk
Set your environment variable to authorize the agent's wallet:
export ONESHOT_WALLET_PRIVATE_KEY="0xYourPrivateKey"
For MCP usage in Claude Code or Cursor, add the following to your configuration:
{
"mcpServers": {
"oneshot": {
"command": "npx",
"args": ["-y", "@oneshot-agent/mcp-server"],
"env": {
"ONESHOT_WALLET_PRIVATE_KEY": "0xYourPrivateKey"
}
}
}
}
OneShot Data Schema & Taxonomy
OneShot manages data through structured responses for various commercial actions, making it easy to integrate into complex Openclaw Skills workflows.
| Method | Key Data Points | Output Format |
|---|---|---|
| Research | Query, depth, report content, sources | JSON Object with Citations |
| Commerce | Product URL, shipping address, max price | Transaction Receipt |
| Data Enrichment | Name, company, LinkedIn URL | Profile JSON |
| Communications | Recipient, subject, body content | Delivery Status & ID |
OneShot Advanced Features
- Native support for MCP (Model Context Protocol) to use tools seamlessly in IDEs like Claude and Cursor.
- Integration with Soul.Markets for agent monetization and instant USDC payouts.
- Deep research capabilities that provide comprehensive reports with automatic citation generation.
- Built-in error handling for complex scenarios like InsufficientBalanceError or ContentBlockedError.
- Bulk communication support for sending high-volume, personalized emails or SMS messages.
- Flexible testing environment using the Base Sepolia testnet to validate Openclaw Skills before production deployment.
SKILL.md
Loading
Related Openclaw Skills
Tork Guardian for OpenClaw
Tork Guardian provides an enterprise-grade security and governance layer to protect, monitor, and audit Openclaw Skills and AI agents.
Agent MBTI Personality Diagnosis & Optimization
A comprehensive system for diagnosing AI agent MBTI personality types and automatically optimizing their configuration to match user expectations.
Agent MBTI Personality Diagnosis
A framework for diagnosing and adjusting AI Agent personalities using the MBTI psychological model to align behavior with user expectations.
IMAP IDLE Listener
An event-driven email monitoring skill that replaces periodic polling with instant push notifications to trigger Openclaw Skills workflows.
Binance Pro
A professional integration for Binance enabling spot and futures trading, leverage management, and real-time portfolio tracking.
Crypto Self-Learning
An AI-powered framework that captures trade context and converts performance data into actionable trading rules.
Featured*
