OurPay Wallet

OurPay 钱包

一个由你拥有、供你和获授权的 AI Agent 使用的加密货币钱包。从 ChatGPT、Claude、编码 Agent 或兼容的应用登录同一个 OurPay 账户，即可使用同一个钱包，并可分别撤销各项连接。

57 个工具 · 6 个原生包 · 18 个客户端配置 · 5 种模型工具格式 · 4 个框架示例

打开钱包 · 连接 Agent · 下载发行版 · 所有工具

功能

领域	已实现的功能
账户和钱包	账户登录、EVM/Solana 地址、受支持的网络和资产发现、余额、所有者恢复以及可撤销的 Agent 连接
转账	原生货币、ERC-20 和标准 SPL 转账、收据跟踪和持久化重试
兑换	受支持的同链兑换以及 EVM/Solana 跨链路由，并可明确设置最低输出、滑点和费用上限
资金划转	发现原生 USDC 并获取 Gas 报价、划转目标链 USDC 或主网 Hyperliquid 抵押品；使用实际到账金额继续多段路由
商户购买	搜索符合条件的 OurPay 商品、打开候选结账页面、查看详情、准备加密货币账单、获取报价/兑换/付款并跟踪规范订单
EVM 应用	模拟顺序合约调用、个人/EIP-712 签名、应用授权、只读 RPC、Ethereum Provider 和 WalletConnect 适配器
共享数据和计划	共享市场数据流、游标/长轮询更新，以及由服务端运行的有界交易计划；参见 TRADING.md
Hyperliquid	现货/默认/HIP-3 市场发现、订单簿/蜡烛图/交易快照、账户和费用数据、逐仓或受支持的全仓保证金、杠杆、GTC/ALO/IOC 和原生永续合约止损/止盈订单、并发的独立订单、取消和成交
所有者控制	标准模式下的操作审批（含电子邮件审核链接）、共享每日限额、由所有者启用的 Risky 模式、暂停和断开连接

可用性取决于启用的网络、具体资产/市场、流动性、提供商/交易场所状态以及所有者权限。通用钱包签名并不等于与所有 dApp 完全集成。持久化计划仅执行有界指令；它们不会托管一个可自行创作或修改策略的大模型。完整的 Polymarket 交易、任意互联网结账以及法币/银行卡/UPI 支付均不在钱包支持范围内。完整功能边界。

使用 OAuth 连接

将此 Streamable HTTP MCP 服务添加到支持通过 OAuth 连接远程 MCP 的主机：

https://mcp.ourpay.dev/wallet/mcp

请使用完整的 /wallet/mcp 路径。按照 OurPay 登录和授权流程操作，并使用拥有你钱包的账户。主机的套餐、版本和管理员设置可能影响连接器是否可用。支持自定义连接器以及从代码库安装，与供应商的公共目录审核是不同的事项。

然后询问：

调用 ourpay_wallet_guide，主题设为 overview，然后读取我的钱包和受支持的网络。不要提交任何付款、签名或交易。

该指南会提供针对具体任务的说明。全新的 0.11.0 工具目录包含 57 个工具：3 个结账工具和 54 个钱包工具。购买工具支持有明确周期性授权的有界 USDC 订阅，并会自动推进结算流程。如果主机缓存了旧架构，请重启主机；如果使用本地包，也请更新可执行文件。普通工具更新无需更换钱包。刷新和故障排除。

在编码 Agent 中安装

本地包需要 Node.js 24 或更高版本，并包含 MCP 运行时。运行服务不需要商户 API 密钥或 npm 安装。首次调用钱包工具时会返回账户授权流程；系统不会要求提供恢复短语。

Claude Code

claude plugin marketplace add Ourpay/ourpay-wallet
claude plugin install ourpay-wallet@ourpay

Codex

添加公共仓库市场，然后在插件浏览器中从 OurPay 安装 ourpay-wallet：

codex plugin marketplace add https://github.com/Ourpay/ourpay-wallet.git

Gemini CLI

gemini extensions install https://github.com/Ourpay/ourpay-wallet

GitHub Copilot CLI

仓库根目录实现了可移植的 Agent Plugins 格式：

copilot plugin install Ourpay/ourpay-wallet

Cursor 和 Claude Desktop

使用 下载页面 中的原生发布包。Cursor 内含本地插件清单；Claude Desktop 使用 .mcpb。如果托管运行时使用的 Node 版本早于 Node 24，请使用生成的配置，并搭配兼容的外部 Node 可执行文件。

OpenCode 和其他宿主

OpenCode 可直接使用托管的 OAuth URL。完整集成压缩包会为 Codex、Claude Code、Claude Desktop、Cursor、VS Code/Copilot、Windsurf、Cline、Roo Code、Continue、Gemini CLI、OpenCode、Kiro、Goose、Zed、Copilot CLI、LM Studio、Kilo 和通用 MCP 客户端生成配置文件。

