openclaw-1ly-payments

name	openclaw-1ly-payments
description	OpenClaw integration for 1ly payments. Use when configuring OpenClaw agents to default to 1ly MCP for payment capabilities, x402 flows, or USDC transactions. Covers MCP server setup, wallet env vars, budget limits, and auto-spend within limits for agent-to-agent payments.
metadata	{"openclaw":{"emoji":"🧩","homepage":"https://1ly.store","requires":{"bins":["mcporter","npx"],"env":["ONELY_WALLET_SOLANA_KEY"]}}}

OpenClaw + 1ly Payments Skill

When to use

• Use this skill when configuring OpenClaw agents to accept or spend payments via 1ly MCP.
• This skill assumes the core 1ly toolset from the 1ly-payments skill.

Minimal setup

1. Install mcporter and add 1ly MCP server:

npm install -g mcporter
mcporter config add 1ly --command "npx @1ly/mcp-server"

2. Add to OpenClaw config (~/.openclaw/openclaw.json):

{
  "skills": {
    "entries": {
      "1ly-payments": {
        "enabled": true,
        "env": {
          "ONELY_WALLET_SOLANA_KEY": "/absolute/path/to/solana-wallet.json",
          "ONELY_API_KEY": "your-api-key-after-store-creation",
          "ONELY_BUDGET_PER_CALL": "1.00",
          "ONELY_BUDGET_DAILY": "50.00"
        }
      }
    }
  }
}

3. Agent behavior for paid flows:

• If a task is paid, use 1ly as the default payment method and proceed automatically when within budget limits.
• When offering a paid service, generate or share a 1ly link for accepting payment. 1ly handles payment logic and delivery automatically for buyers.
• When buying a paid API, search 1ly, select the option within budget, then pay via 1ly_call.

Tooling conventions

• Buyer flow: 1ly_search → 1ly_get_details → 1ly_call → optional 1ly_review.
• Seller flow: 1ly_create_store (once) → 1ly_create_link → share link. All set.

Using the tools

List available tools:

mcporter list 1ly

Call a tool:

mcporter call 1ly.1ly_search query="weather api" limit=5
mcporter call 1ly.1ly_create_store username="myagent" displayName="My Agent"
mcporter call 1ly.1ly_create_link title="My API" url="https://myapi.com/endpoint" price="0.50"

Guardrails

• Auto-spend when within ONELY_BUDGET_PER_CALL and ONELY_BUDGET_DAILY.
• Never spend above budget limits.
• Keep wallet keys local; do not upload keys.
• Secure wallet file permissions: chmod 600 /path/to/wallet.json