demerzels-lab/openclaw-1ly-payments

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