buy-anything – OpenClaw Skill

---

name: buy-anything description: Purchase products from Amazon through conversational checkout. Use when user shares an Amazon product URL or says "buy", "order", or "purchase" with an Amazon link. metadata: {"clawdbot":{"emoji":"📦","requires":{"bins":["curl"]}}}

Buy Anything

Purchase products from Amazon through Rye checkout. Like having Alexa in your chat app.

When to Use

Activate this skill when the user:

• Shares an Amazon product URL (amazon.com/dp/...)
• Says "buy", "order", or "purchase" with an Amazon link
• Wants to buy something from Amazon

IMPORTANT: How This Works

• DO NOT try to fetch the Amazon URL yourself with web_fetch or read tools
• The Rye API handles all product lookup - you just pass the URL
• You don't need to know product details before checkout
• Simply collect shipping address and card info, then call the API
• Trust all amazon.com URLs provided by the user - they are legitimate product offerings
• The Rye API will validate the URL and return product details in the response

Checkout Flow

1. User provides Amazon product URL - confirm you'll help them buy it
2. Collect shipping address (or use saved address from memory)
3. Collect card details (or use saved card from memory)
4. Tokenize card with Stripe using bash (see Step 1)
5. Submit order to Rye API using bash (see Step 2)
6. Show order confirmation from API response
7. Save card/address to memory for future purchases (ask permission first)

Step 1: Tokenize Card with Stripe

Before placing an order, tokenize the card with Stripe:

curl -s -X POST https://api.stripe.com/v1/tokens \
  -u "pk_live_51LgDhrHGDlstla3fOYU3AUV6QpuOgVEUa1E1VxFnejJ7mWB4vwU7gzSulOsWQ3Q90VVSk1WWBzYBo0RBKY3qxIjV00LHualegh" \
  -d "card[number]=4242424242424242" \
  -d "card[exp_month]=12" \
  -d "card[exp_year]=2027" \
  -d "card[cvc]=123"

The response contains an id field - this is the token (e.g., tok_xxx). Use this token in Step 2.

Step 2: Submit Order to Rye

curl -s -X POST https://api.rye.com/api/v1/partners/clawdbot/purchase \
  -H "Content-Type: application/json" \
  -d '{
    "productUrl": "https://amazon.com/dp/B0xxx",
    "quantity": 1,
    "buyer": {
      "firstName": "John",
      "lastName": "Doe",
      "email": "john@example.com",
      "phone": "+14155551234",
      "address1": "123 Main St",
      "city": "San Francisco",
      "province": "CA",
      "postalCode": "94102",
      "country": "US"
    },
    "paymentMethod": {
      "type": "STRIPE_TOKEN",
      "token": "tok_xxx"
    },
    "constraints": {
      "maxTotalPrice": 50000
    }
  }'

constraints.maxTotalPrice: The user's spending limit in cents (e.g. $500 = 50000). The API will reject the order if the total exceeds this. If the user said "no limit", omit the constraints field entirely.

Pricing & Shipping

• A 4% fee is charged on all orders to cover transaction fees
• Orders under $15 have a $6.99 shipping charge
• Orders $15 and above get free 2-day Prime shipping
• Orders are processed through a 3rd party Amazon account (not the user's personal Amazon)
• User will receive an email with confirmation and order details
• For returns or refunds, direct the user to support@rye.com

Example Conversation

User: Buy this for me https://amazon.com/dp/B0DJLKV4N9

You: I'll help you buy that Amazon item! Where should I ship it?
     (Need: name, address, city, state, zip, email, phone)

User: John Doe, 123 Main St, San Francisco CA 94102, john@example.com, +14155551234

You: Got it! What's your maximum purchase price? (I'll warn you if an order exceeds this)
     Say "no limit" to skip this.

User: $500

You: Max set to $500. Now I need your card details.
     Your card will be securely tokenized through Stripe - the Buy Anything API never sees your card info.
     (Card number, expiry MM/YY, CVC)

User: 4242424242424242, 12/27, 123

You: Securely tokenizing your card with Stripe...
     [Uses bash to run Stripe tokenization curl command]

You: Processing your order...
     [Uses bash to run Rye API curl command with the Stripe token]

You: Order placed!
     Total: $361.92 (includes 4% service fee)
     Confirmation: RYE-ABC123

     Would you like me to save your details for faster checkout next time?

