介绍
# Locus Payment Skill
Locus 通过 MCP 将 AI 代理连接到加密钱包。工具是**动态**的——每个用户根据其权限组获得不同的工具。
## 设置（代理引导）
当用户要求设置 Locus、使用支付功能或任何与支付相关的事项时——请检查 Locus 是否已配置，并通过交互方式引导他们完成设置：
### 步骤 1：检查是否安装了 mcporter ```bash command -v mcporter || npm i -g mcporter ```
### 步骤 2：检查 Locus 是否已配置 ```bash mcporter config get locus 2>/dev/null ``` 如果已配置，请跳至**使用**。如果用户想要重新配置，请运行： ```bash mcporter config remove locus ```
### 步骤 3：询问用户的 API 密钥 告诉他们： > 您需要一个 Locus API 密钥来连接您的钱包。请访问 **https://app.paywithlocus.com** 获取——每个密钥都绑定到您的钱包和权限组。准备好后将其粘贴到这里。
等待用户提供其密钥。它应该以 `locus_` 开头。如果不是，请警告他们并在继续之前确认。
### 步骤 4：配置 mcporter ```bash mcporter config add locus \ --url "https://mcp.paywithlocus.com/mcp" \ --header "Authorization=Bearer <API_KEY>" \ --scope home ```
### 步骤 5：验证连接 ```bash mcporter list locus ``` 如果出现工具，则设置完成——告诉他们已准备就绪。如果失败，请让他们仔细检查其 API 密钥并重试。
### 替代方案：基于脚本的设置 用户也可以直接从 Clawdbot 工作区根目录运行设置脚本： ```bash bash skills/locus/scripts/setup.sh ```
## 使用
**始终先发现可用工具：** ```bash mcporter list locus --schema ```
这将返回用户权限组允许的所有工具。工具因用户而异——不要假设存在哪些工具。使用 schema 输出来了解参数。
**调用任何已发现的工具：** ```bash mcporter call locus.<tool_name> param1=value1 param2=value2 ```
对于数组/对象参数： ```bash mcporter call locus.<tool_name> --args '{"key": "value"}' ```
## 邮件 → 支付流程
1. 扫描收件箱中与支付相关的邮件（发票、账单、分摊、报销） 2. 识别包含金额、收款人和上下文的可操作项目 3. 向用户总结发现结果 4. 经用户批准后，通过可用工具执行支付 5. **发送任何支付之前务必与用户确认**
## 安全规则
- **未经明确用户确认，绝不发送付款** - 执行前始终显示：收款人、代币、金额和备注 - 尝试付款前检查可用余额 - 再次检查收款地址——拼写错误意味着资金丢失 - 对大额支付（>$100）进行额外确认