---

name: openclaw-1ly-payments description: 用于1ly支付的OpenClaw集成。在配置OpenClaw智能体以默认使用1ly MCP进行支付能力、x402流程、USDC交易或Solana代币发行/交易时使用。涵盖MCP服务器设置、钱包环境变量、预算限制以及智能体间支付的限额内自动支出。 metadata: {“openclaw”:{“always”:false,“emoji”:“🧩”,“homepage”:“https://1ly.store”,“requires”:{“bins”:[“npm”,“mcporter”,“npx”],“env”:[“ONELY_WALLET_SOLANA_KEY”,“ONELY_WALLET_EVM_KEY”,“ONELY_WALLET_PROVIDER”,“ONELY_BUDGET_PER_CALL”,“ONELY_BUDGET_DAILY”,“ONELY_BUDGET_STATE_FILE”,“ONELY_API_KEY”,“ONELY_SOLANA_RPC_URL”,“ONELY_NETWORK”,“ONELY_API_BASE”]},“configPaths”:[“~/.openclaw/openclaw.json”,“~/Library/Application Support/1ly/onely_api_key.json”,“~/.config/1ly/onely_api_key.json”],“notes”:“列出的所有环境变量均按工具条件性要求；钱包仅在进行付费操作时才需要；代币工具需要Solana钱包；对于Base（EVM）操作，建议使用Coinbase Agentic Wallet；ONELY_API_KEY仅限卖家使用。”}}

OpenClaw + 1ly 支付技能

使用场景

• 当配置OpenClaw智能体以通过1ly MCP接受或支出支付时，使用此技能。
• 此技能假定已具备来自 1ly-payments 技能的核心1ly工具集。
• 完整的环境变量参考表，请参见 1ly-payments → 环境变量。 元数据中列出的环境变量按工具条件性要求；没有全局必需的变量。

最小化设置

1. 安装mcporter并添加1ly MCP服务器：

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

验证包完整性： npm view @1ly/mcp-server dist.integrity

2. 添加到OpenClaw配置（~/.openclaw/openclaw.json）。仅在智能体需要支出时包含钱包/预算：

{
  "skills": {
    "entries": {
      "1ly-payments": {
        "enabled": true,
        "env": {
          "ONELY_WALLET_SOLANA_KEY": "/绝对路径/solana-wallet.json",
          "ONELY_BUDGET_PER_CALL": "1.00",
          "ONELY_BUDGET_DAILY": "50.00"
        }
      }
    }
  }
}

钱包文件规则：

• 钱包文件必须位于用户主目录或 /tmp 目录中。出于安全考虑，外部路径将被拒绝。
• 对于没有文件访问权限的沙盒化智能体，使用内联密钥：
  • ONELY_WALLET_SOLANA_KEY='[12,34,56,...]'
  • ONELY_WALLET_EVM_KEY='0x...'
• 对于Base支付，建议使用Coinbase Agentic Wallet：设置 ONELY_WALLET_PROVIDER=coinbase 并在应用中完成身份验证。除非必要，否则不要使用原始EVM密钥。

3. 付费流程中的智能体行为：

• 自主支出需通过智能体策略和明确的预算选择加入。
• 自主支出需要明确的预算（ONELY_BUDGET_PER_CALL, ONELY_BUDGET_DAILY）。
• 如果预算已设置且用户已选择加入，则将1ly作为默认支付方式，并在无需每次调用确认的情况下继续。
• 如果未设置预算，则在支出前要求用户设置预算。
• 当提供付费服务时，生成或分享一个1ly链接以接受付款。对于买家，1ly会自动处理支付逻辑和交付。
• 当购买付费API时，在1ly中搜索，选择预算范围内的选项，然后通过 1ly_call 支付。
• 使用 1ly_launch_token 及相关工具在Solana上进行代币操作。

工具使用约定

• 买家流程：1ly_search → 1ly_get_details → 1ly_call → 可选的 1ly_review。
• 卖家流程：1ly_create_store（一次）→ 1ly_create_link → 分享链接。全部完成。
• 代币流程（Bags.fm）：1ly_launch_token → 可选的 1ly_trade_quote → 1ly_trade_token → 1ly_claim_fees。
  • 需要Solana钱包和可靠的RPC。推荐：将 ONELY_SOLANA_RPC_URL 设置为您自己的提供商。默认为Solana公共主网RPC。

按类别划分的工具要求

• 免费工具（无需钱包）：1ly_search, 1ly_get_details
• 付费买家工具：1ly_call（需要Solana或Base钱包）
• 卖家工具：需要 ONELY_API_KEY
• 代币工具（Bags.fm）：需要 ONELY_WALLET_SOLANA_KEY，推荐 ONELY_SOLANA_RPC_URL

使用工具

列出可用工具：

mcporter list 1ly

调用工具：

mcporter call 1ly.1ly_search query="天气 api" limit=5
mcporter call 1ly.1ly_create_store username="myagent" displayName="我的智能体"
mcporter call 1ly.1ly_create_link title="我的API" url="https://myapi.com/endpoint" price="0.50" currency="USDC" isPublic=true
mcporter call 1ly.1ly_launch_token name="GOLDEN" symbol="GOLDEN" imageUrl="https://..." feeClaimers='[{ "provider": "twitter", "username": "abc", "bps": 1000 }]' share_fee=100

防护措施

• 仅在设置了 ONELY_BUDGET_PER_CALL 和 ONELY_BUDGET_DAILY 且在限额内时，才自动支出。
• 绝不超出预算限额支出。
• 钱包密钥保持本地存储；不要上传密钥。
• 安全的钱包文件权限：chmod 600 /path/to/wallet.json

工具输入（当前模式）

如果工具名称或参数不同，请使用 mcporter list 1ly --schema。

• 1ly_get_details: { "endpoint": "seller/slug" }
• 1ly_call: { "endpoint": "seller/slug", "method": "GET", "body": {...} }
• 1ly_create_store: { "username": "...", "displayName": "..." }
• 1ly_create_link: { "title": "...", "url": "https://...", "price": "1.00", "currency": "USDC", "isPublic": true }
• 1ly_update_avatar: { "avatarUrl": "https://..." } 或 { "imageBase64": "...", "mimeType": "image/png", "filename": "avatar.png" }
• 1ly_launch_token: { "name": "GOLDEN", "symbol": "GOLDEN", "imageUrl": "https://...", "feeClaimers": [{ "provider": "twitter", "username": "abc", "bps": 1000 }], "share_fee": 100 }
• 1ly_trade_quote: { "inputMint": "...", "outputMint": "...", "amount": "1000000", "slippageMode": "auto" }
• 1ly_trade_token: { "inputMint": "...", "outputMint": "...", "amount": "1000000", "slippageMode": "auto" }

来源

• GitHub: https://github.com/1lystore/1ly-mcp-server
• npm: https://www.npmjs.com/package/@1ly/mcp-server
• 文档: https://docs.1ly.store/

代币工具约束（Bags.fm）

• name 最多32个字符，symbol 最多10个字符，description 最多1000个字符。
• imageBase64 必须是原始base64且解码后 <= 15MB。
• 当 slippageMode=manual 时，slippageBps 范围 0-10000。

密钥存储（卖家工具）

ONELY_API_KEY 在 1ly_create_store 后保存在本地：

• macOS: ~/Library/Application Support/1ly/onely_api_key.json

• Linux: ~/.config/1ly/onely_api_key.json

• Windows: %APPDATA%\\1ly\\onely_api_key.json

• 如果您的环境无法写入这些路径，请安全地存储密钥并显式设置 ONELY_API_KEY。