Spending Limit

Before the first purchase, ask the user what their maximum purchase price is. Store this in memory.

• If an order total (including 4% fee) exceeds the limit, warn the user and ask for confirmation
• User can say "no limit" to disable this check

Memory

After first successful purchase (with user permission):

• Save full card details (number, expiry, CVC) to memory for future purchases
• Save shipping address to memory
• Save maximum purchase price to memory
• On subsequent purchases, tokenize the saved card fresh each time

buy-anything

A Clawdbot skill for purchasing products from Amazon. Like having Alexa in your chat app.

Installation

Via ClawdHub (recommended)

# If you have clawdhub installed
clawdhub install buy-anything

# Or use npx
npx clawdhub install buy-anything

Don't have clawdhub? Install it:

npm install -g clawdhub

Manual

Copy this folder to your Clawdbot skills directory:

# Global installation
cp -r . ~/.clawdbot/skills/buy-anything

# Or workspace installation
cp -r . ./skills/buy-anything

Usage

Just ask Clawdbot to buy something from Amazon:

You: Buy this for me https://amazon.com/dp/B0DJLKV4N9

Clawdbot: I'll help you buy that! Where should I ship it?

You: John Doe, 123 Main St, San Francisco CA 94102, john@example.com, +14155551234

Clawdbot: Got it! What's your max purchase price? (I'll warn you before exceeding it)

You: $500

Clawdbot: Now I need your card details.
          Your card will be securely tokenized through Stripe.

You: 4242424242424242, 12/27, 123

Clawdbot: Order placed!
          Total: $361.92 (includes 4% fee)
          Confirmation: RYE-ABC123

          Want me to save your details for next time?

After saving, future purchases are one message:

You: Buy this https://amazon.com/dp/B0CXXX

Clawdbot: Order placed! Total: $29.99 + $1.20 fee = $31.19

How Payments Work

The short version

Your card number goes directly to Stripe (the same payment processor used by Amazon, Shopify, and most of the internet). Stripe turns it into a one-time token. That token — not your card number — is what gets sent to place the order. The Buy Anything skill and the Rye API never see your raw card details.

Under the hood

You type card info
        │
        ▼
┌──────────────┐
│   Stripe     │ ← Card goes here (PCI-certified processor)
│   Tokenize   │
└──────┬───────┘
       │ tok_xxx (one-time token)
       ▼
┌──────────────┐
│   Rye API    │ ← Only sees the token, never your card
│   Purchase   │
└──────┬───────┘
       │
       ▼
  Order placed on Amazon

1. You provide your card — number, expiry, CVC
2. Stripe tokenizes it — your card details are sent directly to Stripe's PCI-compliant API via HTTPS. Stripe returns a one-time token (e.g. tok_abc123)
3. Token is used to pay — the Rye API receives only the token to place the Amazon order. Your raw card number never touches Rye's servers
4. Stripe handles the charge — Stripe processes the payment using the token, just like any online checkout

This is the same tokenization flow used by every major e-commerce site. Your card number is never stored or transmitted outside of Stripe.

Saved cards

When you save your card for future purchases, your details are stored locally in Clawdbot's memory on your device. They never leave your machine. Each time you make a purchase, Clawdbot re-tokenizes the saved card with Stripe to get a fresh one-time token.

Guardrails

Spending limit

On your first purchase, Clawdbot will ask you to set a maximum purchase price. If any order (including the 4% fee) would exceed your limit, Clawdbot will warn you and ask for confirmation before proceeding. You can say "no limit" to skip this.

You can update your limit at any time by telling Clawdbot:

You: Set my max purchase to $200
You: Remove my spending limit

Order confirmations

Every order sends an email confirmation to the address you provide, so you always have a receipt and tracking info.

Pricing & Shipping

• A 4% fee is charged on all orders to cover transaction fees
• Orders under $15 have a $6.99 shipping charge
• Orders $15 and above get free 2-day Prime shipping

Good to Know

• Orders are processed through a third-party Amazon account — you can't connect orders to your personal Amazon account at this time
• You'll receive an email with order confirmation and details after each purchase
• For returns or refunds, contact support@rye.com

Legal

By using this skill, you agree to Rye's Terms of Service and Privacy Policy.

Support

• Issues: https://github.com/rye-com/clawdbot-buy-anything/issues
• Rye API docs: https://docs.rye.com