Canopy Deposits

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install canopy-deposits
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 canopy-deposits。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Canopy Deposits 将 AI agent 连接到 Canopy 的远程 MCP 服务器，以准备商户账户的加密货币充值，检索资金融通选项和地址，并报告检测与结算状态。它是用于协调人工资金流而无需自行处理区块链交易的 Openclaw Skills 之一：人类用户通过 Canopy 结账页面或从他们自己的钱包进行充值。
该 Skill 优先使用准确的、特定于账户的信息。它使用工具返回的资产、网络、最小值和结算详情，而不是凭空猜测，并且不会签名或提交交易。Openclaw Skills 用户可以使用它来引导充值，从创建意图到进行状态检查，同时将凭据保存在 MCP 客户端的安全配置中。

应用场景

当用户请求为商户账户充值时，准备一个新的开放金额或固定金额加密货币充值。
分享托管结账链接，作为直接的人工充值选项。
在用户选择可用的充值选项后提供直接充值地址。
检查现有意图的检测、转账或结算进度。
在重试前查找现有充值或调查创建超时。
解释返回的最小值、手续费、净额或未达最小值的补足要求。

工作原理

将 MCP 客户端连接到 Canopy 的远程服务器，并使用 OAuth 或安全配置的服务端 Canopy secret key 进行身份验证。
确认服务器暴露了所需的五个工具：create_deposit、list_deposit_options、get_deposit_address、get_deposit_status 和 list_deposits。
对于新充值，从用户或应用中确定目的地。仅在提供时传递目的地字段；切勿猜测接收方钱包。
对于固定金额，使用现有意图的结算轨道标识标记为 default: true 的轨道及其小数位数。将金额转换为正基数单位整数字符串；如果所需的结算配置不可用，请询问用户而不是猜测。
使用支持的输入调用 create_deposit。保留返回的意图 ID 和托管结账 URL。开放金额充值省略 priceUnits；oneTime: true 需要该字段。
对于直接充值，检索此意图的选项，向用户展示可用的链、Token 和最小值，并且仅在选项标记为 depositIssuable: true 时继续。
使用选项完全返回的 caip19 请求地址。展示完整地址及其返回的链名称、Token 符号和最小值，并告知用户在该网络上发送该 Token。
当被询问进度时，读取意图状态并报告实际检测和单笔转账阶段。仅凭检测并不意味着已结算；需包含相关手续费或净额信息，并解释任何低于最小值的状态。

配置指南

配置 MCP 客户端以使用 Canopy 的 Streamable HTTP 端点：https://www.canopypay.io/api/mcp。保留 www. 主机名；顶层域名可能会跨主机重定向并丢弃授权头。
通过客户端的 OAuth 流程进行身份验证，或通过客户端的环境或凭据配置安全地提供 Canopy secret key。OAuth 使用带有 PKCE 的授权码，并支持动态注册。
确保凭据具有所需的 payment_intents:create 权限范围。Publishable keys 无法用于 MCP 身份验证。
验证工作流中列出的五个工具是否可用。该端点接受 POST 请求和 JSON 响应；它不支持传统的 SSE。GET 或 DELETE 返回 HTTP 405 是符合预期的。
切勿在聊天中请求密钥或将凭据提交至配置文件中。如果连接缺失，请要求账户所有者通过其 MCP 客户端进行连接；切勿伪造凭据或访问其他商户账户。
Documentation: https://www.canopypay.io/agents/mcp
Plain-text contract: https://www.canopypay.io/agents/mcp/raw
Canopy 是免费集成的，但这并不意味充值、兑换、区块链手续费或结算是免费的。当涉及成本时，请参考工具返回结果和 Canopy 当前的定价。

数据架构

该 Skill 适用于 Canopy 的 MCP 工具返回的结构化结果。读取 structuredContent；某些客户端可能会通过文本内容暴露等效的 JSON。输入要求非常严格，未知的字段将被拒绝。
Tool Purpose Key inputs or outputs
create_deposit 创建或重用支付意图 可选的 priceUnits、oneTime、merchantReference、metadata 以及目的地字段；保留返回的 intentId 和 hostedPageUrl
list_deposit_options 检索意图的充值选项、最小值和结算轨道 intentId；使用返回的选项数据和标记为 default: true 的轨道
get_deposit_address 签发或返回地址并开始对某个选项进行检测 intentId 以及完全返回的 caip19
get_deposit_status 读取检测以及转账或结算状态 intentId；报告实际返回的阶段和相关手续费或净额数据
list_deposits 列出属于已身份验证账户的意图 可选的 limit 和 cursor
充值记录和相关元数据包含 Canopy 返回的意图条款、目的地详情以及充值或结算状态。目的地字段包括 payoutWallet、payoutNamespace 和 payoutChainReference；当提供了目的地钱包时，payoutTokenAddress 是可选的。切勿推断不支持的字段，也不要添加手续费或资金库输入。
活动意图可以重新用于匹配的账户、目的地和条款。重用的结果具有 created: false；新的 merchantReference 和 metadata 值不会被应用。不同的金额或一次性条款可能会产生 idempotency_key_reuse。如果没有目的地字段，每次创建都会生成一个新意图。超时后，在再次尝试创建之前先检查账户的充值。对同一意图和选项重复请求地址将返回相同的地址。

高级特性

支持带有 PKCE 的 OAuth 授权码和动态客户端注册，以及安全配置的服务端 Canopy secret key。
处理意图重用和幂等性结果；在超时后检查现有充值，而不是盲目重复可能会改变状态的请求。
使用工具返回的准确资产、链、Token、
caip19
、最小值和结算轨道信息，而不是依赖硬编码的网络或假定的小数位数。
区分充值检测与结算，并可以报告单笔转账阶段、手续费、净额和低于最小值的状态。
根据错误代码响应错误：纠正被拒绝的输入，解决身份验证或主机名问题，且不要针对另一个账户重试
not_found
。
遵循 HTTP 429 和
Retry-After
，并避免紧密的自动状态轮询。
保持人工授权和操作处于核心地位：创建意图或签发地址会改变账户状态，而充值是由人类（而非 MCP 工具）进行资金支付。
Openclaw Skills 用户不应将 Canopy 描述为仅限稳定币，或承诺发送和接收的资产完全一致；支持的资产以及可能的跨链桥接或兑换取决于返回的工具数据。

name: canopy-deposits description: Create crypto deposit intents, retrieve funding options and addresses, and track settlement through Canopy's remote MCP server. Use when a user wants to accept or check a crypto deposit through Canopy. Free to integrate.