OpenClaw + 1ly Payments Skill

适用场景

• 当需配置 OpenClaw 智能体通过 1ly MCP 接收或支出款项时，使用本 Skill。
• 本 Skill 依赖 1ly-payments Skill 提供的核心 1ly 工具集。
• 完整环境变量参考表，请参阅 1ly-payments → Environment variables。 元数据中列出的环境变量按工具条件生效；无任何全局必需变量。

最小化配置步骤

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": "/absolute/path/to/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_search，在预算范围内选择目标服务，再通过 1ly_call 完成支付。
• 在 Solana 上执行代币相关操作时，请使用 1ly_launch_token 及其配套工具。

工具使用惯例

• 买家流程：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 设置自有 RPC 地址；默认使用 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="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" 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

工具输入参数（当前 Schema）

若工具名称或参数存在差异，请运行 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 编码，解码后大小不得超过 15 MB。
• 当 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 环境变量。