# Send Locus to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/locus",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=locus",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/setup.sh"
    ],
    "downloadMode": "redirect",
    "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### Locus Payment Skill

Locus connects AI agents to crypto wallets via MCP. Tools are dynamic — each user gets different tools based on their permission group.

### Setup (Agent-Guided)

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:

### Step 1: Check if mcporter is installed

command -v mcporter || npm i -g mcporter

### Step 2: Check if Locus is already configured

mcporter config get locus 2>/dev/null

If configured, skip to Usage. If the user wants to reconfigure, run:

mcporter config remove locus

### Step 3: Ask the user for their API key

Tell them:

You'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.

Wait for the user to provide their key. It should start with locus_. If it doesn't, warn them and confirm before proceeding.

### Step 4: Configure mcporter

mcporter config add locus \\
  --url "https://mcp.paywithlocus.com/mcp" \\
  --header "Authorization=Bearer <API_KEY>" \\
  --scope home

### Step 5: Verify the connection

mcporter list locus

If 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.

### Alternative: Script-based setup

Users can also run the setup script directly from the Clawdbot workspace root:

bash skills/locus/scripts/setup.sh

### Usage

Always discover available tools first:

mcporter list locus --schema

This 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.

Call any discovered tool:

mcporter call locus.<tool_name> param1=value1 param2=value2

For array/object parameters:

mcporter call locus.<tool_name> --args '{"key": "value"}'

### Email → Payment Flow

Scan inbox for payment-related emails (invoices, bills, splits, reimbursements)
Identify actionable items with amounts, recipients, and context
Summarize findings to user
On user approval, execute payments via available tools
Always confirm with user before sending any payment

### Safety Rules

Never send payments without explicit user confirmation
Always show: recipient, token, amount, and memo before executing
Check available balance before attempting payments
Double-check recipient addresses — typos mean lost funds
Confirm large payments (>$100) with extra care
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: cdermott7
- Version: 1.3.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T12:02:04.539Z
- Expires at: 2026-05-07T12:02:04.539Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/locus)
- [Send to Agent page](https://openagent3.xyz/skills/locus/agent)
- [JSON manifest](https://openagent3.xyz/skills/locus/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/locus/agent.md)
- [Download page](https://openagent3.xyz/downloads/locus)