在完整压缩包解压后：

node configure.mjs --list
node configure.mjs --target opencode --transport remote
node configure.mjs --target all --out ./local-configs

将生成的服务条目合并到现有配置中。不要替换无关的服务。私有本地连接文件必须保留在你的设备上，并在重启后继续保留。SDK 未发布到 npm；请勿使用 npx @ourpay/agent-wallets 作为安装方式。完整集成说明。

先充值，再授权任务

将正确的资产发送到所选网络对应的钱包地址。EVM 网络共用一个 EVM 地址；Solana 使用另一个地址。每条链上的余额彼此独立。

Agent 可通过受支持的充值路线，使用已启用的 Ethereum、Optimism、Polygon、Base、Arbitrum 和 Avalanche 网络上的原生 USDC 获取 Gas，或获取 Hyperliquid 主网抵押品。手续费从获授权的 USDC 输入中扣除。路线、最低金额和流动性仍然重要；这并不意味着可免费获得 Gas，也不代表支持所有链。Solana 可通过受支持的路线获取 Gas，但不能作为无需 SOL 的 USDC Gas 来源。

HyperCore 交易所抵押品、HyperEVM HYPE 和链上 USDC 是不同的余额。充值报价不代表资产已到账，交易所账户价值也不意味着所有抵押品都可提现。充值与结算工作流。

权限与恢复

标准模式要求所有者审核新的付款、交易、合约提交、签名和应用连接。OurPay 会发送审核链接邮件，并将所有者 URL 返回给 Agent。默认的每日 10,000 美元额度由所有 Agent 共用，并于 UTC 时间 00:00 重置；所有者可以调整该额度。预留金额是授权估算值，并非最大损失保证。

启用风险模式后，会跳过受支持操作的逐项审批和共享支出限制。暂停、撤销、受支持操作验证以及宿主自身的控制仍然适用。该模式不授权 Agent 自行制定交易策略，也不允许其超出任务范围支出。

请妥善保存初始恢复短语。完成近期的所有者身份验证后，你可以在钱包设置中再次查看该短语。OurPay 会保留加密备份；所有者持有的短语则是独立备份。Agent 永远不会收到该短语。恢复会保留地址并撤销先前的连接。所有者指南。

Agent 和开发者文档

文档	内容
USER_GUIDE.md	设置、钱包界面、资金、恢复、连接 Hyperliquid 网站及相关控件
INTEGRATIONS.md	宿主配置、OpenCode、OAuth、本地凭据、模型适配器、框架和升级
WORKFLOWS.md	精确金额单位、审批处理、资金充值、购买、交易、重试和完成凭证
PROTOCOLS.md	支持的网络/协议、Hyperliquid 详情、提供商/WalletConnect 行为及限制
TOOLS.md	全部 57 个规范工具、说明和完整输入 JSON Schema
TROUBLESHOOTING.md	缓存的工具、登录、审批、Gas/路由故障、过时数据和状态不确定的订单
TESTING.md	测试命令、跳过的测试与在线测试的区别，以及端到端测试通过的要求
RELEASE_VERIFICATION.md	v0.10.0 部署、在线客户端发现、基准测试和验证限制
DISTRIBUTION.md	公开分发渠道和供应商审核边界
CHANGELOG.md	版本变更和仓库文档更新
Agent skill	面向任务的说明和打包参考资料

模型适配器支持 OpenAI Responses、兼容 Chat Completions 的函数工具、Anthropic Messages、Gemini，以及支持工具的 Ollama 模型。框架示例涵盖 OpenAI Agents SDK、LangChain/LangGraph、PydanticAI 和 Google ADK。应用负责提供模型凭据、工具筛选器和执行循环；钱包不会为其选择模型或运行策略。

源码与验证

使用 Node 24+ 构建分发用 SDK 源码：

cd source
npm ci
npm run build

应用仓库负责完整的测试和生成流程；此公开仓库包含 SDK 源码、插件清单、打包后的运行时和文档。本地打包/Schema/fixture 测试、在线只读检查和有资金的执行属于不同类型的验证依据。有关在线部署、在 ChatGPT 中观察到的全部 57 个工具、快照基准测试，以及仍未验证的有资金验收测试，请参阅 v0.10.0 发布验证。早期版本的验证依据仍见 TESTING.md。

main 分支上的文档可能比带标签的软件包更新。标签、归档文件和校验和保持不变；更改此 README 不会升级已安装的可执行文件。为确保 Git 安装可复现，请固定到经过审查的标签/提交；更新运行时时，请使用对应的发行归档文件。

本项目采用 Apache-2.0 许可。打包依赖详见 THIRD_PARTY_NOTICES.txt。本仓库不应包含任何恢复短语、连接凭据或后端托管密钥。