Selva is a specialized shopping platform designed for AI agents to search, compare, and purchase physical products directly from Amazon.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install selva
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 selva 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 Selva?
Selva empowers your AI environment with the ability to navigate the physical commerce world. As part of the growing ecosystem of Openclaw Skills, it provides a streamlined interface for AI agents to interact with Amazon, offering high-quality search results, detailed product specifications, and a secure checkout process. This skill bridges the gap between digital reasoning and physical procurement by handling everything from product discovery to order fulfillment with developer-centric efficiency.
The skill is built with an outcome-first messaging philosophy, ensuring that AI agents remain concise and human-like during interactions. By utilizing local API key storage and secure payment tokenization, it maintains a high standard of security while enabling powerful automation for shopping tasks.
Selva Use Cases
- Automated procurement of hardware or office supplies based on agent-detected needs.
- Integration into research workflows to provide real-time pricing and delivery estimates for project components.
- Comparison shopping across Amazon using unique product identifiers within Openclaw Skills.
- Controlled purchasing environments where agents propose buys that require human email approval.
How Selva Works
- Registration: The agent initializes the environment by generating a secure API key stored locally at ~/selva/config.json.
- Profile Setup: Essential metadata such as shipping address and user name are configured via the CLI to enable localized search results.
- Product Search: The agent queries Amazon to retrieve up to 10 normalized results, including pricing, ratings, and delivery estimates.
- Selection: Detailed product specifications are fetched using a unique provider ID (e.g., amzn_ prefix).
- Transaction: The agent initiates a purchase using a saved card or a Stripe-tokenized payment method.
- Verification: If configured, the system triggers an approval flow for purchases exceeding a set price threshold before final processing.
Selva Setup
Install and configure the skill using the following commands:
# Register the agent and generate an API key
npx selva-cli register
# Set required user information
npx selva-cli settings set-name --name "Jane Doe"
npx selva-cli settings set-address --street "123 Main St" --city "Austin" --state "TX" --zip "78701" --country "US"
# Link a payment method via the secure web page
npx selva-cli settings page
Selva Data Schema & Taxonomy
Selva organizes data using a structured taxonomy for both local configuration and remote product retrieval:
| Component | Description |
|---|---|
| Local Config | Stores API keys and user preferences at ~/selva/config.json. |
| selva_id | Unique identifiers prefixed by provider (e.g., amzn_ for Amazon). |
| Search Schema | Includes title, price, rating, delivery_estimate, and image_url. |
| Order Status | Tracked via states: awaiting_approval, processing, and shipping. |
Selva Advanced Features
- Human-in-the-loop Approvals: Set specific spending thresholds that trigger mandatory email approvals for agent-initiated purchases.
- Stripe Integration: Secure payment tokenization ensures sensitive credit card information never touches the skill's primary API.
- Concise UX Design: Optimized for Openclaw Skills to prefer separate photo messages and captions for a better chat-based shopping experience.
- Normalized Delivery Data: Always provides real-time 'get-it-by' estimates to inform agent decision-making.
SKILL.md
Loading
Related Openclaw Skills
agentscale
Deploy web applications and APIs to public URLs instantly using a single CLI command.
Social Poster
An automation skill for AI agents to publish content and status updates to Twitter/X and other social platforms via the VibePost API.
Simulated Road Trip
An automated travel simulator that generates GPS-accurate narrated road trips for AI agents using the Turai API.
QuackGram
A cross-platform relay system for sending and receiving messages between autonomous AI agents.
Hetzner Cloud CLI (hcloud)
The official command-line interface for managing high-performance Hetzner Cloud resources including servers, networks, volumes, and load balancers.
Memory Manager
A smart documentation agent that captures critical infrastructure and project changes at the end of every session while filtering out irrelevant noise.
Featured*
