{
  "schemaVersion": "1.0",
  "item": {
    "slug": "locus",
    "name": "Locus",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/cdermott7/locus",
    "canonicalUrl": "https://clawhub.ai/cdermott7/locus",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/locus",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=locus",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/setup.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "locus",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T12:02:04.539Z",
      "expiresAt": "2026-05-07T12:02:04.539Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=locus",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=locus",
        "contentDisposition": "attachment; filename=\"locus-1.3.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "locus"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/locus"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/locus",
    "agentPageUrl": "https://openagent3.xyz/skills/locus/agent",
    "manifestUrl": "https://openagent3.xyz/skills/locus/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/locus/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Locus Payment Skill",
        "body": "Locus connects AI agents to crypto wallets via MCP. Tools are dynamic — each user gets different tools based on their permission group."
      },
      {
        "title": "Setup (Agent-Guided)",
        "body": "When the user asks to set up Locus, use payments, or anything payment-related — check if Locus is configured and walk them through setup interactively:"
      },
      {
        "title": "Step 1: Check if mcporter is installed",
        "body": "command -v mcporter || npm i -g mcporter"
      },
      {
        "title": "Step 2: Check if Locus is already configured",
        "body": "mcporter config get locus 2>/dev/null\n\nIf configured, skip to Usage. If the user wants to reconfigure, run:\n\nmcporter config remove locus"
      },
      {
        "title": "Step 3: Ask the user for their API key",
        "body": "Tell them:\n\nYou'll need a Locus API key to connect your wallet. Get one at https://app.paywithlocus.com — each key is tied to your wallet and permission group. Paste it here when you're ready.\n\nWait for the user to provide their key. It should start with locus_. If it doesn't, warn them and confirm before proceeding."
      },
      {
        "title": "Step 4: Configure mcporter",
        "body": "mcporter config add locus \\\n  --url \"https://mcp.paywithlocus.com/mcp\" \\\n  --header \"Authorization=Bearer <API_KEY>\" \\\n  --scope home"
      },
      {
        "title": "Step 5: Verify the connection",
        "body": "mcporter list locus\n\nIf tools appear, setup is complete — tell the user they're ready. If it fails, ask them to double-check their API key and try again."
      },
      {
        "title": "Alternative: Script-based setup",
        "body": "Users can also run the setup script directly from the Clawdbot workspace root:\n\nbash skills/locus/scripts/setup.sh"
      },
      {
        "title": "Usage",
        "body": "Always discover available tools first:\n\nmcporter list locus --schema\n\nThis returns all tools the user's permission group allows. Tools vary per user — do not assume which tools exist. Use the schema output to understand parameters.\n\nCall any discovered tool:\n\nmcporter call locus.<tool_name> param1=value1 param2=value2\n\nFor array/object parameters:\n\nmcporter call locus.<tool_name> --args '{\"key\": \"value\"}'"
      },
      {
        "title": "Email → Payment Flow",
        "body": "Scan inbox for payment-related emails (invoices, bills, splits, reimbursements)\nIdentify actionable items with amounts, recipients, and context\nSummarize findings to user\nOn user approval, execute payments via available tools\nAlways confirm with user before sending any payment"
      },
      {
        "title": "Safety Rules",
        "body": "Never send payments without explicit user confirmation\nAlways show: recipient, token, amount, and memo before executing\nCheck available balance before attempting payments\nDouble-check recipient addresses — typos mean lost funds\nConfirm large payments (>$100) with extra care"
      }
    ],
    "body": "Locus Payment Skill\n\nLocus connects AI agents to crypto wallets via MCP. Tools are dynamic — each user gets different tools based on their permission group.\n\nSetup (Agent-Guided)\n\nWhen the user asks to set up Locus, use payments, or anything payment-related — check if Locus is configured and walk them through setup interactively:\n\nStep 1: Check if mcporter is installed\ncommand -v mcporter || npm i -g mcporter\n\nStep 2: Check if Locus is already configured\nmcporter config get locus 2>/dev/null\n\n\nIf configured, skip to Usage. If the user wants to reconfigure, run:\n\nmcporter config remove locus\n\nStep 3: Ask the user for their API key\n\nTell them:\n\nYou'll need a Locus API key to connect your wallet. Get one at https://app.paywithlocus.com — each key is tied to your wallet and permission group. Paste it here when you're ready.\n\nWait for the user to provide their key. It should start with locus_. If it doesn't, warn them and confirm before proceeding.\n\nStep 4: Configure mcporter\nmcporter config add locus \\\n  --url \"https://mcp.paywithlocus.com/mcp\" \\\n  --header \"Authorization=Bearer <API_KEY>\" \\\n  --scope home\n\nStep 5: Verify the connection\nmcporter list locus\n\n\nIf tools appear, setup is complete — tell the user they're ready. If it fails, ask them to double-check their API key and try again.\n\nAlternative: Script-based setup\n\nUsers can also run the setup script directly from the Clawdbot workspace root:\n\nbash skills/locus/scripts/setup.sh\n\nUsage\n\nAlways discover available tools first:\n\nmcporter list locus --schema\n\n\nThis returns all tools the user's permission group allows. Tools vary per user — do not assume which tools exist. Use the schema output to understand parameters.\n\nCall any discovered tool:\n\nmcporter call locus.<tool_name> param1=value1 param2=value2\n\n\nFor array/object parameters:\n\nmcporter call locus.<tool_name> --args '{\"key\": \"value\"}'\n\nEmail → Payment Flow\nScan inbox for payment-related emails (invoices, bills, splits, reimbursements)\nIdentify actionable items with amounts, recipients, and context\nSummarize findings to user\nOn user approval, execute payments via available tools\nAlways confirm with user before sending any payment\nSafety Rules\nNever send payments without explicit user confirmation\nAlways show: recipient, token, amount, and memo before executing\nCheck available balance before attempting payments\nDouble-check recipient addresses — typos mean lost funds\nConfirm large payments (>$100) with extra care"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/cdermott7/locus",
    "publisherUrl": "https://clawhub.ai/cdermott7/locus",
    "owner": "cdermott7",
    "version": "1.3.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/locus",
    "downloadUrl": "https://openagent3.xyz/downloads/locus",
    "agentUrl": "https://openagent3.xyz/skills/locus/agent",
    "manifestUrl": "https://openagent3.xyz/skills/locus/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/locus/agent.md"
  }
}